matrixr 1.1.0

Animated Matrix-style terminal screensaver
Documentation
<p align="center">
  <img src="assets/icon.svg" height="128" alt="Иконка matrixr" />
</p>

<p align="center">
  <a href="https://github.com/WhoSowSee/matrixr/graphs/contributors"><img src="https://img.shields.io/github/contributors/WhoSowSee/matrixr?style=for-the-badge&color=CBA6F7&labelColor=302D41&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2NkZDZmNCIgZD0iTTkgMTFhNCA0IDAgMSAwIDAtOCA0IDQgMCAwIDAgMCA4Wm0wIDJjLTMuOSAwLTcgMi03IDQuNVYyMGgxNHYtMi41QzE2IDE1IDEyLjkgMTMgOSAxM1ptOC41LTEuNWEzLjI1IDMuMjUgMCAxIDAgMC02LjUgMy4yNSAzLjI1IDAgMCAwIDAgNi41Wm0wIDEuOGMtLjkgMC0xLjc1LjE1LTIuNS40MiAxLjcgMS4wNSAyLjcgMi40NSAyLjcgMy45OFYyMEgyMnYtMi4zYzAtMi40LTItNC40LTQuNS00LjRaIi8+PC9zdmc+" alt="CONTRIBUTORS"></a>
  <a href="https://github.com/WhoSowSee/matrixr/forks"><img src="https://img.shields.io/github/forks/WhoSowSee/matrixr?style=for-the-badge&color=89B4FA&labelColor=302D41&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI%2BPGcgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMTIgMTIpIHNjYWxlKDEuMDgpIHRyYW5zbGF0ZSgtMTIgLTEyKSI%2BPHBhdGggZmlsbD0iI2NkZDZmNCIgZD0iTTYgM2EzIDMgMCAxIDAgMCA2IDMgMyAwIDAgMCAwLTZabTEyIDBhMyAzIDAgMSAwIDAgNiAzIDMgMCAwIDAgMC02Wk0xMiAxNWEzIDMgMCAxIDAgMCA2IDMgMyAwIDAgMCAwLTZaIi8%2BPHBhdGggZmlsbD0iI2NkZDZmNCIgZD0iTTUgOGgydjIuNGMwIC4zMy4yNy42LjYuNmg4LjhjLjMzIDAgLjYtLjI3LjYtLjZWOGgydjIuNGEyLjYgMi42IDAgMCAxLTIuNiAyLjZIMTN2MmgtMnYtMkg3LjZBMi42IDIuNiAwIDAgMSA1IDEwLjRWOFoiLz48L2c%2BPC9zdmc%2B" alt="FORKS"></a>
  <a href="https://github.com/WhoSowSee/matrixr/stargazers"><img src="https://img.shields.io/github/stars/WhoSowSee/matrixr?style=for-the-badge&color=F9E2AF&labelColor=302D41&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI%2BPGcgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMCAtMS42KSI%2BPHBhdGggZmlsbD0iI2NkZDZmNCIgZD0iTTEyIDIuNSAxNC45IDguNGw2LjUgMWEuOC44IDAgMCAxIC40NSAxLjM2bC00LjcgNC41OCAxLjEgNi40NWEuOC44IDAgMCAxLTEuMTYuODRMMTIgMTkuOTUgNi4yIDIyLjYzYS44LjggMCAwIDEtMS4xNi0uODRsMS4xLTYuNDUtNC43LTQuNThBLjguOCAwIDAgMSAxLjkgOS40bDYuNS0xTDEyIDIuNVoiLz48L2c%2BPC9zdmc%2B" alt="STARS"></a>
</p>

