# purefetch
[](https://github.com/ooonea/purefetch/actions/workflows/ci.yml)
[](https://crates.io/crates/purefetch)
[](#license)
A small, fast system-information tool — a [fastfetch](https://github.com/fastfetch-cli/fastfetch)-style
fetcher written **entirely in Rust with zero external crates**.
No `libc`, no `sysinfo`, no `nix`, no color crate — nothing from crates.io.
On **Linux**, the handful of syscalls that have no `std` wrapper (`statfs`,
`ioctl` for the terminal size / tty check, `kill` for command process groups)
are issued directly as raw syscalls
(x86_64, aarch64, riscv64 and loongarch64) via `core::arch::asm!`; everything
else is `std` plus parsing of `/proc` and `/sys`. On **macOS**, where raw
syscalls are not a stable ABI, the same platform layer binds `extern "C"`
straight to libSystem (statfs, sysctl, mach VM statistics, libproc) — which
Rust's `std` already links — so the crate stays free of external dependencies
there too. It builds offline and has a trivial dependency graph.
<p align="center"><img src="assets/purefetch.svg" alt="purefetch running on Debian" width="680"></p>
```
_,met$$$$$gg. ooonea@unicorn
,g$$$$$$$$$$$$$$$P. ──────────────
,g$$P" """Y$$.". OS Debian GNU/Linux 13.5 (trixie) x86_64
,$$P' `$$$. Host ThinkPad P53 (20QQS0JD01)
',$$P ,ggs. `$$b: Kernel 6.12.94+deb13-amd64
`d$$' ,$P"' . $$$ Uptime 6 days, 14 hours, 21 mins
$$P d$' , $$P Packages 2422 (dpkg), 1 (flatpak)
$$: $$. - ,d$$' Shell zsh 5.9
$$; Y$b._ _,d$P' Display 1920x1080 (eDP-1)
Y$$. `.`"Y$$$$P"' DE GNOME 48.7
`$$b "-.__ WM Mutter (Wayland)
`Y$$ Terminal kitty 0.41.1
`Y$$. CPU Intel(R) Core(TM) i7-9850H @ 4.60 GHz
`$$b. GPU Quadro RTX 3000
`Y$$b. Memory 15.46 GiB / 62.61 GiB (25%)
`"Y$b._ Swap 0 B / 8.00 GiB (0%)
`""" Disk (/) 8.16 GiB / 491.48 GiB (2%)
Locale en_US.UTF-8
Battery 76% (Not charging)
```
## Install
With a Rust toolchain (1.70+):
```sh
cargo install purefetch
```
Or straight from the repo (latest `main`):
```sh
cargo install --git https://github.com/ooonea/purefetch
```
Or build from source:
```sh
git clone https://github.com/ooonea/purefetch
cd purefetch
cargo build --release
./target/release/purefetch
# optional: install to ~/.cargo/bin
cargo install --path .
```
### With Nix
```sh
nix run github:ooonea/purefetch
```
Or add the flake as an input and use `purefetch.packages.${system}.default`
(built for `x86_64-linux`, `aarch64-linux`, `aarch64-darwin` and
`x86_64-darwin`; there is also an `overlays.default`).
Targets **Linux** on **x86_64**, **aarch64**, **riscv64**, and **loongarch64**,
and **macOS** (Apple Silicon and Intel).
## Usage
```
purefetch [OPTIONS]
-l, --logo <NAME> logo: auto (default), or a distro name (see below)
--logo-file <PATH> use a custom logo, read verbatim from a file
--logo-exec <CMD> use a custom logo from a command's output (dynamic)
--modules <LIST> comma-separated modules to show ('-' = separator)
--exec <LABEL:CMD> add a custom line from a shell command (ref in --modules)
--config <PATH> read options from PATH
--no-config ignore any config file
--no-logo do not print any logo
--no-color disable ANSI colors
--no-color-blocks hide the trailing ANSI color blocks
-V, --version print version and exit
-h, --help print this help and exit
```
Colors are disabled automatically when stdout is not a terminal (or when
`NO_COLOR` is set), so `purefetch | cat` produces clean, unstyled text.
Bundled logos: `arch`, `ubuntu`, `fedora`, `debian`, `mint`, `manjaro`, `pop`,
`opensuse`, `alpine`, `void`, `nixos`, `gentoo`, `endeavouros`, `kali`,
`elementary`, `zorin`, `artix`, `rocky`, `almalinux`, `centos`, `devuan`, `mx`,
`garuda`, `macos` (alias `apple`), `tux` (and `none`). `auto` picks one from
`/etc/os-release` on Linux (falling back to `tux`) and always the Apple logo
on macOS.
## Configuration
Any option can also live in a config file — one `key value` per line — so plain
`purefetch` reproduces your setup (a login banner and an interactive prompt then
show the same thing):
```
# ~/.config/purefetch/config
logo-exec /home/me/.config/purefetch/gen-logo.sh
no-color-blocks
modules os,host,kernel,-,cpu,memory,swap,-,shell
exec Pool:zpool list -H -o health,cap zroot
```
purefetch reads `$PUREFETCH_CONFIG`, then `~/.config/purefetch/config`, then
`/etc/purefetch/config`. Command-line flags override the file; `--no-config`
ignores it.
Repeated `exec` labels are case-insensitive; the last definition wins, including
when a command-line definition replaces one from the config file.
External commands (including `exec` and `logo-exec`) have a two-second deadline;
failed or timed-out commands produce no data.
## Detected info
`Title (user@host)`, `OS`, `Host`, `Kernel`, `Uptime`, `Packages`, `Shell`,
`Display`, `DE`, `WM`, `Terminal`, `CPU`, `GPU`, `Memory`, `Swap`, `Disk (/)`,
`Locale`, `Battery`, and the ANSI color blocks. Any module whose data is
unavailable (e.g. `Battery` on a desktop, `Swap` with no swap) is silently
skipped.
## Notable details
- **Zero dependencies.** The whole tool is `std` + the platform layer in
`src/sys/` (raw syscalls on Linux, libSystem FFI on macOS).
- **ZFS-aware.** `Memory` is `MemTotal - MemAvailable` (matching `free`/htop) — the
ARC counts as used because it genuinely occupies RAM. On a ZFS root, `Disk` reports
the whole pool via `zpool list` (labelled `Disk (<pool>)`), not just the root
dataset's few GiB.
- **macOS semantics match the natives.** `Memory` follows `vm_stat`/Activity
Monitor (total minus really-free and file-backed pages), `Disk (/)` reports
the shared APFS container with used = total - available (like fastfetch),
`Display` lists native pixels via CoreGraphics, and `Host` shows the device
tree's marketing name over the board id — no model lookup table to age.
- **Process-parent detection.** `Shell` and `Terminal` walk the parent chain
(`/proc/<pid>/stat`+`comm` on Linux, `proc_pidinfo` on macOS), with
environment-variable fallbacks (`$TERM`, `$TERM_PROGRAM`,
`$KITTY_WINDOW_ID`, ...) for the terminal.
- **Best-effort detection.** Missing data drops its line; external command
probes time out after two seconds.
## Architecture
```
src/
main.rs arg parsing, module ordering, title/separators/color blocks, dispatch
sys/
mod.rs platform-layer API (disk_usage, term_width, hostname, ppid_comm, ...)
linux.rs raw Linux syscalls (x86_64, aarch64, riscv64, loongarch64): statfs, ioctl, kill
darwin.rs libSystem FFI: statfs, sysctl, mach VM stats, libproc, CoreGraphics
util.rs file helpers, subprocess helper, byte/percent formatting
color.rs ANSI palette
logo.rs OS ASCII logos + selection (generated by examples/genlogos.rs)
render.rs logo-left / info-right layout, ANSI-aware width & truncation
detect/
mod.rs Row/Rows contract + module registry
*.rs one module per info line (os, cpu, gpu, memory, ...), cfg-split per OS
```
Adding an info source is one file: implement
`pub fn detect() -> crate::detect::Rows` in `src/detect/<name>.rs` and register
it in `src/main.rs`. Adding a distro logo is one text file in `assets/logos/`
followed by `cargo run --example genlogos`.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). New distro logos, more package managers,
extra info modules, and support for other CPU architectures are all welcome —
please keep the zero-dependency rule and run `cargo fmt` before submitting.
## Disclosure
purefetch was built largely with **AI assistance** (Claude Code). The design was
human-directed and every change was reviewed and tested — including running the
tool on all four supported architectures under QEMU — but most of the code is
AI-generated. Noting it openly so you know how it was made.
## Credits
The bundled distribution logos are taken from **fastfetch** (which builds on
**neofetch**'s logo set); both are MIT-licensed. Full attribution and the MIT
notices are in [CREDITS.md](CREDITS.md). The distro logos are trademarks of their
respective projects, used nominatively only to identify the OS being reported.
## License
Licensed under either of
- MIT license ([LICENSE-MIT](LICENSE-MIT))
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE))
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.