🚀 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.

⚙️ 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.5"

🛠️ 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);
}

Dependencies

If u're using getTerm, u need to make sure xprop is installed.

For GPU and disk information, I use standard Linux tools like lspci (from pciutils) and df (from coreutils).

F-Fetch Configuration & Examples

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.

• getBoardVendor, getBoardName and getBoardVersion
  Returns your system motherboard informations. (e.g, MSI)

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 all.reset " ─────────────────────────╮"
echo "│  " t.underline fg.bright_red " System Information :"
echo "│    " fg.white t.bold " OS: " all.reset fg.green getOsName " " t.italic fg.yellow t.bold getArch
echo "│    " fg.white t.bold "󰇅 Host: " all.reset fg.green getBoardName " " (getBoardVersion)
echo "│    " fg.white t.bold " Kernel: " all.reset fg.green getKernel
echo "│    " fg.white t.bold " Hostname: " all.reset fg.green getHostname
echo "│    " fg.white t.bold " Packages: " all.reset fg.green getPackages
echo "│    " fg.white t.bold " Locale: " all.reset fg.green getLocale
echo "│    " fg.white t.bold " Init: " all.reset fg.green getInit
echo "│    " 
echo "│  " t.underline fg.bright_green "󰋊 Hardware Information :"
echo "│    "
echo "│    " fg.yellow t.bold " CPU: " all.reset fg.white getCpu
echo "│    " fg.yellow t.bold "󰍹 GPU: " all.reset fg.white getGpu
echo "│    " fg.yellow t.bold " Memory: " all.reset fg.white getMemory fg.yellow " MB"
echo "│    " fg.yellow t.bold " Root: " all.reset fg.white getDisk(/)
echo "│    "
echo "│  " t.underline fg.bright_blue " Desktop Information :"
echo "│    "
echo "│    " fg.magenta t.bold "󰪫 DE/WM: " all.reset fg.white getDesktop " " (getBackend)
echo "│    " fg.magenta t.bold " Uptime: " all.reset fg.white getUptime
echo "│    " fg.magenta t.bold "󰧨 Primary: " all.reset fg.white getMonitor(0)
echo "│    " fg.magenta t.bold " Shell: " all.reset fg.white getShell
echo "╰──────────────────────────────────────────────╯"

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

# ⚡ 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"

☕ Support the project

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

👉 https://buymeacoffee.com/oled