Moondog is a radio host just for you, and it works from a listening room in your terminal or on your Mac.
It reads the history your music services already keep, and turns it into a profile you can open, question, and correct.
The profile works without a model, an API key, or a music-service login.
When you want company, it can talk music with you, find songs you have not heard, shape a playlist, and on a Mac go on air with music it makes itself.
It shows its work, and your data stays on your machine.
The room is built on Pi.
Open the room
You need Node.js 22.19.0 or newer, on macOS or Linux.
Install from this checkout to run the room shown here.
git clone https://github.com/Audiofool934/moondog.git
cd moondog
npm ci
npm start
@audiofool/moondog 0.2.2 is the published package; npm install --global @audiofool/moondog installs it.
To see the agent work through fictional data, with no sign-in at all, run npm run demo from the checkout.
The source version supports moondog update and /update, with stable (latest) and preview (beta) channels.
Startup checks show a quiet notification; installation happens only when you request it.
See updating and release channels, including the one-time upgrade needed for the older npm 0.1.0 package.
On your Mac
Moondog for Mac is a native window on the same core as the terminal room.
It shares your profile, settings, sign-ins, and conversations with moondog, and draws its own conversation, now playing, and up next.
Download the notarized build for Apple silicon from the project page, or run it from this checkout with cd app && npm ci && npm start.
It updates itself, on a Stable or Beta channel you choose in Settings.
The project page plays a short scene in this window, in a browser, with a made-up listener (how).
The sleeve
The opening is a record sleeve drawn in characters.
Nothing in the terminal is a picture.
On a wide screen the record sits beside the title, with the wordmark level with the dog's eye.
On a tall or narrow screen the record stacks above the title.
Moondog uses whichever arrangement leaves the record larger.
A lyric rests midway between the record and the input box, with room on both sides.
The input asks what you have been listening to.
Until your library has a line of its own, the sleeve rotates three short ones: "Where have you been?", "Is there anybody out there?", and "Wish you were here."
When a matching line from music you have played is available, that line takes the place.
Moondog asks LRCLIB for the original words only, and does not send your profile, your history, or the conversation.
The room is black and white, like the moon.
Paper is black ink on white.
Charcoal is moonlight on a black sky.
/theme terminal keeps your own colors.
The only other colors are the six from the prism on The Dark Side of the Moon.
Red means a step failed, orange is a caution, green confirms, and the spectrum shows while Moondog is working.
Press Tab on an empty input to step onto the tracklist, then use the arrow keys and Enter.
| On the sleeve | Command |
|---|
| Listening profile | /taste |
| Import your music | /import |
| Appearance | /theme |
| Help & commands | /help |
While the room is idle, lunar marks travel the record, a highlight follows the groove, and the needle pulses.
The dog and the wordmark stay still.
/motion off holds the sleeve.
/art ascii switches the drawing.
/home returns here and leaves the conversation where it was.
Bring your history
Type /import and pick a service.
Moondog shows you what is inside before anything is saved.
When the import finishes, your profile opens in the same TUI session.
| Service | What you can bring |
|---|
| Spotify | Recent plays after you connect, or the whole history from the ZIP Spotify emails you. |
| Apple Music | The Library.xml you export from Music on a Mac. |
| YouTube Music | A Google Takeout export. |
| Last.fm | Your scrobbles and loved tracks, read by username. |
| QQ Music and NetEase | Any public playlist, from its share link. |
| ListenBrainz | A saved listens file. |
A Spotify ZIP can also go straight in.
/import "/path/to/spotify-history.zip"
Importing the same file twice changes nothing, and your original files are never touched.
Apple's privacy download, and full QQ or NetEase listening history, are not supported yet.
The terminal guide has every format.
With a connected model, /profile build writes a reading of everything you imported, usually in a few minutes.
It names the threads in your listening, keeps what you played apart from what you saved, and marks its interpretations as interpretations.
A second pass checks the draft for contradictions and invented claims, and the build fixes what it finds before saving.
Use /profile saved to read it and /profile explain 1 to trace a finding to its evidence, including after restarting.
New imports or corrections mark it for an update; a cancelled build keeps its draft and your previous reading.
The builder sends a compact summary of your music evidence to your configured model when you ask for it.
Your profile
The profile says what you played, and what that cannot prove.
Playing a song a lot does not, on its own, establish how much it matters to you.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
