GitHub statistics in fastfetch style — clean, minimal, terminal-first

🇷🇺 Русский | 🇬🇧 English

📸 Screenshots

✨ Features

• 🔥 No token required — uses public GitHub API
• 📦 30-minute cache — saves API limits
• 🎨 Fastfetch-style layout — clean ASCII art logo
• 📁 Fully configurable — customize via JSON
• 🐧 Cross-platform — Linux, macOS, WSL
• 🎯 Zero dependencies — only Python + requests

🚀 Installation

One-liner (recommended)

git clone https://github.com/rud1x/gitfetch.git && cd gitfetch && chmod +x install.sh && ./install.sh

Manual installation

git clone https://github.com/rud1x/gitfetch.git
cd gitfetch
chmod +x install.sh
./install.sh

Uninstall

./uninstall.sh

📖 Usage

# Register your username (one time)
gitfetch --reg rud1x

# Run with registered username
gitfetch

# Run for specific user
gitfetch torvalds

# Force refresh (ignore cache)
gitfetch --no-cache

# Clear cache
gitfetch --clear-cache

# Show help
gitfetch --help

🎨 Customization

Edit ~/.config/gitfetch/config.json to change colors and layout.

Available colors

Name	Code	Name	Code
black	30	bright_red	91
red	31	bright_green	92
green	32	bright_yellow	93
yellow	33	bright_blue	94
blue	34	bright_magenta	95
magenta	35	bright_cyan	96
cyan	36	bright_white	97
white	37	gray	90
orange	208	purple	95

Example config

{
  "logo": { "color": "orange" },
  "sections": [
    {
      "type": "line",
      "template": "Stars: {value}",
      "label_color": "cyan",
      "value_color": "yellow"
    }
  ]
}

📦 Dependencies

• Python 3.7+
• requests (installed automatically)

Manual install per distro

Distro	Command
Arch / CachyOS	sudo pacman -S python-requests
Debian / Ubuntu	sudo apt install python3-requests
Fedora	sudo dnf install python3-requests
macOS	brew install python3 && pip3 install requests

📝 License

MIT © rudix

⭐ Show your support

Give a ⭐️ if this project helped you!

---

Made with ❤️ by rudix