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

## Требования

- **Rust**: версия 1.70 или выше ([установить](https://rustup.rs/))
- **TDLib**: скачивается автоматически через tdlib-rs

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

```bash
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`:

```bash
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` в корне проекта:

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

## Шаг 4: Сборка

```bash
cargo build --release
```

## Шаг 5: Запуск

```bash
cargo run --release
```

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

```bash
./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 скачивается автоматически при первой сборке.

## Обновление

```bash
git pull
cargo build --release
```

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

## Удаление

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

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

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

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