Metadata-Version: 2.4
Name: telegram-potato-cli
Version: 0.1.1
Summary: Lightweight Telegram terminal client for one chat on low-end Linux laptops.
Author: openclaw
License-Expression: MIT
Keywords: telegram,telethon,terminal,cli,curses
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: telethon>=1.34
Requires-Dist: qrcode>=7.4
Requires-Dist: Pillow>=9.0
Dynamic: license-file

# telegram-potato-cli

Легкий Telegram-клиент в терминале для одного чата: `@RooniChat`.

## Установка

```bash
pip install telegram-potato-cli
telegram
```

На Debian 12, если `pip` ругается на externally-managed-environment:

```bash
python3 -m pip install --user --break-system-packages telegram-potato-cli
~/.local/bin/telegram
```

## Возможности

- вход через QR или телефон + код;
- поддержка 2FA-пароля;
- сохранение сессии, повторный вход не нужен;
- realtime-новые и отредактированные сообщения;
- статус `печатает`;
- настоящие аватарки пользователей в виде кэшированных цветных терминальных миниатюр;
- отправка текста;
- отправка фото/файлов/медиа по пути, включая путь, вставленный drag-and-drop в терминал;
- скачивание и открытие выбранного медиа через `xdg-open`;
- редактирование своих сообщений;
- управление стрелками, PgUp/PgDn, Home/End.

## Клавиши

- `Enter` - отправить сообщение;
- `Up/Down` - выбрать сообщение;
- `PgUp/PgDn` - листать;
- `Ctrl+S` - отправить файл по пути из поля ввода;
- `Ctrl+D` - скачать медиа выбранного сообщения;
- `Ctrl+O` - открыть/посмотреть выбранное медиа;
- `Ctrl+E` - подготовить редактирование своего сообщения;
- `F1` - скрыть/показать помощь;
- `Esc` - выйти.

## Команды

```text
:file /path/to/file
:photo /path/to/photo.jpg
:dl
:open
:edit новый текст
:refresh
:quit
```

Сессия, API-настройки и кэш аватарок лежат в `~/.local/share/telegram-potato-cli/`.
