# omatrix
`omatrix` is an app that allows you to larp like a super cool hackerman, intended primarily for
Omarchy users. It renders falling Matrix-style glyph rain and derives its colors
from the active Omarchy theme when available.
## Install
```sh
cargo install omatrix
```
## Usage
```sh
omatrix
omatrix --seed 42
omatrix --theme ~/.local/state/omarchy/current/theme/colors.toml
```
Press `q`, `Esc`, or `Ctrl-C` to quit.
## Options
- `--theme PATH`: read an Omarchy-style theme file from `PATH`
- `--seed N`: use a deterministic random seed
## Omarchy theme
By default, `omatrix` reads the active Omarchy theme from
`~/.local/state/omarchy/current/theme/colors.toml`. If the matching Hyprland theme
file contains an active border color, `omatrix` uses that as the rain accent.
## Fallback theme
If the default Omarchy theme file is not present, `omatrix` starts with a
built-in dark green Matrix palette. Passing `--theme PATH` disables this fallback
for that path, so missing or malformed custom theme files are reported as errors.