@emaxe/tuigram 1.4.0 → 1.5.1

package/.env.example

@@ -35,6 +35,21 @@ SHOW_IMAGES=true
 IMAGE_MAX_WIDTH=36
 IMAGE_MAX_HEIGHT=14
 
+# ── Video Playback Preferences ────────────────────────────────────────────────
+# Включение воспроизведения видео в терминале в псевдографике (true/false)
+# Для работы требуется ffmpeg (автоустановка: tuigram install-video)
+ENABLE_VIDEO=false
+
+# Частота кадров при воспроизведении видео (FPS, 1..30, по умолчанию 15)
+VIDEO_FPS=15
+
+# Воспроизведение звуковой дорожки видеофайла (true/false)
+VIDEO_AUDIO=true
+
+# Путь к ffmpeg/ffplay (если они не в PATH и не в папке данных tuigram)
+# FFMPEG_PATH=/usr/local/bin/ffmpeg
+# FFPLAY_PATH=/usr/local/bin/ffplay
+
 # ── Proxy Settings ────────────────────────────────────────────────────────────
 # Поддерживаются HTTP и SOCKS5 (как с авторизацией, так и без).
 # Формат единого URL:

package/CHANGELOG.md

@@ -13,6 +13,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 - English localization of the TUI and CLI interface strings.
 
+## [1.5.1] — 2026-09-03
+
+### Fixed
+
+- Message sender attribution across TUI and CLI: channel posts now display the channel title (along with author signature if present) instead of generic "Собеседник" or marking owner posts as "Вы ✓✓".
+- Sender names in direct 1-on-1 chats and groups are now properly resolved and cached from Telegram entities instead of falling back to "Собеседник".
+- Live typing indicator in the active chat now displays the typing user's display name instead of generic "Собеседник".
+- Contextual reply preview bar in the input box displays the channel name when replying to channel posts.
+- Resolution of Telegram Peer objects and channel IDs in `entityCache` and `parsePeer`.
+
+## [1.5.0] — 2026-09-02
+
+### Added
+
+- Video playback support in ANSI pseudographics (Unicode Half-Block) with synchronized audio track.
+- New CLI command `tuigram install-video` to check and automatically install static `ffmpeg` binaries and enable video in `.env`.
+- New configuration settings in `.env`: `ENABLE_VIDEO`, `VIDEO_FPS`, `VIDEO_AUDIO`, `FFMPEG_PATH`, `FFPLAY_PATH`.
+- Video player modal with playback controls (`[Space]` for pause/resume, `[r]` to replay, `[Esc]` / `[q]` to exit).
+- Interactive video playback via message action menu and by clicking on video message preview in chat view.
+
+### Changed
+
+- Enhanced unread message badge in dialog list: counters above 99 are shown as `[99+]`, and the right block (time and unread badge) is always right-aligned, truncating long chat titles with an ellipsis when space is constrained.
+
+### Fixed
+
+- Opening a chat with unread messages now scrolls and positions directly at the first unread message with an unread separator divider instead of always jumping to the last message.
+- Unread message badge and counter in the dialog list now dynamically decrease in real-time as messages are scrolled and read in the active chat.
+
 ## [1.4.0] — 2026-09-01
 
 ### Added
@@ -176,7 +205,9 @@ First public release.
 - A WCAG contrast test (3:1 threshold) applied to every theme **after** conversion
   to xterm-256 — the colors are checked exactly as the user sees them.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.4.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.5.1...HEAD
+[1.5.1]: https://github.com/emaxe/tuigram/compare/v1.5.0...v1.5.1
+[1.5.0]: https://github.com/emaxe/tuigram/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/emaxe/tuigram/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/emaxe/tuigram/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/emaxe/tuigram/compare/v1.1.0...v1.2.0

package/CHANGELOG.ru.md

@@ -13,6 +13,35 @@
 
 - Английская локализация строк интерфейса TUI и CLI.
 
