omafetch

Omarchy-native Rust fetch tool.

omafetch is not a generic fetch clone. Omarchy decides how it looks; omafetch decides what to show.

It reads Omarchy state from the existing Omarchy environment and renders a polished system identity view. There are no theme, logo, color, style, preset, or config flags.

On systems without Omarchy state, Omarchy-specific rows render as unknown. Other system rows are collected from standard Linux files and common desktop tools when available.

Install

Linux x86_64, from the latest GitHub Release:

curl -fsSL https://raw.githubusercontent.com/modoterra/omafetch/main/install.sh | bash

That verifies the published checksum and installs ~/.local/bin/omafetch. On Omarchy, hook the stock About item next:

omafetch bind

# system-wide
curl -fsSL https://raw.githubusercontent.com/modoterra/omafetch/main/install.sh | bash -s -- --prefix /usr/local

# pin a version
curl -fsSL https://raw.githubusercontent.com/modoterra/omafetch/main/install.sh | bash -s -- --version 0.1.0

# remove the Hyprland hook, then the binary and wrapper
omafetch unbind
curl -fsSL https://raw.githubusercontent.com/modoterra/omafetch/main/install.sh | bash -s -- --uninstall

From source:

cargo install --git https://github.com/modoterra/omafetch --locked
omafetch bind

Usage

Show the full Omarchy/system view:

omafetch

Show that same view and wait for a key. This is what the Omarchy About window runs:

omafetch about

Replace Omarchy's omarchy-launch-about (fastfetch) with omafetch, without changing the menu item itself:

omafetch bind

bind writes ~/.local/bin/omarchy-launch-about, writes ~/.config/hypr/omafetch.lua (PATH so the wrapper wins, plus a 724×714 float for org.omarchy.omafetch), and adds require("hypr.omafetch") to ~/.config/hypr/hyprland.lua. After that, menu About, omarchy launch about, and Style → About all open omafetch. Restart the Omarchy shell if an already-running session still opens fastfetch.

omafetch unbind

unbind removes the wrapper, the Hyprland drop-in, and the require line.

Default fetch with local addresses and mount paths stripped, for sharing:

omafetch public

List available modules:

omafetch list

Show compact Omarchy identity context plus requested modules:

omafetch cpu memory shell

Explicit module output always keeps core identity context first:

omarchy
theme
host
os
kernel
wm

Then it appends requested modules in the order provided, without duplicates.

Output

• The Buck art uses terminal-theme ANSI colors.
• Labels are muted; values use normal foreground plus selective highlights.
• Long values are terminal-width aware and stay single-line unless a module deliberately emits continuation lines.
• kernel-config and disk use aligned multi-line values.
• The left-side sparkle field is deterministic: each sparkle row is encoded from that row's module/value.
• Unicode sparkles are used in UTF-8 locales: · ✦ ✧ ✶; ASCII fallback is . + *.

Modules

Current modules include:

omarchy
omarchy-source
omarchy-channel
omarchy-updated
theme
host
os
os-age
kernel
kernel-config
wm
terminal
font
shell
display
cpu
gpu
gtt-memory
memory
swap
disk
rootfs
battery
localip
packages
uptime

Default output renders the full module order. Unavailable battery and gtt-memory are skipped in default output when they would be unknown, but can still be requested explicitly.

Release Artifacts

GitHub Actions builds release artifacts for Linux x86_64. Pushing a v* tag creates a GitHub Release with:

omafetch-<version>-x86_64-unknown-linux-gnu.tar.gz
omafetch-<version>-x86_64-unknown-linux-gnu.tar.gz.sha256

Development

Run validation:

cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test
cargo run
cargo run -- cpu memory shell
cargo run -- list
cargo run -- about

Packaging

install.sh downloads the GitHub Release tarball, verifies the published sha256, installs omafetch, and writes the omarchy-launch-about wrapper next to it. omafetch bind is still required so Hyprland prefers that wrapper over Omarchy's copy.

The wrapper source also lives at:

packaging/omarchy-launch-about

A starter Arch package recipe lives at:

packaging/PKGBUILD

It builds the release binary and installs:

/usr/bin/omafetch
/usr/share/doc/omafetch/README.md
/usr/share/licenses/omafetch/LICENSE

Community

Use common sense and decency. There is no formal code of conduct. We reserve the right to moderate this community to the extent of the law and the policy of the host. Write community@modoterra.xyz if you need us.

License: MIT, Copyright (c) 2026 Modoterra Corporation.