herzies
v0.6.1
Published
A digital pet that lives in your terminal that grows by listening to music
Readme
_ _
| | (_)
| |__ ___ _ __ _____ ___ ___
| '_ \ / _ \ '__|_ / |/ _ \/ __|
| | | | __/ | / /| | __/\__ \
|_| |_|\___|_| /___|_|\___||___/A digital pet that lives in your terminal and grows by listening to music. herzies.app
The CLI sends listening observations to the herzies game server, which calculates XP, manages events, and tracks streaks. Log in to sync across devices, compete on the leaderboard, and collect items.
Install
npm i -g herziesUsage
herzies # open the live dashboard
herzies hatch # create your herzie
herzies status # quick snapshot of your herzie
herzies listen # start listening in the foreground
herzies start # start background listening (no terminal needed)
herzies stop # stop background listening
herzies autostart # auto-start daemon on login (on/off)
herzies login # log in to sync across devices
herzies friends # manage your friendzies
herzies friends add # add a friendzie by code
herzies kill # permanently delete your herzie
herzies help # show available commandsRequirements
- macOS (music detection uses AppleScript and is not yet available on Linux or Windows)
Want to contribute?
- Add support for other operating systems — music detection currently relies on macOS AppleScript. Linux (e.g. MPRIS) and Windows support would be welcome.
- Add support for more music players — we currently detect Apple Music and Spotify, but there are plenty more out there.
License
MIT