+## [1.5.1] — 2026-09-03
+
+### Исправлено
+
+- Отображение авторов сообщений в TUI и CLI: посты в каналах теперь выводятся от имени канала (с подписью автора, если она включена в канале) вместо подстановки «Собеседник» или ошибочной отметки «Вы ✓✓» для постов владельца канала.
+- Определение и кэширование имён отправителей в личных диалогах и группах: при входящих сообщениях и загрузке истории имена резолвятся из сущностей Telegram, предотвращая фоллбэк на «Собеседник».
+- Индикатор набора текста в активном чате теперь отображает имя конкретного пользователя (например, «Sam печатает...») вместо обобщённого «Собеседник».
+- В строке контекста ответа (Reply) в поле ввода для сообщений каналов отображается название канала вместо «Собеседник».
+- Улучшена работа кэша сущностей (`entityCache`) с поддержкой маркированных и числовых ID, юзернеймов с префиксом `@` и без него, а также объектов Peer в `parsePeer`.
+
+## [1.5.0] — 2026-09-02
+
+### Добавлено
+
+- Поддержка воспроизведения видео в терминале в псевдографике (Unicode Half-Block) с синхронной звуковой дорожкой.
+- Консольная команда `tuigram install-video` для проверки, автоматической загрузки статической сборки `ffmpeg` и активации настройки в `.env`.
+- Новые параметры конфигурации в `.env`: `ENABLE_VIDEO`, `VIDEO_FPS`, `VIDEO_AUDIO`, `FFMPEG_PATH`, `FFPLAY_PATH`.
+- Модальный видеоплеер с управлением воспроизведением (`[Пробел]` — пауза/воспроизведение, `[r]` — перезапуск с начала, `[Esc]` / `[q]` — закрыть).
+- Запуск воспроизведения через меню действий над сообщением («▶️ Воспроизвести видео») и по прямому клику мыши по превью видео в ленте.
+
+### Изменено
+
+- Доработан показ количества непрочитанных сообщений в списке диалогов: если непрочитанных более 99, отображается `[99+]`, а блок времени и непрочитанных всегда прижат к правому краю с сокращением названия диалога с троеточием при нехватке места.
+
+### Исправлено
+
+- При переходе в диалог с непрочитанными сообщениями лента теперь позиционируется на первом непрочитанном сообщении с визуальным разделителем «Непрочитанные сообщения», как в официальном клиенте Telegram (ранее всегда открывалось последнее сообщение).
+- Бейдж и счётчик непрочитанных сообщений в списке диалогов теперь динамически уменьшаются в реальном времени по мере пролистывания и прочтения сообщений в активном чате.
+
 ## [1.4.0] — 2026-09-01
 
 ### Добавлено
@@ -182,7 +211,9 @@
 - Тест контраста по WCAG (порог 3:1) для каждой темы — **после** конверсии в xterm-256,
   то есть ровно в том виде, в каком цвет увидит пользователь.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.4.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.5.1...HEAD
+[1.5.1]: https://github.com/emaxe/tuigram/compare/v1.5.0...v1.5.1
+[1.5.0]: https://github.com/emaxe/tuigram/compare/v1.4.0...v1.5.0
 [1.4.0]: https://github.com/emaxe/tuigram/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/emaxe/tuigram/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/emaxe/tuigram/compare/v1.1.0...v1.2.0

package/README.md