<p align="center">
  <a href="https://crates.io/crates/matrixr"><img src="https://img.shields.io/crates/v/matrixr?style=for-the-badge&color=FAB387&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNiAxNiI%2BCjxwYXRoIGZpbGw9IiNjZGQ2ZjQiIGQ9Ik0xLjUgNi45ODRWMTFsNi41MDMgMy41TDE0LjUgMTFWM0wxMSAxLjVsLTYuNSAzdjF6Ii8%2BCjxnIGZpbGw9Im5vbmUiIHN0cm9rZT0iIzMwMkQ0MSIgc3Ryb2tlLXdpZHRoPSIuOSIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIj4KPHBhdGggZD0iTTEuNSA3TDggMTAuNUwxNC41IDdtLTEwLTIuNWwzLjUwMyAyTDE0LjQ5OCAzTTQuNSA1LjV2N20zLjUtNlYxNCIvPgo8cGF0aCBkPSJNOC4wMDMgM0wxMS41IDQuNXY4Ii8%2BCjwvZz4KPC9zdmc%2B&labelColor=302D41" alt="CRATES.IO"></a>
  <a href="https://crates.io/crates/matrixr"><img src="https://img.shields.io/crates/d/matrixr?style=for-the-badge&color=A6E3A1&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNiAxNiI%2BCjxwYXRoIGZpbGw9IiNjZGQ2ZjQiIGQ9Ik0xLjUgNi45ODRWMTFsNi41MDMgMy41TDE0LjUgMTFWM0wxMSAxLjVsLTYuNSAzdjF6Ii8%2BCjxnIGZpbGw9Im5vbmUiIHN0cm9rZT0iIzMwMkQ0MSIgc3Ryb2tlLXdpZHRoPSIuOSIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIj4KPHBhdGggZD0iTTEuNSA3TDggMTAuNUwxNC41IDdtLTEwLTIuNWwzLjUwMyAyTDE0LjQ5OCAzTTQuNSA1LjV2N20zLjUtNlYxNCIvPgo8cGF0aCBkPSJNOC4wMDMgM0wxMS41IDQuNXY4Ii8%2BCjwvZz4KPC9zdmc%2B&labelColor=302D41" alt="DOWNLOADS"></a>
</p>

<p align="center">
  <a href="README.md">English</a> · <strong>Русский</strong>
</p>

<h2 align="center">Настраиваемый matrix-дождь для терминала на Rust</h2>

<p align="center">
  <img src="assets/preview.png" width="750" alt="Предпросмотр matrixr в терминале" />
</p>

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

- Независимые потоки Matrix-дождя с адаптацией к изменению размера терминала
- ASCII, японская полуширинная катакана, lambda-режим и режим совместимости с X Window
- Обычная и old-style прокрутка, асинхронные потоки и изменение символов на лету
- Именованные цвета, rainbow-режим и случайное или сплошное жирное начертание
- Deep Mode с RGB-затуханием хвостов по расстоянию и плавным параллаксом ближнего, среднего и дальнего планов
- Раздельное управление скоростью симуляции и частотой отрисовки
- Пауза, блокировка и режим заставки с временными статусными сообщениями
- Альтернативный экран, вывод в отдельный TTY и восстановление состояния терминала при выходе
- Опциональная загрузка консольного шрифта Linux через <code>setfont matrix</code>

## Установка

### Из crates.io

После публикации пакета:

```bash
cargo install matrixr
```

### Через Nix (Flake)

```bash
nix run github:WhoSowSee/matrixr
nix profile install github:WhoSowSee/matrixr
```

`nix run` запускает matrixr без установки, а `nix profile install` добавляет его в профиль Nix.

### Из исходного кода

```bash
git clone https://github.com/WhoSowSee/matrixr.git
cd matrixr
cargo install --path .
```

Оба способа устанавливают один исполняемый файл: <code>matrixr</code>.

## Быстрый старт

```bash
matrixr
matrixr -D
matrixr -ba -u 2 -C red
matrixr -r -k
matrixr -L
```

Общий синтаксис:

```text
matrixr -[DabBcfhlsmVxk] [-u speed] [-C color] [-t tty]
```

## Параметры командной строки

