waxyy

A mood-driven record player, built for terminals.

Current UI

Visuals are in constant flux so expect changes:

Run

cargo run --release

For the complete command-line reference without entering the interactive UI:

cargo run -- --help

--render-preview works anywhere.

To export the exact design canvas without opening the interactive UI:

cargo run -- --render-preview /tmp/waxyy-preview.png

cargo run -- --render-preview /tmp/waxyy-spin.png 2.4 0.5 0.75 1

Controls

• 1–5: select a mood
• M: cycle moods
• Space: play/pause
• click the vinyl: play/pause
• Left / Right: seek backward/forward 10 seconds
• N or Enter: discover the next unheard track
• B: return to the previous record instantly
• Up / Down, mouse wheel, or the lower-right stepped level: volume
• R: retry the current mood catalog after an error
• Q / Esc: quit

Your selected mood and volume are restored from $XDG_STATE_HOME/waxyy/preferences (or ~/.local/state/waxyy/preferences).

Jamendo configuration

Jamendo integration uses a client ID, not a checked-in credential. Put it in your process environment when launching:

JAMENDO_CLIENT_ID=your_client_id cargo run --release

Never commit credentials or add them to this README.

Copy .env.example to .env and fill in only JAMENDO_CLIENT_ID; WAXYY does not use a Jamendo client secret.

Jamendo's client secret and public client ID are different values. Catalog queries require the public ID from the Jamendo developer portal; the secret is reserved for OAuth flows and is never sent to the public tracks endpoint.