Skip to content

glebkudr/telegram_json_to_md

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Telegram JSON to Markdown Parser

Десктопное приложение для конвертации экспорта Telegram в формат Markdown с поддержкой всех типов сообщений и медиафайлов.

📋 Описание

Это приложение предназначено для обработки JSON файлов экспорта Telegram и их конвертации в читаемый Markdown формат. Поддерживает обработку больших файлов (до 50MB) с фоновой обработкой и отслеживанием прогресса в реальном времени.

✨ Основные возможности

  • Полная поддержка Telegram форматов: Все типы сообщений (текст, медиа, опросы, контакты, локации)
  • Сохранение форматирования: Жирный текст, курсив, ссылки, упоминания
  • Фоновая обработка: Параллельная обработка множества файлов
  • Отслеживание прогресса: Real-time прогресс-бар и статистика
  • Обработка больших файлов: Эффективная работа с файлами до 50MB
  • Современный UI: Интуитивный интерфейс с настройками обработки
  • Эмодзи индикаторы: Для разных типов контента (📝 текст, 📷 фото, 🎵 аудио, и т.д.)

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

  1. Экспорт данных из Telegram:

    • Откройте Telegram Desktop
    • Перейдите в Settings → Advanced → Export Telegram data
    • Выберите чаты для экспорта
    • Установите формат: JSON
    • Сохраните экспорт в папку
  2. Обработка с помощью приложения:

    1. Запустите telegram_parse.exe
    2. Нажмите "Select Directory" и выберите папку с JSON файлами
    3. Настройте опции:
       - Include Subdirectories (обрабатывать подпапки)
       - Max Concurrent Files (количество одновременно обрабатываемых файлов)
    4. Нажмите "Start Processing"
    5. Дождитесь завершения обработки
    
  3. Результат:

    • Markdown файлы создаются в той же папке что и исходные JSON
    • Имена файлов: [original_name]_parsed.md
    • Медиафайлы остаются в исходных папках

📁 Структура вывода

Каждый обработанный чат будет содержать:

# Chat Name
*Exported on: 2024-01-15*

## Messages

**John Doe** - *2024-01-15 14:30*
📝 Hello world!

**Jane Smith** - *2024-01-15 14:31*
📷 Photo: photo_123.jpg
Check out this amazing sunset!

**John Doe** - *2024-01-15 14:32*
👍 Liked the message above

🛠️ Технические детали

  • Backend: Go 1.24.2+ с Wails v2
  • Frontend: TypeScript + Modern CSS
  • JSON Parsing: Нативный Go JSON парсер
  • Concurrency: Горутины с семафорами для ограничения нагрузки
  • Memory Management: Потоковая обработка для больших файлов

📦 Сборка и разработка

Требования

  • Go 1.24.2+
  • Node.js 16+
  • Wails v2

Разработка

# Клонировать репозиторий
git clone [repository-url]
cd telegram_parse

# Установить зависимости
go mod tidy
cd frontend && npm install

# Запустить в режиме разработки
wails dev

Сборка

# Сборка для продакшена
wails build

# Исполняемый файл будет в: build/bin/telegram_parse.exe

🔧 Поддерживаемые типы сообщений

Тип Эмодзи Описание
Текст 📝 Обычные текстовые сообщения
Фото 📷 Изображения с подписями
Видео 🎬 Видеофайлы
Аудио 🎵 Аудиосообщения и музыка
Голосовые 🎤 Голосовые сообщения
Документы 📄 Файлы и документы
Стикеры 😀 Стикеры с эмодзи
Опросы 📊 Опросы с вариантами
Контакты 👤 Контактная информация
Локации 📍 Геолокация
Пересланные ↩️ Пересланные сообщения

🐛 Известные ограничения

  • Медиафайлы не конвертируются, только создаются ссылки
  • Некоторые специальные символы могут требовать ручной корректировки
  • Очень большие чаты (>100k сообщений) могут требовать больше времени

📄 Лицензия

LICENSE

🤝 Поддержка

Если вы столкнулись с проблемами или у вас есть предложения по улучшению, создайте issue в репозитории.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published