@@ -57,6 +57,7 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
 - [Sending files and images](#-sending-files-and-images)
 - [Themes](#-themes)
 - [Inline image previews](#️-inline-image-previews)
+- [Video playback in pseudographics](#-video-playback-in-pseudographics)
 - [Proxy configuration](#-proxy-configuration)
 - [Command line usage (CLI)](#️-command-line-usage-cli)
 - [Project structure](#-project-structure)
@@ -72,17 +73,18 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
 - **A complete interactive TUI**:
   - Two-pane adaptive layout (dialog list on the left, history and input box on the right);
   - Keyboard and mouse control (left click selects a message, right click opens the action
-    menu, clicking an image opens it full screen, wheel scrolling);
+    menu, clicking an image opens it full screen, clicking a video plays it, wheel scrolling);
   - Chat categories: All, Direct messages, Groups, Channels, Bots, Unread;
   - Instant search and filtering of chats by title and `@username` (`/`);
-  - Live typing indicator ("… is typing");
+  - Live typing indicator with sender display name in real time;
   - Colored rendering of Telegram entities (bold, italic, monospace code, URLs, mentions, spoilers);
   - High-resolution inline image previews (Unicode Half-Block `▀` pixel art);
+  - Terminal video and video note playback (Unicode Half-Block + synchronized audio);
   - Media attachment indicators (photo, video, document, voice, sticker, poll);
   - Message reactions (👍, 🔥, ❤️);
   - Infinite upward pagination of message history (`PageUp` / `Ctrl+U`);
   - Contextual quick-reply (`Ctrl+R`) and edit (`Ctrl+E`) modes;
-  - Modal windows: Help (`F1` / `?`), Chat info (`Ctrl+P`), Action menu (`Ctrl+A`), Send file (`Ctrl+O`).
+  - Modal windows: Help (`F1` / `?`), Chat info (`Ctrl+P`), Action menu (`Ctrl+A`), Send file (`Ctrl+O`), Full-screen image viewer, Video player.
 - **Standalone CLI mode**:
   - Send messages and files straight from the command line;
   - List dialogs and print chat history in the terminal;
@@ -472,6 +474,7 @@ TuiGram fully supports mouse interaction in terminals that support mouse reporti
 | **Left click** | **Message in the feed** | **Select the message — a `▌` bar marks it on the left** |
 | **Right click** | **Message in the feed** | **Open the action menu (reactions, reply, edit, download, delete)** |
 | **Left click** | **Image preview inside a message** | **Open the image full screen** |
+| **Left click** | **Video preview inside a message** | **Play video in modal player** |
 | Left click | Empty area of the feed | Focus the message feed |
 | Left click | Header logo 🚀 | Open Help window |
 | Left click | Header active chat title | Open Chat Info window |
@@ -590,6 +593,41 @@ IMAGE_MAX_HEIGHT=14
 
 ---
 
+## 🎬 Video playback in pseudographics
+
+TuiGram supports video playback directly in the terminal using Unicode Half-Block characters (`▀`) and 24-bit RGB truecolor, with synchronized audio playback via system audio or `ffplay`.
+
+### Setup
+Video playback requires `ffmpeg`. You can install it and enable video playback automatically with a single command:
+```bash
+tuigram install-video
+```
+This command checks for existing `ffmpeg`, downloads a static binary if needed, and sets `ENABLE_VIDEO=true` in your `.env`.
+
+### Configuration in `.env`:
+```env
+# Enable video playback in terminal (true/false)
+ENABLE_VIDEO=true
+
+# Playback frame rate (FPS, 1..30, default: 15)
+VIDEO_FPS=15
+
+# Play audio track (true/false)
+VIDEO_AUDIO=true
+
+# Optional custom binary paths
+# FFMPEG_PATH=/usr/local/bin/ffmpeg
+# FFPLAY_PATH=/usr/local/bin/ffplay
+```
+
+### Controls:
+- Click on any video message preview or choose **▶️ Play video** from the action menu (`[Enter]` / right click).
+- `[Space]` — Pause / Resume
+- `[r]` — Replay from beginning
+- `[Esc]` or `[q]` — Close video player
+
+---
+
 ## 🌐 Proxy configuration
 
 TuiGram supports routing MTProto connections through HTTP (including HTTPS CONNECT) and SOCKS5/SOCKS4 proxies — both with and without username/password authentication.
@@ -628,6 +666,9 @@ clone, substitute `node bin/tuigram.js` for `tuigram`):
 # Authorization
 tuigram login
 
+# Install video playback dependencies & enable video in .env
+tuigram install-video
+
 # List dialogs
 tuigram dialogs --limit 30
 
@@ -684,13 +725,17 @@ TuiGram/
 │   │           ├── chatInfoModal.js # Chat info window
 │   │           ├── actionModal.js   # Message action menu
 │   │           ├── fileModal.js     # Send-file dialog
+│   │           ├── imageViewerModal.js # Full-screen image viewer
+│   │           ├── videoPlayerModal.js # Video player modal
 │   │           └── confirmModal.js  # Confirmation dialog
 │   ├── cli/
 │   │   ├── cliCommands.js       # Standalone CLI commands
 │   │   ├── init.js              # tuigram init / paths — setup and diagnostics
+│   │   ├── videoSetup.js        # tuigram install-video — ffmpeg setup & config
 │   │   └── formatters.js        # Console table and log formatters
 │   └── utils/
 │       ├── image.js             # Image decoding, resizing and Half-Block ANSI rendering
+│       ├── video.js             # Video playback utilities, ffmpeg detection & decoding
 │       ├── storage.js           # File operations and session persistence
 │       └── time.js              # Time and date formatting
 ├── scripts/

package/README.ru.md

@@ -53,6 +53,7 @@
 - [Отправка файлов и картинок](#-отправка-файлов-и-картинок)
 - [Темы оформления](#-темы-оформления)
 - [Превью изображений в сообщениях](#️-превью-изображений-в-сообщениях)
+- [Воспроизведение видео в псевдографике](#-воспроизведение-видео-в-псевдографике)
 - [Прокси-сервер](#-прокси-сервер)
 - [Использование через консоль (CLI)](#️-использование-через-консоль-cli)
 - [Структура проекта](#-структура-проекта)
@@ -68,17 +69,18 @@
 - **Полноценный интерактивный TUI**:
   - Двухпанельный адаптивный интерфейс (список чатов слева + история и поле ввода справа);
   - Поддержка управления клавиатурой и мышью (левый клик — выделение сообщения,
-    правый — меню действий, клик по картинке — просмотр на весь экран, колесо — прокрутка);
+    правый — меню действий, клик по картинке — просмотр на весь экран, клик по видео — воспроизведение, колесо — прокрутка);
   - Категории чатов: Все, Личные (ЛС), Группы, Каналы, Боты, Непрочитанные;
   - Мгновенный поиск и фильтрация чатов по названию и `@username` (`/`);
-  - Отображение статуса набора текста («Собеседник печатает...») в реальном времени;
+  - Отображение статуса набора текста с именем собеседника в реальном времени;
   - Цветовое форматирование Telegram Entities (Bold, Italic, Monospace Code, URLs, Mentions, Spoilers);
   - Цветные превью изображений высокого разрешения прямо в чате (Unicode Half-Block `▀` pixel art);
+  - Воспроизведение видео и видеозаметок в псевдографике (Unicode Half-Block + синхронный звук);
   - Индикаторы медиа-вложений (фото, видео, документы, голосовые, стикеры, опросы);
   - Реакции на сообщения (👍, 🔥, ❤️);
   - Бесконечная пагинация истории сообщений вверх (`PageUp` / `Ctrl+U`);
   - Контекстные режимы быстрого ответа (Reply `Ctrl+R`) и редактирования (Edit `Ctrl+E`);
-  - Модальные окна: Справка (`F1` / `?`), Сведения о чате (`Ctrl+P`), Меню действий (`Ctrl+A`), Отправка файла (`Ctrl+O`).
+  - Модальные окна: Справка (`F1` / `?`), Сведения о чате (`Ctrl+P`), Меню действий (`Ctrl+A`), Отправка файла (`Ctrl+O`), Просмотрщик картинок, Видеоплеер.
 - **Автономный CLI-режим**:
   - Быстрая отправка сообщений и файлов из командной строки;
   - Просмотр списка диалогов и истории в терминале;
@@ -464,6 +466,7 @@ TuiGram полноценно поддерживает управление мы
 | **Левый клик** | **Сообщение в ленте** | **Выделение сообщения — оно помечается полосой `▌` слева** |
 | **Правый клик** | **Сообщение в ленте** | **Меню действий (реакции, ответ, редактирование, скачивание, удаление)** |
 | **Левый клик** | **Превью изображения в сообщении** | **Открытие картинки на весь экран** |
+| **Левый клик** | **Превью видео в сообщении** | **Воспроизведение видео в модальном плеере** |
 | Левый клик | Пустое место в ленте | Переключение фокуса на ленту сообщений |
 | Левый клик | Логотип 🚀 в шапке | Открытие окна справки |
 | Левый клик | Название активного чата в шапке | Открытие информации о текущем чате |
@@ -585,6 +588,41 @@ IMAGE_MAX_HEIGHT=14
 
 ---
 
+## 🎬 Воспроизведение видео в псевдографике
+
+TuiGram поддерживает воспроизведение видео и видеозаметок («кружочков») прямо в терминале с помощью символов Unicode Half-Block (`▀`) и 24-битного цвета Truecolor, с синхронным воспроизведением звуковой дорожки.
+
+### Установка зависимостей
+Для декодирования видеопотока требуется `ffmpeg`. Установить его и активировать воспроизведение можно одной командой:
+```bash
+tuigram install-video
+```
+Команда проверит наличие `ffmpeg` в системе, при необходимости скачает статическую сборку в директорию данных TuiGram и выставит `ENABLE_VIDEO=true` в вашем `.env`.
+
+### Настройки в `.env`:
+```env
+# Включение воспроизведения видео в терминале (true/false)
+ENABLE_VIDEO=true
+
+# Частота кадров при воспроизведении (FPS, 1..30, по умолчанию 15)
+VIDEO_FPS=15
+
+# Воспроизведение звуковой дорожки (true/false)
+VIDEO_AUDIO=true
+
+# Опциональные пути к бинарникам (если они не в PATH)
+# FFMPEG_PATH=/usr/local/bin/ffmpeg
+# FFPLAY_PATH=/usr/local/bin/ffplay
+```
+
+### Управление в плеере:
+- Кликните по превью видео в ленте или выберите **▶️ Воспроизвести видео** в меню действий (`[Enter]` / правый клик).
+- `[Пробел]` — пауза / возобновление
+- `[r]` — перезапуск видео с начала
+- `[Esc]` или `[q]` — закрыть плеер
+
+---
+
 ## 🌐 Прокси-сервер
 
 TuiGram поддерживает маршрутизацию MTProto-соединений через HTTP (включая HTTPS CONNECT) и SOCKS5/SOCKS4 прокси — как с авторизацией по логину и паролю, так и без неё.
@@ -623,6 +661,9 @@ TuiGram можно запускать в режиме консольных ут
 # Авторизация
 tuigram login
 
+# Установка зависимостей для видео и активация в .env
+tuigram install-video
+
 # Список диалогов
 tuigram dialogs --limit 30
 
@@ -679,13 +720,17 @@ TuiGram/
 │   │           ├── chatInfoModal.js # Окно информации о чате
 │   │           ├── actionModal.js   # Меню действий с сообщением
 │   │           ├── fileModal.js     # Диалог отправки файла
+│   │           ├── imageViewerModal.js # Полноэкранный просмотрщик изображений
+│   │           ├── videoPlayerModal.js # Модальный терминальный видеоплеер
 │   │           └── confirmModal.js  # Диалог подтверждения
 │   ├── cli/
 │   │   ├── cliCommands.js       # Автономные CLI команды
 │   │   ├── init.js              # tuigram init / paths — настройка и диагностика
+│   │   ├── videoSetup.js        # tuigram install-video — установка ffmpeg и настройка
 │   │   └── formatters.js        # Консольные форматтеры таблиц и логов
 │   └── utils/
 │       ├── image.js             # Декодирование, масштабирование и Half-Block ANSI рендеринг изображений
+│       ├── video.js             # Утилиты видеоплеера, обнаружение ffmpeg и декодирование
 │       ├── storage.js           # Файловые операции и сохранение сессий
 │       └── time.js              # Форматирование времени и дат
 ├── scripts/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emaxe/tuigram",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Полнофункциональный TUI & CLI клиент Telegram на Node.js на базе MTProto (teleproto)",
   "type": "module",
   "exports": {
@@ -57,6 +57,7 @@
     "menu": "./run.sh",
     "tui": "node src/index.js tui",
     "init": "node src/index.js init",
+    "install-video": "node src/index.js install-video",
     "login": "node src/index.js login",
     "dialogs": "node src/index.js dialogs",
     "history": "node src/index.js history",

package/src/cli/formatters.js

@@ -30,7 +30,7 @@ export function formatDialogRow(d) {
 export function formatHistoryMessage(m) {
     const time = gray(`[${formatFullDateTime(m.date)}]`);
     const id = gray(`#${m.id}`);
-    const author = m.out ? green(bold("Вы:")) : cyan(bold(`${m.senderName || "Собеседник"}:`));
+    const author = (m.out && !m.post) ? green(bold("Вы:")) : cyan(bold(`${m.senderName || (m.post ? "Канал" : "Собеседник")}:`));
     const text = m.text || (m.mediaDescription ? m.mediaDescription.replace(/\{[a-z0-9\-]+\}/gi, "") : "");
     const reply = m.replyToMsgId ? gray(` (в ответ на #${m.replyToMsgId})`) : "";
     const edited = m.editDate ? gray(" (изменено)") : "";
@@ -50,7 +50,7 @@ export function formatStreamEvent(kind, data) {
         case "new_message": {
             const m = data.message;
             const peer = yellow(`[${data.peerId}]`);
-            const author = m.out ? green("Вы") : cyan(m.senderName || "Собеседник");
+            const author = (m.out && !m.post) ? green("Вы") : cyan(m.senderName || (m.post ? "Канал" : "Собеседник"));
             const text = m.text || "[медиа]";
             return `${time} ${green("+ НОВОЕ")} ${peer} ${author}: ${text}`;
         }

package/src/cli/videoSetup.js

@@ -0,0 +1,187 @@
+/**
+ * Консольная команда установки и настройки зависимостей для воспроизведения видео.
+ * Проверяет наличие ffmpeg, скачивает статическую сборку при необходимости
+ * и активирует функционал ENABLE_VIDEO=true в файле настроек .env.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import https from "node:https";
+import { spawnSync } from "node:child_process";
+import { bold, cyan, green, yellow, dim, red } from "colorette";
+import { config } from "../config.js";
+import { upsertEnv } from "./init.js";
+import { findFfmpegPath, findFfplayPath, extractFirstFileFromZip } from "../utils/video.js";
+
+/** Ссылки на стабильные статические сборки ffmpeg по платформам. */
+const FFMPEG_URLS = {
+    "darwin:x64": "https://github.com/ffbinaries/ffbinaries-prebuilt/releases/download/v4.4.1/ffmpeg-4.4.1-osx-64.zip",
+    "darwin:arm64": "https://github.com/ffbinaries/ffbinaries-prebuilt/releases/download/v4.4.1/ffmpeg-4.4.1-osx-64.zip",
+    "linux:x64": "https://github.com/ffbinaries/ffbinaries-prebuilt/releases/download/v4.4.1/ffmpeg-4.4.1-linux-64.zip",
+    "linux:arm64": "https://github.com/ffbinaries/ffbinaries-prebuilt/releases/download/v4.4.1/ffmpeg-4.4.1-linux-arm-64.zip",
+    "linux:arm": "https://github.com/ffbinaries/ffbinaries-prebuilt/releases/download/v4.4.1/ffmpeg-4.4.1-linux-armel-32.zip",
+    "win32:x64": "https://github.com/ffbinaries/ffbinaries-prebuilt/releases/download/v4.4.1/ffmpeg-4.4.1-win-64.zip",
+    "win32:ia32": "https://github.com/ffbinaries/ffbinaries-prebuilt/releases/download/v4.4.1/ffmpeg-4.4.1-win-32.zip",
+};
+
+/**
+ * Скачивает буфер по URL с поддержкой HTTP(S) редиректов.
+ * @param {string} targetUrl
+ * @param {number} [redirects=0]
+ * @returns {Promise<Buffer>}
+ */
+function fetchBuffer(targetUrl, redirects = 0) {
+    return new Promise((resolve, reject) => {
+        if (redirects > 5) {
+            return reject(new Error("Слишком много редиректов при загрузке"));
+        }
+        https.get(targetUrl, (res) => {
+            if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                return resolve(fetchBuffer(res.headers.location, redirects + 1));
+            }
+            if (res.statusCode !== 200) {
+                return reject(new Error(`Ошибка HTTP ${res.statusCode}: ${res.statusMessage}`));
+            }
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(chunk));
+            res.on("end", () => resolve(Buffer.concat(chunks)));
+            res.on("error", reject);
+        }).on("error", reject);
+    });
+}
+
+/**
+ * Активирует флаг ENABLE_VIDEO=true в .env файлах.
+ * @returns {string[]} список обновлённых файлов
+ */
+export function enableVideoInEnv() {
+    const updated = [];
+    const targets = [config.configEnvPath];
+
+    const localEnv = path.join(config.packageRoot, ".env");
+    if (fs.existsSync(localEnv) && localEnv !== config.configEnvPath) {
+        targets.push(localEnv);
+    }
+
+    for (const target of targets) {
+        try {
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            let text = "";
+            try {
+                text = fs.readFileSync(target, "utf8");
+            } catch {
+                text = "# TuiGram настройки\n";
+            }
+            const newText = upsertEnv(text, { ENABLE_VIDEO: "true" });
+            fs.writeFileSync(target, newText, { encoding: "utf8", mode: 0o600 });
+            updated.push(target);
+        } catch {
+            // Игнорируем ошибку записи отдельного файла
+        }
+    }
+
+    return updated;
+}
+
+/**
+ * Консольная команда установки зависимостей для видео (`tuigram install-video`).
+ * @param {Record<string, string|boolean>} [flags]
+ * @returns {Promise<void>}
+ */
+export function cmdInstallVideo(flags = {}) {
+    return (async () => {
+        console.log(bold("\n🎬 TuiGram — Установка поддержки воспроизведения видео\n"));
+
+        const existingFfmpeg = findFfmpegPath();
+        const force = Boolean(flags.force);
+
+        if (existingFfmpeg && !force) {
+            console.log(green(`✓ ffmpeg обнаружен: ${existingFfmpeg}`));
+            try {
+                const ver = spawnSync(existingFfmpeg, ["-version"], { encoding: "utf8", timeout: 2000 });
+                if (ver.stdout) {
+                    const firstLine = ver.stdout.trim().split(/\r?\n/)[0];
+                    console.log(dim(`  Версия: ${firstLine}`));
+                }
+            } catch {
+                // Игнорируем
+            }
+
+            const updated = enableVideoInEnv();
+            console.log(green("\n✓ Опция ENABLE_VIDEO=true активирована в .env!"));
+            for (const file of updated) {
+                console.log(dim(`  Файл: ${file}`));
+            }
+
+            printUsageInstructions();
+            return;
+        }
+
+        const platformKey = `${process.platform}:${process.arch}`;
+        const downloadUrl = FFMPEG_URLS[platformKey] || FFMPEG_URLS[`${process.platform}:x64`];
+
+        if (!downloadUrl) {
+            console.log(yellow(`Платформа ${platformKey} не поддерживает автоматическую загрузку бинарника.`));
+            printManualInstallInstructions();
+            return;
+        }
+
+        console.log(`Платформа: ${cyan(platformKey)}`);
+        console.log(`Загрузка статической сборки ffmpeg из GitHub Releases...`);
+        console.log(dim(`URL: ${downloadUrl}\n`));
+
+        try {
+            const zipBuffer = await fetchBuffer(downloadUrl);
+            console.log(`✓ Загружено ${Math.round(zipBuffer.length / 1024 / 1024 * 10) / 10} MB. Распаковка...`);
+
+            const { data } = extractFirstFileFromZip(zipBuffer);
+            const binDir = path.join(config.dataDir, "bin");
+            fs.mkdirSync(binDir, { recursive: true });
+
+            const isWin = process.platform === "win32";
+            const binaryName = isWin ? "ffmpeg.exe" : "ffmpeg";
+            const destPath = path.join(binDir, binaryName);
+
+            fs.writeFileSync(destPath, data, { mode: 0o755 });
+            fs.chmodSync(destPath, 0o755);
+
+            // Проверка запуска
+            const testRun = spawnSync(destPath, ["-version"], { encoding: "utf8", timeout: 3000 });
+            if (testRun.status !== 0) {
+                throw new Error(`Бинарник не запустился (код ошибки: ${testRun.status})`);
+            }
+
+            console.log(green(`✓ ffmpeg успешно установлен: ${destPath}`));
+
+            const updated = enableVideoInEnv();
+            console.log(green("✓ Опция ENABLE_VIDEO=true активирована в .env!"));
+            for (const file of updated) {
+                console.log(dim(`  Файл: ${file}`));
+            }
+
+            printUsageInstructions();
+        } catch (err) {
+            console.error(red(`\nОшибка автоматической установки ffmpeg: ${err.message}`));
+            printManualInstallInstructions();
+        }
+    })();
+}
+
+function printUsageInstructions() {
+    console.log(bold("\n▶ Как воспроизводить видео в TuiGram:"));
+    console.log("  1. Запустите TUI интерфейс: tuigram (или npm start)");
+    console.log("  2. В ленте чата кликните мышью по превью видео");
+    console.log("     или выберите сообщение и нажмите Enter → «Воспроизвести видео»");
+    console.log("  3. Управление в плеере: [Пробел] — пауза/воспроизведение, [r] — с начала, [Esc] или [q] — закрыть.\n");
+}
+
+function printManualInstallInstructions() {
+    console.log(bold("\n📦 Установка ffmpeg вручную через системный пакетный менеджер:"));
+    console.log("  • macOS (Homebrew):     brew install ffmpeg");
+    console.log("  • Ubuntu / Debian:       sudo apt update && sudo apt install -y ffmpeg");
+    console.log("  • Arch Linux:            sudo pacman -S ffmpeg");
+    console.log("  • Fedora:                sudo dnf install ffmpeg");
+    console.log("  • Windows (winget):      winget install Gyan.FFmpeg\n");
+    console.log("После установки добавьте в ваш .env файл:");
+    console.log(cyan("  ENABLE_VIDEO=true\n"));
+}

package/src/config.js

@@ -255,6 +255,12 @@ export const config = {
     imageMaxWidth: parseInt(process.env.IMAGE_MAX_WIDTH || "36", 10) || 36,
     imageMaxHeight: parseInt(process.env.IMAGE_MAX_HEIGHT || "14", 10) || 14,
 
+    enableVideo: String(process.env.ENABLE_VIDEO || process.env.ENABLE_VIDEO_PLAYBACK || "false").toLowerCase() === "true",
+    videoFps: Math.min(30, Math.max(1, parseInt(process.env.VIDEO_FPS || "15", 10) || 15)),
+    videoAudio: String(process.env.VIDEO_AUDIO || "true").toLowerCase() !== "false",
+    ffmpegPath: process.env.FFMPEG_PATH || null,
+    ffplayPath: process.env.FFPLAY_PATH || null,
+
     proxy: parseProxyConfig(),
 
     /**

package/src/index.js

@@ -14,6 +14,7 @@ import {
     cmdListen
 } from "./cli/cliCommands.js";
 import { cmdInit, cmdPaths } from "./cli/init.js";
+import { cmdInstallVideo } from "./cli/videoSetup.js";
 import { config } from "./config.js";
 import { red, bold } from "colorette";
 
@@ -57,6 +58,7 @@ ${bold("Настройка:")}
   tuigram init                   Ввести ключи Telegram API (api_id / api_hash)
                                  --api-id <ID> --api-hash <HASH>  без диалога
   tuigram paths                  Показать пути к настройкам, сессии и загрузкам
+  tuigram install-video          Установить ffmpeg и включить воспроизведение видео
 
 ${bold("Консольные команды (CLI):")}
   tuigram login                  Авторизация в аккаунте (телефон, код, 2FA)
@@ -104,6 +106,12 @@ async function main() {
             cmdPaths();
             process.exit(0);
             break;
+        case "install-video":
+        case "setup-video":
+        case "install-deps":
+            await cmdInstallVideo(flags);
+            process.exit(0);
+            break;
         case "login":
             await cmdLogin();
             process.exit(0);