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

cargo install omatrix

Usage

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.