fixes
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
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
This commit is contained in:
122
INSTALL.md
Normal file
122
INSTALL.md
Normal file
@@ -0,0 +1,122 @@
|
||||
# Установка 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/
|
||||
```
|
||||
Reference in New Issue
Block a user