VK Dialog Exporter

Профессиональный инструмент для экспорта диалогов ВКонтакте

Установка • Использование • Roadmap • Вклад

---

Возможности

• 📄 Экспорт полной истории диалога в текстовые файлы
• ✂️ Автоматическое разбиение на части по лимиту символов (для Telegram)
• 📎 Сохранение вложений: фото, документы, стикеры, анимации
• ⚡ Кэширование вложений для ускорения повторных запусков
• 📅 Фильтрация по диапазону дат
• 📝 Подробное логирование процесса
• 🔐 Безопасное хранение токена в .env

Roadmap

🎯 v1.0 — Базовый функционал

• Экспорт сообщений в TXT
• Разбиение по лимиту символов
• Сохранение вложений (photo, doc, sticker, animation)
• Кэширование вложений
• Фильтрация по датам
• CLI интерфейс
• Конфигурация через YAML
• Переменные окружения (.env)

🔧 v1.1 — Качество кода

• Unit тесты (pytest)
• Интеграционные тесты
• Code coverage > 80%
• CI/CD pipeline (GitHub Actions)
• Линтеры (ruff, mypy)
• pre-commit hooks

🐳 v1.2 — DevOps

• Dockerfile
• docker-compose.yml
• Docker Hub публикация
• Makefile для команд

📊 v1.3 — Аналитика

• Генерация HTML-отчётов
• График активности по дням/месяцам
• Облако слов (wordcloud)
• Топ слов и эмодзи
• Статистика по вложениям
• "Тепловая карта" переписки

🌐 v2.0 — Web-интерфейс

• FastAPI backend
• Next.js frontend
• Авторизация через VK OAuth
• Выбор диалога из списка
• Прогресс в реальном времени (WebSocket)
• Скачивание архива

📦 v2.1 — Расширения экспорта

• HTML-экспорт с аватарами
• JSON-экспорт
• PDF-экспорт
• ZIP-архив с медиа
• Экспорт видео/аудио

🤖 v2.2 — Интеграции

• Telegram Bot
• Планировщик (cron)
• Уведомления о завершении
• PyPI пакет
• API для сторонних приложений

🌍 v3.0 — Enterprise

• Мультиязычность (EN/RU)
• Пакетная обработка диалогов
• Шифрование экспорта
• Импорт в другие мессенджеры
• Cloud-версия

Структура проекта

vk_exporter/
├── main.py                 # Точка входа
├── config.py               # Загрузка конфигурации
├── vk_client.py            # Клиент VK API
├── config.yaml             # Файл конфигурации
├── config.yaml.example     # Пример конфигурации
├── .env                    # Переменные окружения (токен)
├── .env.example            # Пример .env
├── .gitignore
├── requirements.txt        # Зависимости
├── README.md               # Документация
├── utils/
│   ├── __init__.py
│   ├── logger.py           # Логирование
│   └── cache.py            # Кэширование вложений
├── exporters/
│   ├── __init__.py
│   ├── txt_exporter.py     # Экспорт в TXT
│   └── attachments.py      # Сохранение вложений
└── export/                 # Результаты экспорта
    ├── dialog_001.txt
    ├── dialog_002.txt
    ├── attachments/
    │   ├── 2024-01-01-120000.jpg
    │   └── ...
    ├── .cache.json         # Кэш вложений
    └── export.log          # Лог экспорта

Установка

Требования

• Python 3.10+
• Зависимости из requirements.txt

Шаги установки

1. Клонируйте репозиторий

git clone <repository-url>
cd vk_exporter

2. Создайте виртуальное окружение

python -m venv venv

# Windows
venv\Scripts\activate

# Linux/macOS
source venv/bin/activate

3. Установите зависимости

pip install -r requirements.txt

4. Настройте переменные окружения

cp .env.example .env

Отредактируйте .env:

VK_TOKEN=your_vk_access_token_here
VK_PEER_ID=123456789

5. (Опционально) Настройте config.yaml

cp config.yaml.example config.yaml

Получение токена VK API

1. Перейдите на https://vk.com/dev
2. Создайте Standalone-приложение
3. Получите access token с правами messages через Implicit Flow:

https://oauth.vk.com/authorize?client_id=YOUR_APP_ID&display=page&redirect_uri=https://oauth.vk.com/blank.html&scope=messages&response_type=token&v=5.131

4. После авторизации скопируйте токен из URL в .env

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

Базовый запуск

python main.py

Фильтрация по датам

python main.py --from-date 2024-01-01 --to-date 2024-12-31

Экспорт без вложений

python main.py --no-attachments

Без использования кэша

python main.py --no-cache

Указание конфигурационного файла

python main.py --config /path/to/config.yaml

Справка

python main.py --help

Конфигурация

Переменные окружения (.env)

Переменная	Описание	Обязательно
VK_TOKEN	Access token VK API	✅
VK_PEER_ID	ID пользователя или диалога	✅

config.yaml

export:
  out_dir: "export"              # Директория для экспорта
  attachments_dir: "attachments" # Поддиректория для вложений
  txt_prefix: "dialog"           # Префикс имён файлов

limits:
  telegram_txt_chars: 3800       # Лимит символов на файл (Telegram)

format:
  datetime: "%Y-%m-%d %H:%M:%S"  # Формат даты/времени
  filename_mask: "%Y-%m-%d-%H%M%S" # Маска имён файлов вложений

options:
  save_attachments: true         # Сохранять вложения
  generate_txt: true             # Генерировать TXT

Кэширование вложений

Проект использует JSON-файл .cache.json для отслеживания уже скачанных вложений:

• Хэширование URL для идентификации дубликатов
• Автоматический пропуск уже загруженных файлов
• Ускорение повторных запусков экспорта

Поддерживаемые типы вложений

Тип	Описание
photo	Фотографии (сохраняется максимальный размер)
doc	Документы (с оригинальным расширением)
sticker	Стикеры (PNG)
animation	GIF-анимации (MP4)
video	Видео (требует отдельной обработки*)
audio	Аудио (требует отдельной обработки*)

*Видео и аудио пропускаются, так как требуют дополнительных API-вызовов.

Безопасность

• Токен VK API хранится в файле .env, который добавлен в .gitignore
• Никогда не коммитьте файл .env в репозиторий
• Используйте .env.example как шаблон для новых пользователей

Вклад в проект

Приветствуются любые улучшения!

1. Форкните репозиторий
2. Создайте ветку для фичи (git checkout -b feature/amazing-feature)
3. Зафиксируйте изменения (git commit -m 'Add amazing feature')
4. Отправьте ветку (git push origin feature/amazing-feature)
5. Откройте Pull Request

Лицензия

MIT License

---

⬆ Наверх