> Godmode v0.19.2 documentation · Reviewed 2026-11-17
> Source: https://godmode.build/docs/v0.19.2/music

# Optional local music

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

## 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.

```sh
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:

```sh
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.

| Task | Command |
| --- | --- |
| Check the cache and Darunia link | `godmode music status` |
| Delete cached audio | `godmode music clear` |
| Disconnect Darunia | `godmode music forget` |

To render a track without playing it:

```sh
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
sh scripts/build-native.sh --without-music
```
