051c4a0265
Some checks are pending
CI / Check (pull_request) Waiting to run
CI / Format (pull_request) Waiting to run
CI / Clippy (pull_request) Waiting to run
CI / Build (macos-latest) (pull_request) Waiting to run
CI / Build (ubuntu-latest) (pull_request) Waiting to run
CI / Build (windows-latest) (pull_request) Waiting to run
123 lines
3.4 KiB
Markdown
123 lines
3.4 KiB
Markdown
# Установка 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/
|
||
```
|