X 000 · Y 000

Fig. 01 — Overview

Your system.
Looking good.
No config pain.

zfetch is a fast, good-looking system fetch tool written in Rust. Built-in TUI config editor, nine themes, custom ASCII and image art support, TOML config, and terminal-adaptive layout. No manual config file editing required.

View on GitHub → Releases

zfetch — terminal

you@host:~$ zfetch

OS Ferret Norix-OS x86_64

Kernel 6.12.0-ferret

Uptime 3h 42m

CPU AMD Ryzen 9 7950X (32) @ 5.7GHz

GPU NVIDIA RTX 4090

Memory 4.2 GiB / 64.0 GiB

Shell fish 3.7.1

WM niri

you@host:~$ █

Fig. 02 — CLI Reference

Command line flags.

Simple, explicit, no surprises.

-o, --os [name]

Display OS-specific art. Optionally force a specific OS logo — e.g. --os arch

-i, --image [path]

Display an image instead of ASCII art using the Kitty graphics protocol. Optionally specify an image path

-c, --config

Launch the built-in TUI configuration editor — no manual file editing needed

-r, --refresh

Force refresh of cached values — OS name and GPU detection

-u, --update

Update config file to the latest version while preserving all your existing settings

Fig. 03 — Configuration

TOML, or just use the TUI.

Config lives at ~/.config/zfetch/config.toml — created automatically on first run. Edit it directly or launch zfetch --config and never touch a file.

~/.config/zfetch/config.toml

# display

[display]

os_art = true

art_position = "left"

box_style = "rounded"

nerd_fonts = true

# theme & colors

[colors]

theme = "catppuccin"

# what to show

[core]

os = true kernel = true uptime = true

[hardware]

cpu = true gpu = true memory = true

[userspace]

shell = true wm = true terminal = true packages = true

Fig. 03a — Install

you@host:~/zfetch-rs$ cargo install --path .

# or grab the precompiled binary from the releases page

Fig. 04 — Built-in Themes

Nine themes, zero setup.

Set theme = "name" in your config or pick one in the TUI. Switch anytime.

default

follows your terminal colors

dracula

purple · pink · dark

catppuccin

pastel · warm · soft

nord

arctic · cool blue · minimal

gruvbox

retro · warm · earthy

eldritch

dark · eerie · green

kanagawa

japanese ink · deep blue

tokyonight

neon · city · dark blue

onedark

atom · balanced · clean

Your system.Looking good.No config pain.

Command line flags.

TOML, or just use the TUI.

Nine themes, zero setup.

Your system.
Looking good.
No config pain.