🧠 LeenFetch

A fast, minimal, and customizable system information tool built in Rust — your alternative to Neofetch, for real power users. Includes JSON output and remote fetching over SSH.

⚠️ LeenFetch is under active development. Expect bugs and improvements regularly!

Want to help? Contributions, testing, and feedback are always welcome!

💬 Feedback & Issues

Found a bug? Got a feature idea?
Head over to the issues or join the discussions page!

📚 Table of Contents

🧠 LeenFetch - A fast, minimal, and customizable system information tool built in Rust — your alternative to Neofetch, for real power users.

📸 Screenshots

🚀 Features

⚡ Blazing fast startup thanks to Rust
🎨 Customizable output layout with colorized terminal output
🧩 Modular design — enable or disable components via config
💾 Smart defaults but easily extendable
📦 Detects installed packages, shell, GPU, DE/WM, and more
🖼️ Custom ASCII art support and override via config
🎨 Supports theme-based color profiles (ascii_colors=distro, etc.)
🔌 Single JSONC config: ~/.config/leenfetch/config.jsonc
🧵 Accepts piped ASCII input — use fortune | cowsay | leenfetch for dynamic text logos
🌐 Fetch remote system info over SSH (--ssh <user>@<host>:<port>...) and reuse pretty output per host
🧾 Machine-readable JSON output via --format json for scripting and dashboards

▨ Packaging Status

📦 Installation

Install on Arch Linux (via AUR)

If you're on Arch Linux or an Arch-based distribution (like Manjaro), you can install LeenFetch from the AUR using an AUR helper like yay:

yay -S leenfetch

or

git clone https://aur.archlinux.org/leenfetch.git
cd leenfetch
makepkg -si

Install on Debian / Ubuntu (via .deb)

If you're on Debian, Ubuntu, or a Debian-based distribution, you can download and install the .deb package from the GitHub Releases:

AMD64 (x86_64)

wget https://github.com/drunkleen/leenfetch/releases/download/v1.1.0/leenfetch-v1.1.0-debian-x86_64.deb
sudo dpkg -i leenfetch-*.deb

AArch64 (ARM64)

wget https://github.com/drunkleen/leenfetch/releases/download/v1.1.0/leenfetch-v1.1.0-debian-aarch64.deb
sudo dpkg -i leenfetch-*.deb

Install on Fedora / RHEL (via .rpm)

If you're using Fedora, RHEL, or another RPM-based distro, you can install LeenFetch using the .rpm file from GitHub Releases:

AMD64 (x86_64)

wget https://github.com/drunkleen/leenfetch/releases/download/v1.1.0/leenfetch-v1.1.0-REHL-x86_64.rpm
sudo rpm -i leenfetch-*.rpm

AArch64 (ARM64)

wget https://github.com/drunkleen/leenfetch/releases/download/v1.1.0/leenfetch-v1.1.0-REHL-aarch64.rpm
sudo rpm -i leenfetch-*.rpm

Install on Windows (via .zip)

If you're on Windows, download the latest .zip from the GitHub Releases:

powershell:

AMD64 (x86_64)

Invoke-WebRequest -Uri "https://github.com/drunkleen/leenfetch/releases/download/v1.1.0/leenfetch-v1.1.0-windows-x86_64.zip" -OutFile "leenfetch-win.zip"
Expand-Archive .\leenfetch-win.zip -DestinationPath .

.\leenfetch-v1.1.0-windows-x86_64.exe

AArch64 (ARM64)

Invoke-WebRequest -Uri "https://github.com/drunkleen/leenfetch/releases/download/v1.1.0/leenfetch-v1.1.0-windows-aarch64.zip" -OutFile "leenfetch-win.zip"
Expand-Archive .\leenfetch-win.zip -DestinationPath .

.\leenfetch-v1.1.0-windows-aarch64.exe

Make sure you're in the same directory as leenfetch.exe when running the command.

🛠️ Manual Installation (Build from Source)

git clone https://github.com/drunkleen/leenfetch.git
cd leenfetch
cargo build --release

Add to PATH:

cp target/release/leenfetch ~/.local/bin/

Then run:

leenfetch

Install from crates.io (fallback)

If you prefer installing from crates.io, make sure you have Rust & Cargo installed:

cargo install leenfetch

After that, just run:

leenfetch

If you hit issues with PATH, try adding ~/.cargo/bin to your shell:

export PATH="$HOME/.cargo/bin:$PATH"

📥 Using Piped Input

LeenFetch can accept piped input to use as the ASCII logo.

This allows you to create dynamic, fun logos on the fly using other command-line tools.

Examples:

echo "Rustacean" | leenfetch

fortune | cowsay | leenfetch

LeenFetch will detect piped input via stdin and render the ASCII art above your system information.

If no piped input is provided, it will fall back to your configured or auto-detected ASCII art.

🌐 Remote fetch over SSH

