Gold Fastfetch Config

A feature-rich, self-contained Fastfetch configuration installer for Arch Linux.

⚡ Quick Install

One-line command (safe & easy):

bash <(curl -sL https://raw.githubusercontent.com/Lucenx9/gold-fastfetch/main/install.sh)

Features

• Auto GPU detection - Nvidia (VRAM & Temp), AMD/Intel support
• Auto disk detection - Filesystem labels, colored progress bars (excludes network drives)
• Update checker - Cached pacman + AUR (Yay/Paru) update counts
• Icon toggle - Auto-detects Nerd Fonts, with manual override
• Smart backups - Automatic backup rotation (keeps last 5)
• Media Ready - Shows Now Playing & Player status (Spotify, VLC, etc.)
• Gaming Ready - Detects connected Gamepads/Controllers
• Battery Status - Shows battery percentage and charging status (for laptops)
• XDG compliant - Uses standard config/state/cache paths

Compatibility

• OS: Optimized for Arch Linux (pacman needed for repo updates).
• AUR: Auto-detects yay or paru for AUR update counts.
• Terminal: Requires a Nerd Font for icons (optional).
• GPU: Detailed stats (VRAM/Temp) supported on NVIDIA. Intel/AMD show model/shared status.

Requirements

• Fastfetch v2+
• pciutils (for lspci)
• pacman-contrib (highly recommended for update detection)
• Nerd Font (recommended for icons)

sudo pacman -S fastfetch pciutils pacman-contrib

Installation

git clone https://github.com/Lucenx9/gold-fastfetch.git
cd gold-fastfetch
chmod +x install.sh
./install.sh

Options

./install.sh --icons      # Force icons ON
./install.sh --no-icons   # Force icons OFF

What Gets Installed

File	Location	Description
config.jsonc	~/.config/fastfetch/	Main config
gpu_detect.sh	~/.config/fastfetch/scripts/	GPU detection script
disk_detect.sh	~/.config/fastfetch/scripts/	Disk detection script
updates.sh	~/.config/fastfetch/scripts/	Update checker (cached)

Reset / Uninstall

To remove the configuration and restore your previous backup:

chmod +x uninstall.sh
./uninstall.sh

Backups

Existing configs are backed up to:

~/.local/state/fastfetch/backups/backup_YYYYMMDD_HHMMSS/

Only the last 5 backups are kept.

License

MIT

Technical Details 🛠️

🚀 Smart Caching (updates.sh)

• Problem: Running checkupdates or yay on every term launch is slow.
• Solution: The script creates a cache file with a 30-minute TTL.
• Smart Invalidation: It checks /var/lib/pacman/local. If you update your system, the cache is instantly invalidated, ensuring you always see real-time data without performance penalties.

💾 Dynamic Disk Detection (disk_detect.sh)

• Problem: Hardcoding disk paths (/, /home) fails on multi-drive setups.
• Solution: The script uses findmnt to dynamically discover real physical partitions.
• Filtering: Automatically excludes pseudo-filesystems (tmpfs, overlay, /boot, /run).
• Visuals: Generates color-coded storage bars directly in Bash.

⚡ Installation Logic

1. Safety First: Checks for root (blocks execution), verifies Arch Linux via /etc/arch-release.
2. Backups: Automatically backs up existing configs to ~/.local/state/fastfetch/backups/.
3. Generation: The .jsonc config is generated at runtime, allowing it to inject variables (like Icons ON/OFF) based on your choices.