Metadata-Version: 2.1
Name: vkms
Version: 0.1.0.dev1
Summary: Утилита для сохранения переписок ВКонтакте
Author-email: Yaroslav Kikel <yaroslav.kikel.06@inbox.ru>
License: GPL-3.0-only
Keywords: api,parser,vk,messages,saver
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Description-Content-Type: text/markdown
License-File: LICENSE

# vk-messages-saver

![](https://img.shields.io/maintenance/yes/2022?style=flat-square)
![](https://img.shields.io/github/v/release/YariKartoshe4ka/vk-messages-saver?style=flat-square)
![](https://img.shields.io/static/v1?label=API&message=5.131&color=a938e4&labelColor=000000&logo=vk&style=flat-square)
![](https://img.shields.io/pypi/pyversions/vkms?style=flat-square)
![](https://img.shields.io/codacy/grade/7d64b70fa82f4aac9e61ae88d6d9a2b2?style=flat-square)

Утилита для сохранения переписок ВКонтакте


### Установка

Загружаем и устанавливаем последнюю версию VKMS из [PyPI](https://pypi.org/project/vkms/)

```bash
pip install vkms
```


### Использование

1. Получаем токен доступа с правами на сообщения от официального приложения. Можно воспользоваться [этим сайтом](https://vkhost.github.io/). После авторизации копируем из адресной строки параметр *access_token* и вставляем его в терминал

    ```bash
    export ACCESS_TOKEN='...'
    ```

2. Запускаем VKMS и скачиваем полную информацию о переписках

    ```bash
    vkms dump
    ```

    Теперь можно спарсить полученные данные в удобный для чтения формат

    ```bash
    vkms parse
    ```


### Функции

В данный момент VKMS может:

- Сохранять переписки в программном формате (JSON), доступна многопоточная загрузка (`vkms dump`)
- Сохранять переписки в удобном для чтения формате (`vkms parse`)
- Загружать вложения, доступна многопоточная загрузка (`vkms atch`)
    - Фото
    - Документы
    - Стикеры
    - Подарки
    - Голосовые сообщения
    - Граффити

[Подробное описание](docs/DOCS.md)