Query other machines directly and render their info locally. LeenFetch runs leenfetch --format json over SSH, parses it, and prints a pretty block for each host.

# Pretty output for one host (leverages your SSH config/agent)
leenfetch --ssh user@server.example.com
leenfetch --ssh user@server.example.com:port

# Multiple hosts
leenfetch --ssh user@server1 --ssh user@server2:port ...

# Script-friendly JSON
leenfetch --ssh user@server --format json
leenfetch --ssh user@server:port --format json

Notes:

The remote host needs leenfetch installed and available in PATH.
ASCII logo and colors reflect the remote distro; each host renders separately using the local layout.
SSH options come from your standard SSH config/agent (no custom flags are parsed) and a short connect timeout is used.
You can mix --format json with --ssh to script against multiple hosts (one JSON object per host).

⚙️ Configuration

On first run, LeenFetch writes a single config.jsonc file to your configuration directory:

# Linux
~/.config/leenfetch/config.jsonc

# Windows
C:\Users\<username>\AppData\Roaming\leenfetch\config.jsonc

The file uses JSON with comments (JSONC), so you can keep inline explanations next to your settings. It combines the previous trio of files into a single document with clear sections:

flags — Display and formatting toggles.
modules (alias layout) — Output order, headings, and custom rows.
(optional) logo — Override ASCII art source or padding. Omitted keys fall back to defaults.

flags section

The flags object fine-tunes how each block is rendered. Values shown below match the generated defaults; unset keys fall back to the same defaults internally.

Key	Allowed values	Default	What it controls
`ascii_distro`	`"auto"` or distro name	`"auto"`	ASCII art selection. Piped input always overrides this.
`ascii_colors`	`"distro"` or comma list of color indices	`"distro"`	Palette for ASCII art and color swatches.
`custom_ascii_path`	`""` or path	`""`	Custom ASCII art file. Leave empty for bundled art.
`battery_display`	`"off"`, `"bar"`, `"infobar"`, `"barinfo"`	`"off"`	Battery meter style (or disable entirely).
`color_blocks`	string glyph	`"●"`	Character(s) used for the 16-color preview.
`cpu_brand`	`true` / `false`	`true`	Prefix CPU model with the vendor name.
`cpu_cores`	`true` / `false`	`true`	Show total core/thread counts.
`cpu_frequency`	`true` / `false`	`true`	Include advertised CPU frequency.
`cpu_speed`	`true` / `false`	`true`	Include current CPU speed reading.
`cpu_temp`	`"C"` / `"F"`	`"C"`	Temperature unit. Any other value skips conversion.
`cpu_show_temp`	`true` / `false`	`false`	Toggle CPU temperature output entirely.
`de_version`	`true` / `false`	`true`	Append desktop-environment version.
`distro_display`	`name`, `name_version`, `name_arch`, `name_model`, `name_model_version`, `name_model_arch`, `name_model_version_arch`	`"name"`	Level of OS detail shown in the distro line.
`disk_display`	`info`, `percentage`, `infobar`, `barinfo`, `bar`	`"info"`	Disk usage presentation for each mount.
`disk_subtitle`	`name`, `dir`, `none`, `mount`	`"dir"`	Label used alongside disk usage.
`memory_percent`	`true` / `false`	`true`	Add percentage to the memory line.
`memory_unit`	`kib`, `mib`, `gib`	`"mib"`	Preferred memory units.
`package_managers`	`off`, `on`, `tiny`	`"tiny"`	Package counter verbosity.
`refresh_rate`	`true` / `false`	`true`	Append monitor refresh rate where available.
`shell_path`	`true` / `false`	`false`	Print full shell path instead of name only.
`shell_version`	`true` / `false`	`true`	Append shell version.
`uptime_shorthand`	`full`, `tiny`, `seconds`	`"tiny"`	Uptime formatting style.
`os_age_shorthand`	`full`, `tiny`, `seconds`	`"tiny"`	OS install age formatting style.

ℹ️ Piped input (for example fortune | cowsay | leenfetch) replaces the ASCII logo regardless of ascii_distro or custom_ascii_path.

Here is a compact example that shortens durations and hides temperature and refresh-rate extras:

{
  "flags": {
    "uptime_shorthand": "tiny",
    "cpu_show_temp": false,
    "refresh_rate": false,
    "package_managers": "on"
  }
}

logo section (optional)

Use the logo object to point to custom ASCII art or adjust how the bundled ASCII art is padded. When type is "file" the source path behaves just like custom_ascii_path.

{
  "logo": {
    "type": "file",
    "source": "~/.config/leenfetch/branding/about.txt",
    "padding": { "top": 2, "right": 6, "left": 0 }
  }
}

modules array

The modules array (also accepted as layout) controls rendering order. Entries can be a literal string ("break" inserts an empty spacer) or an object describing a module. Objects accept a type (collector name such as titles, distro, os_age, uptime, etc.) and optional properties like key for the label or format for custom text.

