Skip to content

Optional local music

Play your local song files with a visualizer that follows the rendered audio. Sound plays on the computer running Godmode.

You are reading the v0.19.2 documentation. Open the current docs.

More formats
Raw Markdown ↗

Connect Darunia#

Darunia’s local tools turn song files into playable audio.

You need an existing Darunia's CLI installation, its synthesis tools and SoundFonts, and local .ootrs songs you have rights to use. For access to Darunia's code, contact Michael through your purchase or evaluation conversation.

godmode music init /path/to/darunias-cli \
  --songs /path/to/local/music
godmode music

Replace both example directories with your local paths. Use / to search the picker, or run godmode music list 'Chrono Trigger'. Godmode supplies no songs or synthesis tools and does not call Darunia's network player.

Play and stop#

Choose a track that exists in your song directory:

godmode music play \
  'Chrono Trigger/Corridors of Time.ootrs' \
  --seconds 30

The default render is three minutes; --seconds accepts 1–3600. Stop with q, Escape, or Ctrl-C. Playback requires afplay, ffplay, or aplay.

--no-motion removes animation; godmode --plain music uses static text. The visualizer reads the WAV, without recording a microphone or system audio.

Manage cached audio#

Cached audio speeds up replay but uses disk space.

TaskCommand
Check the cache and Darunia linkgodmode music status
Delete cached audiogodmode music clear
Disconnect Daruniagodmode music forget

To render a track without playing it:

godmode music play \
  'Chrono Trigger/Corridors of Time.ootrs' \
  --render-only

WAVs are cached in GODMODE_HOME/state/music/cache, defaulting to ~/.godmode/state/music/cache. Inputs and a SHA-256 receipt are checked before reuse. clear removes cached audio, keeps songs and settings, and refuses to run during playback or synthesis. forget removes the Darunia link.

If the synth script changes, review it and run music init again. Synthesis runs with a small environment excluding Godmode keys. Asset and tool licenses remain separate.

To omit the adapter from a source build:

sh scripts/build-native.sh --without-music

Godmode v0.19.2 · 2026-11-17 · Inspect the source · Get help