telegram-tui/INSTALL.md

Установка tele-tui

Требования

• Rust: версия 1.70 или выше (установить)
• TDLib: скачивается автоматически через tdlib-rs

Шаг 1: Клонирование репозитория

git clone https://github.com/your-username/tele-tui.git
cd tele-tui

Шаг 2: Получение API credentials

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

Шаг 3: Настройка credentials

Вариант A: XDG config directory (рекомендуется)

Создайте файл ~/.config/tele-tui/credentials:

mkdir -p ~/.config/tele-tui
cat > ~/.config/tele-tui/credentials << EOF
API_ID=your_api_id_here
API_HASH=your_api_hash_here
EOF

Вариант B: .env файл

Создайте файл .env в корне проекта:

cp credentials.example .env
# Отредактируйте .env и вставьте ваши credentials

Шаг 4: Сборка

cargo build --release

Шаг 5: Запуск

cargo run --release

Или запустите скомпилированный бинарник:

./target/release/tele-tui

Первый запуск

При первом запуске вам нужно будет:

1. Ввести номер телефона (с кодом страны, например: +79991234567)
2. Ввести код подтверждения из Telegram
3. Если включена 2FA — ввести пароль

Сессия сохраняется в ./tdlib_data/, при следующем запуске авторизация не потребуется.

Настройка (опционально)

Конфигурационный файл создаётся автоматически при первом запуске в ~/.config/tele-tui/config.toml.

Вы можете отредактировать его для настройки:

• Часового пояса
• Цветовой схемы

Пример конфигурации см. в файле config.toml.example.

Устранение неполадок

"Telegram API credentials not found!"

Убедитесь, что вы создали файл credentials (см. Шаг 3).

"error: linking with cc failed"

Убедитесь, что у вас установлен C компилятор:

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

TDLib download failed

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

Обновление

git pull
cargo build --release

Ваши credentials и конфигурация сохранятся.

Удаление

Чтобы полностью удалить приложение и все данные:

# Удалить проект
rm -rf tele-tui/

# Удалить конфигурацию и credentials
rm -rf ~/.config/tele-tui/

# Удалить сессию Telegram (опционально, потребуется новая авторизация)
# rm -rf ./tdlib_data/