omatrix 0.1.1

A Matrix-style terminal rain animation for Omarchy users
Documentation
# 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.