🚀 F-Fetch: Fast, Minimal & Rust-Powered System Fetcher 🦀✨

F-Fetch is a very fast, minimal terminal system fetcher written 100% in Rust.
It is highly customizable — allowing you to add your own syntax and integrate your own features.
At its core, it works simply and the codebase is easy to understand. 💡

F-Fetch Components List

• getUsername
  Returns the current Username.

• getKernel
  Returns the Kernel Version.

• getCpu
  Returns CPU Information.

• getMemory
  Returns Memory Usage.

• getHostname
  Returns the system Hostname.

• getOsName
  Returns the Operating System Name.

• getDesktop
  Returns the Desktop Environment or Window Manager.

• getArch
  Returns the system Architecture (e.g., x86_64).

• getPlatform
  Returns the system Platform information.

• getUptime
  Returns the system Uptime.

• getTerm
  Returns the current Terminal Emulator.

• getGpu
  Returns the primary GPU Information.

• getMGpu
  Returns the secondary GPU Information (if any).

• getShell
  Returns the current Shell.

• getDisk(mountpoint)
  Returns the Disk Usage information for the specified mount point.

• getMonitor(monitorindex)
  Returns the Monitor information for the specified monitor index.

• getPackages (emerge, flatpak, apt, dnf, yum, pacman, zypper, nix-env, xbps-query)
  Returns the number of installed packages.

• getLocale
  Returns your system locale (e.g., en_US).

• getTerm
  Returns your terminal emulator.

• getBackend
  Returns your windowing system.

• getInit
  Returns your system init (e.g, runit-init).

• getQT or getGTK
  Returns your theme from environment variables.

F-Fetch Style ANSI Color Codes Reference

🎨 Foreground Colors (Text Colors)

✨ Bright Foreground Colors

🎭 Background Colors

🌟 Bright Background Colors

📝 Text Styles

🔄 Reset

🛠️ F-Fetch Configuration Examples

(Advanced, Middle, Minimal)

# 🌟 Advanced config
echo "╭───────────── " t.underline t.bold fg.yellow getUsername
echo "│  " t.underline " System Information :"
echo "│    " fg.blue " OS: " fg.cyan getOsName " " t.italic fg.yellow t.bold getArch
echo "│    " fg.blue " Kernel: " fg.black getPlatform " " fg.green getKernel
echo "│    " fg.blue " Hostname: " fg.cyan getHostname
echo "│    " fg.blue " Packages: " fg.cyan getPackages
echo "│    " fg.blue " Locale: " fg.cyan getLocale
echo "│    "
echo "│  " t.underline "󰋊 Hardware Information :"
echo "│    "
echo "│    " fg.yellow " CPU: " fg.white t.bold getCpu
echo "│    " fg.yellow "󰍹 GPU: " fg.white t.bold getGpu
echo "│    " fg.yellow " Memory: " fg.white t.bold getMemory fg.yellow " MB"
echo "│    " fg.yellow " Root: " fg.white t.bold getDisk(/)
echo "│    "
echo "│  " t.underline " Desktop Information :"
echo "│    "
echo "│    " fg.magenta "󰪫 DE/WM: " fg.white t.bold getDesktop
echo "│    " fg.magenta " Uptime: " fg.white t.bold getUptime
echo "│    " fg.magenta "󰧨 Primary: " fg.white t.bold getMonitor(0)
echo "│    " fg.magenta " Shell: " fg.white t.bold getShell
echo "│    " fg.magenta " Terminal: " fg.white t.bold getTerm
echo "╰───────────────────────────────╯"

ascii = "/home/getUsername/.config/ffetch/ascii.txt"
ascii_color = "fg.cyan"

# ⚡ Middle config
echo t.bold fg.yellow getUsername fg.black "@" fg.yellow getHostname
echo fg.blue "Distro: " fg.yellow t.bold getOsName
echo fg.blue "Platform: " fg.yellow t.bold getPlatform
echo fg.blue "Kernel: " fg.yellow t.bold getKernel
echo fg.blue "Memory: " fg.yellow t.bold getMemory " MB"
echo fg.blue "CPU: " fg.yellow t.bold getCpu
echo fg.blue "GPU: " fg.yellow t.bold getGpu
echo fg.blue "Packages: " fg.yellow t.bold getPackages
echo fg.blue "Disk: " fg.yellow t.bold getDisk(/)
echo fg.blue "Desktop: " fg.yellow t.bold getDesktop
echo fg.blue "Primary: " fg.yellow t.bold getMonitor(0)
echo fg.blue "Uptime: " fg.yellow t.bold getUptime
echo fg.blue "Terminal: " fg.yellow t.bold getTerm
echo fg.blue "Shell: " fg.yellow t.bold getShell

ascii = "/home/getUsername/.config/ffetch/ascii.txt"
ascii_color = "fg.cyan"

# 🔥 Minimal config
echo getUsername "@" getHostname
echo "Distro: " getOsName
echo "Platform: " getPlatform
echo "Kernel: " getKernel
echo "Memory: " getMemory " MB"
echo "CPU: " getCpu
echo "GPU: "  getGpu
echo "Packages: " getPackages
echo "Disk: " getDisk(/)
echo "Desktop: " getDesktop
echo "Primary: " getMonitor(0)
echo "Terminal: " getTerm
echo "Uptime: "  getUptime
echo "Shell: " getShell

ascii = "/home/getUsername/.config/ffetch/ascii.txt"
ascii_color = "fg.cyan"

⚙️ Installation & Configuration

📦 Install via Cargo

# Install from crates.io
cargo install ffetch

🚀 Installation Script

# Run Installation Script
bash <(curl -s https://raw.githubusercontent.com/0l3d/ffetch/master/install.sh)

🏃 Run F-Fetch

ffetch

📚 Use as Library

You can also use F-Fetch as a library in your Rust projects:

📥 Add to your project

cargo add ffetch

Or add to your Cargo.toml:

[dependencies]
ffetch = "0.5.2"

🛠️ Example Usage

use ffetch::*;

fn main() {
    // Get system information
    let username = get_username();
    let os_name = get_os_name();
    let cpu_info = get_cpu();
    let memory = get_memory();

    println!("User: {}", username);
    println!("OS: {}", os_name);
    println!("CPU: {}", cpu_info);
    println!("Memory: {} MB", memory);
}

☢️ All Possible Problems and Solutions

You're clearly not on Linux:

you are not using linux

Failed to run uname — really? Make sure uname exists:

uname command error

Failed to run uptime — seriously? Check if uptime is available:

uptime command error

Couldn't detect your GPU with lspci. Are you using WSL or something else?

Failed to execute lspci, not found.

Check your ~/.config/ffetch/ffetch.conf file and make sure ascii="" is set correctly:

Failed to read file

Check the getMonitor() function in your configuration. If you're only using one monitor, either remove getMonitor(1) or add your third monitor.

index out of bound

If the disk is not showing up, check getDisk() in the config and make sure it's using a valid mountpoint, like getDisk(/).

☕ Support the project

If you like F-Fetch and want to support the development, consider buying me a coffee:

👉 https://buymeacoffee.com/oled