Install Letterbot

Step 1: Download

Download Letterbot.zip from GitHub Releases and extract to any folder (e.g. C:\letterbot).

Step 2: Create a Telegram bot

• Open Telegram → find @BotFather → send /newbot
• Copy the bot token (looks like 1234567890:AAF-xxxx)
• Send /start to your new bot
• Open https://api.telegram.org/bot<TOKEN>/getUpdates in browser
• Find the numeric id value — this is your chat_id

Step 3: Configure

Open accounts.ini and fill in:

[my_inbox]
login    = you@example.com
password = YOUR_APP_PASSWORD
host     = imap.gmail.com
port     = 993
use_ssl  = true
telegram_chat_id = 123456789

[telegram]
bot_token = 1234567890:AAF-xxxx
chat_id   = 123456789

Step 4: Run

Double-click run.bat. Wait for [OK] Ready to work. Send yourself a test email — notification arrives in Telegram within 2 minutes.

Step 5: Web dashboard

Open http://127.0.0.1:8787 in your browser for the local observability cockpit.

IMAP settings for common providers

Provider	Host	Port	Notes
Gmail	imap.gmail.com	993	App password + 2FA required
Yandex	imap.yandex.ru	993	App password in security settings
Mail.ru	imap.mail.ru	993	Works for @bk.ru, @list.ru
Outlook	outlook.office365.com	993	App password if 2FA enabled

SmartScreen warning

Windows may show a SmartScreen warning for unsigned executables. Click "More info" → "Run anyway". The source code is fully public and auditable.