@emaxe/tuigram 1.3.0 → 1.5.0

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,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 - English localization of the TUI and CLI interface strings.
 
+## [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
+
+- Message selection in the chat feed: a left click marks a message with a colored `▌` bar
+  along all of its lines. `↑` / `↓` (and `k` / `j`) move the selection between messages and
+  scroll it into view; reaching the topmost message loads the previous page of history.
+- The message action menu now opens with the right mouse button, and with `[Enter]` on the
+  selected message. Previously any click opened it, so a message could not simply be picked.
+- The selected message became the target for actions: `[Ctrl+R]` replies to it, `[Ctrl+E]`
+  edits it (when it is yours), `[Ctrl+A]` and the status bar `[Ctrl+A]` button open the menu
+  for it. With nothing selected the previous behaviour applies — the last message in the chat.
+- Full-screen image viewer opened by clicking an image preview: the thumbnail that arrived
+  with the message is shown instantly, then replaced by the full-size version. For videos and
+  documents the largest thumbnail is used and the file itself is never downloaded. Close with
+  `[Esc]`, `[Q]`, `[Enter]` or a click; the image is re-rendered when the terminal is resized.
+- The `[Ctrl+A]` shortcut (action menu) now works from every panel, including the input box.
+- `[F12]` temporarily hands the mouse back to the terminal so text can be selected and
+  copied, and restores the capture when pressed again.
+
+### Fixed
+
+- A modal window was closed by the very click that opened it: blessed delivers a click to the
+  element first and to the screen immediately after. As a result the status bar buttons
+  `[F1]`, `[Ctrl+A]`, `[Ctrl+P]`, `[Ctrl+Q]`, the header logo and the chat title did not work
+  with the mouse at all, and the action menu only stayed open when the click happened to land
+  inside the future modal rectangle.
+- Clicking a message hit the wrong message in a scrolled feed: the position was read from
+  `getScroll()`, which adds a blessed-internal offset to the actual content shift.
+- The mouse wheel scrolled the feed twice per notch (a custom handler on top of the built-in
+  blessed one), and scrolling up from the bottom of the feed did nothing for the first notches.
+- `PageUp` / `PageDown` scrolled the feed twice as far while it had focus.
+- Clicks on the input hints were off by about 10 cells: clicking `[Ctrl+E] Правка` triggered
+  commands, and clicking the "Введите сообщение…" text switched to reply mode.
+- A right click behaved like a left one: it opened chats in the list and pressed status bar
+  buttons and filter tabs.
+- The feed layout map drifted by one line per message, so click coordinates diverged from the
+  actual text the longer the history grew.
+- A full-screen image render could evict and replace the same image's thumbnail in the feed:
+  the render size is now part of the pseudo-graphics cache key.
+
 ## [1.3.0] — 2026-09-01
 
 ### Added
