hackfetch v1.5.0

Automated release. Binaries built by CI.

hackfetch v1.4.0

Automated release. Binaries built by CI.

hackfetch v1.3.0

minor tweaks

hackfetch v1.2.0 — Live Mode + SVG Export

Live mode 🎥

hackfetch -watch re-fetches your Hackatime stats every 30 seconds and redraws in place. Today's hours tick up while you code. Ctrl+C to quit.

hackfetch -watch
hackfetch -watch stardance rainbow

Perfect for second-monitor displays or screen recordings.

Share your fetch 🖼️

hackfetch -export card.svg saves your fetch as a shareable SVG card with rounded corners, monospace font, and matching colors.

hackfetch -export card.svg
hackfetch -export card.svg stardance pride
hackfetch -export card.svg -logo orpheus -color rainbow

The SVG is self-contained - open in any browser, drop into a tweet, paste into a devlog. Convert to PNG with rsvg-convert or any image editor.

Tip: put flags before positional args. hackfetch -export card.svg stardance rainbow works; the other order doesn't.

Upgrade

brew update && brew upgrade hackfetch

Or fresh install:

brew tap xerneas3318/tap
brew install hackfetch

hackfetch v1.1.0 - Pride Flag Pack + Custom Themes + Stardance

Pride Flag Pack 🏳️‍🌈

12 new identity color schemes, joining the existing pride and trans:

bi · lesbian · pan · nonbinary · ace · aro · agender · genderfluid · intersex · demi · poly · progress

hackfetch stardance bi
hackfetch flag lesbian
hackfetch -color progress

Aliases included: bisexual, pansexual, nb, asexual, aromantic.

Custom themes

Define your own color schemes in ~/.config/hackfetch/colors.json:

{
  "schemes": {
    "vaporwave": { "colors": [199, 165, 99, 51], "mode": "per-line" },
    "fire":      { "colors": [196, 202, 208, 214, 220, 226], "mode": "per-char" }
  }
}

mode is single, per-line, or per-char. Your themes override built-ins of the same name.

-color auto

Detects the date and picks for you - pride during June, hackclub the rest of the year.

hackfetch -color auto
export HACKFETCH_COLOR=auto   # always-on

Stardance integration

• stardance field shows days left until Stardance ends (Sep 30, 2026). Auto-hides when Stardance is over.
• stardust field shows your stardust count when HACKFETCH_STARDUST=N is set:

export HACKFETCH_STARDUST=42
hackfetch

Upgrade

brew update
brew upgrade hackfetch

Or fresh install:

brew tap xerneas3318/tap
brew install hackfetch

hackfetch v1.0.0

The first official stable release of hackfetch — a Hack Club themed system fetch with live Hackatime stats.

Built for Stardance ✦

What's in 1.0

• 6 logos: hackclub, stardance, flag, orpheus (the real dinosaur), bot, rocket
• 12 color schemes: hackclub, orange, mono, mute, matrix, rainbow, pride, sunset, ocean, forest, stardance, trans
• Live Hackatime stats: today, 7-day total, streak, top project, top language, machines
• Smart language inference: when Hackatime returns "unknown", hackfetch infers from your heartbeat file extensions
• Verbose mode (-v): also shows top editor + top category
• First-run setup (-setup): walks you through Hackatime config
• Smart shorthand: hackfetch stardance rainbow works the same as hackfetch -logo stardance -color rainbow

Install

brew tap xerneas3318/tap
brew install hackfetch
hackfetch

Or via Go:

go install github.com/xerneas3318/hackfetch@latest

Configure defaults

Add to your shell rc:

export HACKFETCH_LOGO=stardance
export HACKFETCH_COLOR=rainbow
export HACKFETCH_VERBOSE=1