telegram-tui/FAQ.md

FAQ — Часто задаваемые вопросы

Установка и запуск

Где получить API credentials?

1. Перейдите на https://my.telegram.org/apps
2. Войдите с вашим номером телефона
3. Создайте новое приложение
4. Скопируйте api_id и api_hash

Где хранить credentials?

Рекомендуется (приоритет 1):

~/.config/tele-tui/credentials

Альтернатива (приоритет 2):

.env  # в корне проекта

Ошибка "Telegram API credentials not found!"

Убедитесь, что вы создали файл credentials (см. выше) с правильным форматом:

API_ID=12345678
API_HASH=abcdef1234567890abcdef1234567890

Где хранится сессия Telegram?

В папке ./tdlib_data/ в директории запуска приложения. Эта папка содержит:

• Токены авторизации
• Кеш сообщений
• Другие данные TDLib

Важно: Не удаляйте эту папку, иначе придётся заново авторизоваться.

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

Как переключаться между папками?

Нажмите клавиши 1-9 для переключения между первыми 9 папками Telegram.

Как искать сообщения в чате?

1. Откройте чат
2. Нажмите Ctrl+F
3. Введите поисковый запрос
4. Используйте n / N для навигации по результатам

Как скопировать текст сообщения?

1. При пустом поле ввода нажмите ↑ для выбора сообщения
2. Нажмите y (или н на русской раскладке)
3. Текст скопирован в системный буфер обмена

Как ответить на сообщение?

1. Выберите сообщение (↑ при пустом инпуте)
2. Нажмите r (или к на русской раскладке)
3. Введите ответ
4. Нажмите Enter

Как удалить сообщение?

1. Выберите сообщение
2. Нажмите d / в / Delete
3. Подтвердите удаление: y / Enter

Как добавить реакцию?

1. Выберите сообщение
2. Нажмите e (или у на русской раскладке)
3. Выберите emoji стрелками
4. Нажмите Enter

Почему не работают хоткеи на русской раскладке?

Убедитесь, что вы используете русскую раскладку, а не транслит. Поддерживаемые комбинации:

• р о л д → h j k l (навигация)
• к → r (reply)
• а → f (forward)
• в → d (delete)
• н → y (copy)
• у → e (react)

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

Где находится конфигурационный файл?

~/.config/tele-tui/config.toml

Создаётся автоматически при первом запуске.

Как изменить часовой пояс?

Отредактируйте ~/.config/tele-tui/config.toml:

[general]
timezone = "+05:00"  # Ваш часовой пояс

Как изменить цветовую схему?

Отредактируйте секцию [colors] в конфиге:

[colors]
incoming_message = "cyan"
outgoing_message = "lightgreen"
selected_message = "lightyellow"

Поддерживаемые цвета: black, red, green, yellow, blue, magenta, cyan, gray, white, darkgray, lightred, lightgreen, lightyellow, lightblue, lightmagenta, lightcyan.

Нужно ли перезапускать приложение после изменения конфига?

Да, изменения в config.toml применяются только при запуске приложения.

Проблемы

Приложение зависает при запуске

Возможные причины:

1. Нет интернета: проверьте подключение
2. TDLib не может подключиться: проверьте firewall/прокси
3. Неверные credentials: проверьте API_ID и API_HASH

Сообщения не загружаются

1. Проверьте статус сети в футере (внизу экрана)
2. Попробуйте обновить: Ctrl+R
3. Перезапустите приложение

"Deleted Account" в списке чатов

Это пользователи, которые удалили свой аккаунт Telegram. Они автоматически фильтруются и не отображаются в списке.

Не отображаются медиафайлы

Медиафайлы (фото, видео, голосовые, стикеры) отображаются как заглушки: [Фото], [Видео], [Голосовое], [Стикер]. Полная поддержка медиа может быть добавлена в будущем.

Ошибка компиляции при сборке

TDLib download failed:

• Проверьте интернет-соединение
• Убедитесь, что у вас достаточно места на диске

Linking with cc failed:

• macOS: xcode-select --install
• Linux: sudo apt-get install build-essential
• Windows: установите Visual Studio Build Tools

Как сбросить сессию?

Удалите папку tdlib_data/:

rm -rf tdlib_data/

При следующем запуске потребуется заново авторизоваться.

Производительность

Приложение тормозит

Проверьте:

1. Количество открытых чатов (лимит 200)
2. Количество сообщений в открытом чате (лимит 500)
3. Размер терминала (минимум 80x20)

Приложение автоматически очищает старые данные при достижении лимитов.

Высокое использование памяти

Это нормально при большом количестве чатов и сообщений. Приложение использует LRU кеши с ограничениями:

• 500 пользователей в кеше
• 500 сообщений на чат
• 200 чатов

Разработка

Как внести вклад в проект?

См. CONTRIBUTING.md

Где найти план развития?

См. ROADMAP.md

Как сообщить о баге?

Создайте issue на GitHub с описанием:

• Шаги для воспроизведения
• Ожидаемое и фактическое поведение
• Версия ОС и Rust
• Логи (если есть)

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

Безопасно ли хранить credentials в файле?

Да, если вы:

1. Используете ~/.config/tele-tui/credentials
2. Установили права доступа: chmod 600 ~/.config/tele-tui/credentials
3. Не коммитите этот файл в git (уже в .gitignore)

Что делать при компрометации credentials?

1. Удалите приложение на https://my.telegram.org/apps
2. Создайте новое приложение с новыми credentials
3. Обновите файл credentials
4. Удалите папку tdlib_data/ и авторизуйтесь заново

Включена ли двухфакторная аутентификация?

Если вы включили 2FA в Telegram, приложение запросит пароль при первой авторизации.

Ещё вопросы?

Создайте issue на GitHub или свяжитесь с maintainers.