{
  "modules": [
    "break",
    { "type": "custom", "format": "== System ==" },
    { "type": "titles", "key": "User" },
    { "type": "distro", "key": "Distro" },
    { "type": "cpu", "key": "CPU" },
    { "type": "memory", "key": "Memory" },
    { "type": "colors", "key": "" }
  ]
}

Rearrange, duplicate, or remove entries to customize your output. Insert "break" wherever you want an empty spacer line.

How to Edit

Open config.jsonc in your favorite text editor.
Read the inline comments for a full explanation of every option.
Change values as you like, save, and re-run leenfetch to see your changes.

For advanced details, see the comments in config.jsonc or check the wiki (if available).

CLI overrides

Need a temporary tweak for screenshots or testing? LeenFetch now mirrors most flags settings on the CLI so you can adjust the output without touching config.jsonc.

Core controls: --help, --version, --list-options, --init, --reinit, --config <path>, and --no-config (ignore files, use built-in defaults).
ASCII controls: --ascii_distro <name>, --ascii_colors <list>, --custom_ascii_path <file>, and --color-blocks <glyph>.
Formatting knobs: --battery-display, --disk-display, --disk-subtitle, --memory-unit, --packages, --uptime, --os-age, --distro-display, --cpu-temp-unit, and --format <pretty|json> for output style.
Remote + layout: --ssh <host>[,<host>...] to fetch via SSH, --only cpu,memory,shell to render a subset, --hide gpu to drop modules from the current layout.
Boolean toggles come in pairs—use --cpu-speed / --no-cpu-speed, --shell-path / --no-shell-path, --memory-percent / --no-memory-percent, etc., for quick on/off control of individual fields.

Run leenfetch --help to see the complete list of overrides.

🎯 Roadmap

Feature	Status
Base module system	✅ Done
Config file loader	✅ Done
Custom layout tags	✅ Done
GPU/CPU/Mem/DE/WM detection	✅ Done
Linux support	✅ Done
Windows support	✅ Done
Multi-Threading	✅ Done
CLI override options	🔁 Basic
ASCII art & theming	🔁 Basic
Plugin/module system	❓ Maybe
Fetch info over SSH	✅ Done

🤝 Contributing

Fork the repo
Create your branch (git checkout -b feature/my-feature)
Commit your changes (git commit -m 'feat: add my feature')
Push to the branch (git push origin feature/my-feature)
Create a Pull Request

We welcome clean PRs and documented modules! ✨

☕ Support LeenFetch

If you have found LeenFetch valuable and would like to contribute to its ongoing development, your support is greatly appreciated. You can show your appreciation by making a donation through PayPal or any of the following cryptocurrency networks:

Bitcoin (BTC): bc1qsmvxpn79g6wkel3w67k37r9nvzm5jnggeltxl6
ETH/BNB/MATIC (ERC20, BEP20): 0x8613aD01910d17Bc922D95cf16Dc233B92cd32d6
USDT/TRON (TRC20): TGNru3vuDfPh5zBJ31DKzcVVvFgfMK9J48
Dogecoin (DOGE): D8U25FjxdxdQ7pEH37cMSw8HXBdY1qZ7n3

Your generous contribution ensures the continued improvement and maintenance of LeenFetch. ❤️

Thank you for supporting the project! 🙏

📄 License

💡 Inspiration

Neofetch
Fastfetch
Rust — the foundation of LeenFetch

Name		Name	Last commit message	Last commit date
Latest commit History 94 Commits
.cargo		.cargo
.github		.github
assets		assets
src		src
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
Cross.toml		Cross.toml
LICENSE		LICENSE
PKGBUILD		PKGBUILD
README.md		README.md
compare_with_neofetch.sh		compare_with_neofetch.sh
leenfetch.1		leenfetch.1
leenfetch.1.md		leenfetch.1.md
leenfetch.spec		leenfetch.spec
manual.md		manual.md

Uh oh!

License

drunkleen/leenfetch

Folders and files

Latest commit

History

Repository files navigation

🧠 LeenFetch

A fast, minimal, and customizable system information tool built in Rust — your alternative to Neofetch, for real power users. Includes JSON output and remote fetching over SSH.

💬 Feedback & Issues

📚 Table of Contents

📸 Screenshots

🚀 Features

▨ Packaging Status

📦 Installation

Install on Arch Linux (via AUR)

Install on Debian / Ubuntu (via .deb)

Install on Fedora / RHEL (via .rpm)

Install on Windows (via .zip)

🛠️ Manual Installation (Build from Source)

Install from crates.io (fallback)

📥 Using Piped Input

🌐 Remote fetch over SSH

⚙️ Configuration

flags section

logo section (optional)

modules array

How to Edit

CLI overrides

🎯 Roadmap

🤝 Contributing

☕ Support LeenFetch

📄 License

💡 Inspiration

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 10

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Languages

Packages