Hydrafetch

A modern, cross-platform system information fetching tool inspired by neofetch and fastfetch. Built with Node.js/TypeScript for maximum compatibility across macOS, Linux, and Windows.

Features

• ⚡ Fast & Lightweight - Minimal dependencies, instant execution
• 🎨 Customizable Themes - Multiple color schemes (Cyan, Catppuccin, Dracula, Monochrome)
• 📐 Flexible Layouts - Classic side-by-side or minimal top-down
• 🎯 Selective Stats - Show only what you care about
• 🔧 Interactive Setup - First-run wizard for easy configuration
• 🌍 Cross-Platform - Works on Linux, macOS, and Windows

Installation

Quick Install (Recommended)

Run once with npx, then use the built-in installer:

npx @joddabod5scripts/hydrafetch@latest --install

This will globally install the latest version to your system.

Manual Installation

npm install -g @joddabod5scripts/hydrafetch@latest

Run Without Installing

npx @joddabod5scripts/hydrafetch@latest

Usage

First Run

On first execution, you'll be guided through an interactive configuration wizard:

1. Choose Layout - Classic (side-by-side) or Minimal (top-down)
2. Select Color Theme - Default Cyan, Catppuccin, Dracula, or Monochrome
3. Toggle Stats - Show/hide specific system information

Commands

# Run hydrafetch
hydrafetch

# Install globally (if running via npx)
npx @joddabod5scripts/hydrafetch@latest --install

# Reconfigure settings
hydrafetch --config

# Reset to defaults
hydrafetch --reset

System Information Displayed

• OS: Distribution, release, architecture
• Host: Device manufacturer and model
• Kernel: Kernel version
• Uptime: System uptime (formatted)
• Shell: Current shell (bash, zsh, fish, etc.)
• Resolution: Display resolution
• DE: Desktop Environment
• WM: Window Manager
• Terminal: Terminal emulator
• CPU: Processor model, cores, speed
• GPU: Graphics card model
• Memory: RAM usage with visual bar

Configuration

Configuration is stored in:

• Linux/macOS: ~/.config/hydrafetch/config.json
• Windows: %APPDATA%\hydrafetch\config.json

Development

# Clone repository
git clone <repository-url>
cd hydrafetch

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run built version
npm start

Requirements

• Node.js >= 18.0.0

License

ISC

Credits

ASCII art and inspiration from the amazing neofetch and fastfetch projects.