tele-tui

Консольный Telegram-клиент на Rust с Vim-style навигацией, Normal/Insert режимами, TDLib и поддержкой русской раскладки.

Возможности

• Авторизация через TDLib, список чатов, история и realtime updates.
• Отправка, редактирование, удаление, reply, forward, copy и реакции.
• Поиск по чатам и внутри открытого чата.
• Telegram-папки, pinned/muted/mentions/unread indicators.
• Markdown entities, inline фото, fullscreen image modal и фото-альбомы.
• Голосовые сообщения через ffplay.
• Desktop notifications, clipboard и открытие URL через feature flags.
• Multi-account profiles, account switcher и per-account lock files.

Установка

Требования:

• Rust stable, рекомендовано 1.85+.
• TDLib скачивается автоматически через tdlib-rs feature download-tdlib.
• Для голосовых сообщений нужен ffplay из ffmpeg.

cargo build -p tele-tui --release

Credentials

Получите Telegram API credentials на https://my.telegram.org/apps и сохраните их в:

~/.config/tele-tui/credentials

Формат:

API_ID=your_api_id
API_HASH=your_api_hash

Для локальной разработки можно использовать .env в корне проекта с теми же ключами.

Запуск

cargo run --release

Для выбора аккаунта:

cargo run --release -- --account work

Cargo.toml в корне - workspace manifest. По умолчанию cargo run и cargo test работают с crates/tele-tui; переиспользуемая TDLib-логика лежит в crates/tele-core.

Runtime-конфиг создаётся в ~/.config/tele-tui/config.toml; пример лежит в config.toml.example.

Документация

• AGENT.md - краткие правила для агента.
• DEVELOPMENT.md - локальные правила разработки и проверок.
• CONTEXT.md - текущий статус, риски и следующие шаги.
• docs/HOTKEYS.md - горячие клавиши.
• docs/PROJECT_STRUCTURE.md - карта подсистем.
• docs/TDLIB_INTEGRATION.md - проектные заметки по TDLib.
• docs/IOS_CORE_REUSE.md - граница tele-core для будущего iOS-клиента.

Лицензия

MIT