@@ -135,7 +195,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.3.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.5.0...HEAD
+[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
 [1.1.0]: https://github.com/emaxe/tuigram/compare/v1.0.1...v1.1.0

package/CHANGELOG.ru.md

@@ -13,6 +13,70 @@
 
 - Английская локализация строк интерфейса TUI и CLI.
 
+## [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
+
+### Добавлено
+
+- Выделение сообщений в ленте чата: левый клик мышью помечает сообщение цветной полосой `▌`
+  слева от всех его строк. Стрелки `↑` / `↓` (и `k` / `j`) перемещают выделение между
+  сообщениями с автоподкруткой ленты; на самом верхнем сообщении подгружается предыдущая
+  страница истории.
+- Меню действий над сообщением открывается правой кнопкой мыши, а также `[Enter]` над
+  выделенным сообщением. Прежде меню открывалось любым кликом, из-за чего сообщение нельзя
+  было просто выбрать.
+- Выделенное сообщение стало целью действий: `[Ctrl+R]` отвечает именно на него, `[Ctrl+E]`
+  правит его (если оно ваше), `[Ctrl+A]` и кнопка `[Ctrl+A]` строки состояния открывают меню
+  для него. Без выделения действует прежнее поведение — последнее сообщение чата.
+- Полноэкранный просмотр изображений по клику на превью в сообщении: сначала мгновенно
+  показывается пришедшая с сообщением миниатюра, затем она заменяется полноразмерной
+  версией. У видео и документов берётся самая крупная миниатюра, сам файл не качается.
+  Закрытие — `[Esc]`, `[Q]`, `[Enter]` или клик; при изменении размера терминала
+  изображение перерисовывается.
+- Глобальное сочетание `[Ctrl+A]` (меню действий) теперь работает из любой панели, включая
+  поле ввода.
+- Клавиша `[F12]` временно отдаёт мышь терминалу, чтобы можно было выделить и скопировать
+  текст, и возвращает захват повторным нажатием.
+
+### Исправлено
+
+- Модальное окно закрывалось тем же кликом, которым его открыли: blessed рассылает клик
+  сначала элементу, а сразу за ним — экрану. Из-за этого мышью вовсе не работали кнопки
+  строки состояния `[F1]`, `[Ctrl+A]`, `[Ctrl+P]`, `[Ctrl+Q]`, логотип и заголовок чата в
+  шапке, а меню действий открывалось лишь при попадании клика в будущий прямоугольник окна.
+- Клик по сообщению попадал не в то сообщение при прокрученной ленте: позиция бралась из
+  `getScroll()`, которая складывает сдвиг содержимого со служебным смещением blessed.
+- Колесо мыши прокручивало ленту дважды за щелчок (собственный обработчик поверх
+  встроенного в blessed), а прокрутка вверх от нижнего края ленты первые несколько щелчков
+  не работала вовсе.
+- `PageUp` / `PageDown` прокручивали ленту на удвоенное расстояние, когда она была в фокусе.
+- Клики по подсказкам поля ввода были смещены примерно на 10 ячеек: клик по `[Ctrl+E] Правка`
+  вызывал команды, а клик по тексту «Введите сообщение…» включал режим ответа.
+- Правый клик срабатывал как левый: открывал чат в списке, нажимал кнопки строки состояния
+  и вкладки фильтров.
+- Разметка ленты «съезжала» на одну строку с каждым сообщением, из-за чего карта координат
+  расходилась с реальным текстом тем сильнее, чем длиннее история.
+- Полноэкранный рендер картинки мог вытеснить и подменить её же миниатюру в ленте: размер
+  теперь входит в ключ кэша псевдографики.
+
 ## [1.3.0] — 2026-09-01
 
 ### Добавлено
@@ -137,7 +201,9 @@
 - Тест контраста по WCAG (порог 3:1) для каждой темы — **после** конверсии в xterm-256,
   то есть ровно в том виде, в каком цвет увидит пользователь.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.3.0...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.5.0...HEAD
+[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
 [1.1.0]: https://github.com/emaxe/tuigram/compare/v1.0.1...v1.1.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)
@@ -71,17 +72,19 @@ 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 (clicks, wheel scrolling);
+  - Keyboard and mouse control (left click selects a message, right click opens the action
+    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");
   - 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;
@@ -433,22 +436,26 @@ node scripts/check-package.js   # verifies that .env and the session do not leak
 |---|---|---|
 | `Tab` / `Shift+Tab` | Global | Cycle focus: dialog list → message feed → input box |
 | `↑` / `↓` | Dialog list | Select a chat |
+| `↑` / `↓`, `k` / `j` | Message feed | Move the selection between messages |
 | `Enter` | Dialog list | Open the selected chat and load its history |
+| `Enter` | Message feed | Action menu for the selected message |
 | `1` .. `6` | Dialog list | Switch category: `1:All`, `2:DM`, `3:Groups`, `4:Channels`, `5:Bots`, `6:Unread` |
 | `/` | Dialog list | Search / filter chats |
 | `Enter` | Input box | Send the typed message |
 | `Ctrl+J` | Input box | Insert a line break without sending |
-| `Ctrl+R` | Chat / Input | Reply to the last message |
-| `Ctrl+E` | Chat / Input | Edit your own last message |
-| `Ctrl+A` | Messages | Context action menu (reactions, delete, download, reply) |
+| `Ctrl+R` | Chat / Input | Reply to the selected message, or the last one |
+| `Ctrl+E` | Chat / Input | Edit the selected message of yours, or your last one |
+| `Ctrl+A` | Global | Context action menu (reactions, delete, download, reply) |
 | `Ctrl+O` | Global | Send a file / photo / document |
 | `Ctrl+F` | Send dialog | File browser (navigate folders) |
 | `Ctrl+D` | Send dialog | Send uncompressed, as a document |
 | `Ctrl+P` | Global | Info about the current chat (ID, members, links) |
 | `PageUp` / `Ctrl+U` | History | Scroll up / load older history |
 | `PageDown` / `Ctrl+D` | History | Scroll down |
+| `Home` / `End` | History | Jump to the top (loads history) / to the last message |
 | `Esc` | Modals | Close the modal / cancel reply or edit |
 | `F1` or `?` | Global | Help window with every shortcut |
+| `F12` | Global | Hand the mouse to the terminal for text selection (press again to return) |
 | `Ctrl+Q` / `Ctrl+C` | Global | Safely exit the client |
 
 ---
@@ -459,20 +466,52 @@ TuiGram fully supports mouse interaction in terminals that support mouse reporti
 
 | Action | Target | Result |
 |---|---|---|
-| Click | Left / Middle / Bottom panel | Focus the clicked panel |
-| Click | Chat item in dialog list | Immediately select and open the chat |
-| Click | Filter tabs `1:Все` .. `6:Непроч` | Switch chat category filter |
-| Click | Search bar `[/]` | Focus search box and clear placeholder |
+| Left click | Left / Middle / Bottom panel | Focus the clicked panel |
+| Left click | Chat item in dialog list | Immediately select and open the chat |
+| Left click | Filter tabs `1:Все` .. `6:Непроч` | Switch chat category filter |
+| Left click | Search bar `[/]` | Focus search box and clear placeholder |
 | Wheel scroll | Dialog list / Message feed | Smooth scroll (scrolling up to the top loads older messages) |
-| Click | Any message line | Open message action menu (reactions, reply, edit, download, delete) |
-| Click | Header logo 🚀 | Open Help window |
-| Click | Header active chat title | Open Chat Info window |
-| Click | Header connection badge | Show active network status |
-| Click | Input context bar | Cancel reply/edit mode or insert `/` |
-| Click | Status bar items | Trigger corresponding action (`[Tab]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+Q]`, etc.) |
+| **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 |
+| Left click | Header connection badge | Show active network status |
+| Left click | Input context bar | Cancel reply/edit mode, trigger `[Ctrl+R]` / `[Ctrl+E]` or insert `/` |
+| Left click | Status bar items | Trigger corresponding action (`[Tab]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+Q]`, etc.) |
 | Click | Outside any modal window | Dismiss / close modal |
 | Click | Buttons in modals | Click buttons (`[ Отправить ]`, `[ Отмена ]`, `[ Закрыть ]`, toggle checkboxes) |
 
+### Message selection
+
+A left click selects a message: a colored `▌` bar appears to the left of all its lines.
+`↑` / `↓` (and `k` / `j`) move the selection between messages and scroll it into view;
+reaching the topmost message loads the previous page of history. Plain scrolling stays on
+`PageUp` / `PageDown`, the wheel and `Home` / `End`.
+
+The selected message becomes the target for actions: `[Enter]` and right click open the
+action menu, `[Ctrl+R]` replies to it, `[Ctrl+E]` edits it (when it is yours). With nothing
+selected these actions apply to the last message in the chat, as before.
+
+### Full-screen image viewer
+
+A left click on a preview opens the image across the whole terminal. The thumbnail that
+already arrived with the message is shown instantly, then it is replaced by the full-size
+version as soon as it downloads. For videos and documents the largest available thumbnail
+is shown — the file itself is never downloaded. Close with `[Esc]`, `[Q]`, `[Enter]` or a
+click anywhere.
+
+### Right click and terminal text selection
+
+> **macOS Terminal.app** captures the right click for its own context menu and never passes
+> it to the application. Use `[Enter]` or `[Ctrl+A]` on the selected message there. Right
+> click works in iTerm2, Ghostty, Alacritty, Kitty and Windows Terminal.
+
+While the app captures the mouse, the terminal cannot select text for copying. Press `[F12]`
+to hand the mouse back to the terminal, and `[F12]` again to return control to the interface.
+
 ---
 
 ## 💬 Slash commands in the input box
@@ -554,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.
@@ -592,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
 
@@ -648,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)
 - [Структура проекта](#-структура-проекта)
@@ -67,17 +68,19 @@
 
 - **Полноценный интерактивный 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-режим**:
   - Быстрая отправка сообщений и файлов из командной строки;
   - Просмотр списка диалогов и истории в терминале;
@@ -425,22 +428,26 @@ node scripts/check-package.js   # проверка, что в пакет не у
 |---|---|---|
 | `Tab` / `Shift+Tab` | Глобально | Фокус по кругу: Список диалогов → Лента сообщений → Поле ввода |
 | `↑` / `↓` | Список диалогов | Выбор чата |
+| `↑` / `↓`, `k` / `j` | Лента сообщений | Перемещение выделения между сообщениями |
 | `Enter` | Список диалогов | Открыть выбранный чат и загрузить историю |
+| `Enter` | Лента сообщений | Меню действий над выделенным сообщением |
 | `1` .. `6` | Список диалогов | Переключение категорий: `1:Все`, `2:ЛС`, `3:Группы`, `4:Каналы`, `5:Боты`, `6:Непроч` |
 | `/` | Список диалогов | Поиск / фильтрация чатов |
 | `Enter` | Поле ввода | Отправить набранное сообщение |
 | `Ctrl+J` | Поле ввода | Перенос строки без отправки |
-| `Ctrl+R` | Чат / Ввод | Ответить (Reply) на последнее сообщение |
-| `Ctrl+E` | Чат / Ввод | Редактировать своё последнее сообщение |
-| `Ctrl+A` | Сообщения | Контекстное меню действий (Реакции, Удаление, Скачивание, Ответ) |
+| `Ctrl+R` | Чат / Ввод | Ответить (Reply) на выделенное сообщение, иначе — на последнее |
+| `Ctrl+E` | Чат / Ввод | Редактировать выделенное своё сообщение, иначе — последнее своё |
+| `Ctrl+A` | Глобально | Контекстное меню действий (Реакции, Удаление, Скачивание, Ответ) |
 | `Ctrl+O` | Глобально | Отправить файл / фото / документ |
 | `Ctrl+F` | Окно отправки | Обзор файлов (навигация по папкам) |
 | `Ctrl+D` | Окно отправки | Отправить без сжатия, документом |
 | `Ctrl+P` | Глобально | Информация о текущем чате (ID, участники, ссылки) |
 | `PageUp` / `Ctrl+U`| История | Прокрутка вверх / подгрузка старой истории |
 | `PageDown` / `Ctrl+D`| История | Прокрутка вниз |
+| `Home` / `End` | История | В начало ленты (подгрузка истории) / к последнему сообщению |
 | `Esc` | Модальные окна | Закрыть модальное окно / отменить Reply/Edit |
 | `F1` или `?` | Глобально | Окно справки со всеми горячими клавишами |
+| `F12` | Глобально | Отдать мышь терминалу для выделения текста (повторно — вернуть) |
 | `Ctrl+Q` / `Ctrl+C` | Глобально | Безопасный выход из клиента |
 
 ---
@@ -451,20 +458,53 @@ TuiGram полноценно поддерживает управление мы
 
 | Действие | Где | Результат |
 |---|---|---|
-| Клик | Левая / Центральная / Нижняя панель | Переключение фокуса на выбранную панель |
-| Клик | Диалог в списке чатов | Мгновенный выбор и открытие чата |
-| Клик | Вкладки `1:Все` .. `6:Непроч` | Переключение фильтра категории чатов |
-| Клик | Поле поиска `[/]` | Фокус в поиск с очисткой подсказки |
+| Левый клик | Левая / Центральная / Нижняя панель | Переключение фокуса на выбранную панель |
+| Левый клик | Диалог в списке чатов | Мгновенный выбор и открытие чата |
+| Левый клик | Вкладки `1:Все` .. `6:Непроч` | Переключение фильтра категории чатов |
+| Левый клик | Поле поиска `[/]` | Фокус в поиск с очисткой подсказки |
 | Колесо мыши | Список чатов / Лента сообщений | Плавная прокрутка (прокрутка вверх в ленте подгружает историю) |
-| Клик | Любое сообщение | Открытие меню действий (реакции, ответ, редактирование, удаление) |
-| Клик | Логотип 🚀 в шапке | Открытие окна справки |
-| Клик | Название активного чата в шапке | Открытие информации о текущем чате |
-| Клик | Индикатор статуса в шапке | Просмотр статуса MTProto подключения |
-| Клик | Контекстная плашка ввода | Сброс режима ответа/редактирования или вставка `/` |
-| Клик | Кнопки строки состояния | Быстрый вызов действий (`[Tab]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+Q]` и др.) |
+| **Левый клик** | **Сообщение в ленте** | **Выделение сообщения — оно помечается полосой `▌` слева** |
+| **Правый клик** | **Сообщение в ленте** | **Меню действий (реакции, ответ, редактирование, скачивание, удаление)** |
+| **Левый клик** | **Превью изображения в сообщении** | **Открытие картинки на весь экран** |
+| **Левый клик** | **Превью видео в сообщении** | **Воспроизведение видео в модальном плеере** |
+| Левый клик | Пустое место в ленте | Переключение фокуса на ленту сообщений |
+| Левый клик | Логотип 🚀 в шапке | Открытие окна справки |
+| Левый клик | Название активного чата в шапке | Открытие информации о текущем чате |
+| Левый клик | Индикатор статуса в шапке | Просмотр статуса MTProto подключения |
+| Левый клик | Контекстная плашка ввода | Сброс режима ответа/редактирования, `[Ctrl+R]`, `[Ctrl+E]` или вставка `/` |
+| Левый клик | Кнопки строки состояния | Быстрый вызов действий (`[Tab]`, `[F1]`, `[Ctrl+A]`, `[Ctrl+Q]` и др.) |
 | Клик | Мимо любого модального окна | Закрытие модального окна |
 | Клик | Кнопки в модалках | Нажатие кнопки (`[ Отправить ]`, `[ Отмена ]`, `[ Закрыть ]`, чекбоксы) |
 
+### Выделение сообщений
+
+Левый клик выделяет сообщение: слева от всех его строк появляется цветная полоса `▌`.
+Стрелки `↑` / `↓` (и `k` / `j`) в ленте двигают выделение между сообщениями и подкручивают
+ленту к выбранному; дойдя до самого верхнего сообщения, клиент подгружает предыдущую
+страницу истории. Прокрутка при этом остаётся на `PageUp` / `PageDown`, колесе и `Home` / `End`.
+
+Выделенное сообщение становится целью действий: `[Enter]` и правый клик открывают меню
+действий, `[Ctrl+R]` отвечает именно на него, `[Ctrl+E]` правит его (если оно ваше).
+Без выделения все эти действия, как и раньше, применяются к последнему сообщению чата.
+
+### Просмотр изображений на весь экран
+
+Левый клик по превью открывает изображение во весь терминал. Сначала мгновенно
+показывается миниатюра, уже пришедшая вместе с сообщением, затем она заменяется
+полноразмерной версией, как только та скачается. У видео и документов показывается
+самая крупная миниатюра — сам файл не качается. Закрыть: `[Esc]`, `[Q]`, `[Enter]`
+или клик в любом месте.
+
+### Правая кнопка и выделение текста терминалом
+
+> **macOS Terminal.app** перехватывает правый клик под собственное контекстное меню и не
+> передаёт его приложению. Там пользуйтесь `[Enter]` или `[Ctrl+A]` над выделенным
+> сообщением. В iTerm2, Ghostty, Alacritty, Kitty и Windows Terminal правый клик работает.
+
+Пока мышь захвачена приложением, терминал не даёт выделять текст для копирования.
+Нажмите `[F12]`, чтобы временно отдать мышь терминалу, и `[F12]` ещё раз, чтобы вернуть
+управление интерфейсу.
+
 ---
 
 ## 💬 Слэш-команды в поле ввода
@@ -548,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 прокси — как с авторизацией по логину и паролю, так и без неё.
@@ -586,6 +661,9 @@ TuiGram можно запускать в режиме консольных ут
 # Авторизация
 tuigram login
 
+# Установка зависимостей для видео и активация в .env
+tuigram install-video
+
 # Список диалогов
 tuigram dialogs --limit 30
 
@@ -642,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.3.0",
+  "version": "1.5.0",
   "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",