Audio

Add sound effects and background music to enhance your story’s atmosphere.

Sound Effects

Play a sound once when the text appears:

# AUDIO: assets/sword-clang.mp3

Aliases: # SOUND:, # SOUND_EFFECT:, # SFX:

Great for: door creaks, footsteps, notifications, dramatic moments.

Background Audio

Loop music continuously:

# AUDIOLOOP: assets/tavern-music.mp3

Aliases: # AUDIO_LOOP, # MUSIC:, # BACKGROUND_MUSIC:, # BGM:

To stop the music:

# AUDIOLOOP: none

You can also use stop instead of none.

Tips

• Supported formats: MP3 works everywhere. OGG and WAV also work in most browsers.
• File location: Put audio files in assets/. (Not required, all paths are relative to the template’s base directory, but it keeps everything organized!)
• Reader control: Players can mute all audio in the Settings menu.

Found a bug or have a feature idea?
Open an issue on GitHub, or use the feedback forms: Bug report · Feature request