| Параметр | Описание |
| --- | --- |
| <code>-D</code> | Запустить Deep Mode с RGB-затуханием глубины и плавным параллаксом |
| <code>-a</code> | Использовать асинхронное обновление потоков |
| <code>-b</code> | Включить случайное жирное начертание символов |
| <code>-B</code> | Сделать все символы жирными; переопределяет <code>-b</code> |
| <code>-n</code> | Отключить жирность; переопределяет <code>-b</code> и <code>-B</code> |
| <code>-c</code> | Использовать японскую полуширинную катакану |
| <code>-m</code> | Включить lambda-режим |
| <code>-k</code> | Изменять символы во время движения потоков |
| <code>-o</code> | Использовать old-style прокрутку |
| <code>-r</code> | Включить rainbow-режим |
| <code>-C color</code> | Выбрать <code>green</code>, <code>red</code>, <code>blue</code>, <code>white</code>, <code>yellow</code>, <code>cyan</code>, <code>magenta</code> или <code>black</code> |
| <code>-u 0..10</code> | Начальная задержка симуляции в единицах по 10 мс; по умолчанию <code>4</code>, <code>0</code> — без ограничения |
| <code>-L</code> | Запустить приложение заблокированным; сообщения видны 3 секунды |
| <code>-s</code> | Режим заставки; выход по первому нажатию клавиши |
| <code>-x</code> | Включить режим совместимости символов с X Window |
| <code>-l</code> | Режим Linux console с попыткой загрузить шрифт <code>matrix</code> |
| <code>-f</code> | Установить <code>TERM=linux</code> до инициализации терминала |
| <code>-t tty</code> | Выводить анимацию в указанный TTY |
| <code>-h</code> | Показать справку |
| <code>-V</code> | Показать версию |

## Управление во время работы

| Клавиша | Действие |
| --- | --- |
| <code>~</code> | Открыть или закрыть справку по сочетаниям клавиш в центре экрана |
| <code>q</code> | Выйти, если приложение не заблокировано |
| <code>Ctrl+C</code> | Выйти, если приложение не заблокировано |
| <code>D</code> | Переключить Deep Mode без очистки существующих потоков |
| <code>a</code> | Переключить асинхронное обновление |
| <code>b</code> / <code>B</code> / <code>n</code> | Случайная жирность / все символы жирные / жирность отключена |
| <code>c</code> | Переключить японский набор символов, если приложение не заблокировано |
| <code>m</code> | Переключить lambda-режим |
| <code>k</code> | Переключить изменение символов на лету |
| <code>o</code> | Переключить old-style прокрутку |
| <code>r</code> | Переключить rainbow-режим |
| <code>x</code> | Переключить режим совместимости с X Window |
| <code>p</code> или <code>P</code> | Поставить симуляцию на паузу или продолжить |
| <code>L</code> | Заблокировать или разблокировать приложение |
| <code>0..9</code> | Изменить скорость симуляции; <code>0</code> — без ограничения |
| <code>d</code> / <code>f</code> | Уменьшить / увеличить FPS отрисовки в диапазоне 1–120; клавишу можно удерживать |

Изменения параметров отображаются в правом верхнем углу в течение одной секунды.

### Горячие клавиши цветов

| Клавиша | Цвет |
| --- | --- |
| <code>!</code> | Красный |
| <code>@</code> | Зелёный |
| <code>#</code> | Жёлтый |
| <code>$</code> | Синий |
| <code>%</code> | Пурпурный |
| <code>^</code> | Голубой |
| <code>&</code> | Белый |
| <code>)</code> | Чёрный |

Выбор цвета отключает rainbow-режим.

## Разработка

```bash
cargo fmt -- --check
cargo test
cargo clippy --all-targets --all-features -- -D warnings
cargo build --release
```

<p align="center">
  <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true" alt="Catppuccin footer" />
</p>

<p align="center">
  <i><code>&copy; 2026-present <a href="https://github.com/WhoSowSee">WhoSowSee</a></code></i>
</p>

<p align="center">
  <a href="https://github.com/WhoSowSee/matrixr/blob/main/LICENSE"><img src="https://img.shields.io/github/license/WhoSowSee/matrixr?style=for-the-badge&color=CBA6F7&logoColor=cdd6f4&labelColor=302D41" alt="LICENSE"></a>
</p>