TELEGRAM MIGRATION - WINDOWS CLICK-TO-RUN LAUNCHER
==================================================

FILES
-----
Run Telegram Migration.bat   Double-click this file to start.
.env.example                 Template copied to .env on first launch.

FIRST RUN
---------
1. Keep these files together in one folder.
2. Double-click "Run Telegram Migration.bat".
3. On first launch, Notepad opens .env.
4. Fill in your own values:
   - TELEGRAM_API_ID and TELEGRAM_API_HASH from https://my.telegram.org
   - TELEGRAM_BOT_TOKEN from https://t.me/BotFather
   - TELEGRAM_CHANNEL_PEER for the destination channel
5. Save .env, close Notepad, and double-click the BAT file again.

RUNNING A MIGRATION
-------------------
1. The launcher creates a local .venv and installs telegram-migration from PyPI
   on first use. Python 3.10 or newer is required.
2. Select the Telegram Desktop export folder. Select the folder that contains
   messages.html / messages2.html AND the associated media folders.
3. The launcher runs a dry-run preview first. No messages are sent in this step.
4. Review the destination and the preview. Type YES only when you are ready
   to proceed. The program then asks you to confirm the destination channel.
5. Progress files are kept inside the export folder. Keep them so a later run
   can resume an interrupted migration.

MEDIA
-----
Keep the full Telegram Desktop export together. Do not separate the HTML pages
from folders such as photos, video_files, files, voice_messages,
round_video_messages and stickers. The program handles supported exported media
as part of the migration; this BAT file is only a convenient launcher.

IMPORTANT
---------
- The launcher uses a bot. It does not log into your personal Telegram account.
- The bot must be an administrator in the destination channel with permission
  to post.
- Never send anyone your .env file, bot token, API hash, session files, or
  private Telegram export.
- A dry run is not a guarantee that every file can be uploaded. The program
  will report failures and oversized media that need manual handling.
- The program is installed from the public PyPI package. This launcher does
  not install unreleased GitHub changes.

To update the installed package manually, open Command Prompt in this folder
and run:
  .venv\Scripts\python.exe -m pip install --upgrade telegram-migration
