Enhanced Audio Player

Enhanced Audio Player is a lightweight, system-agnostic module for Foundry Virtual Tabletop that adds advanced playback controls to Foundry's native audio and playlist system.

The module does not replace Foundry's audio engine, playlists, or PlaylistSound documents. Instead, it adds a compact control layer on top of the existing system, allowing the GM to define exactly which portion of a sound should be played while keeping normal Foundry playlist management intact.

It is designed to work with any game system.

Features

• Full Track Playback
  By default, sounds behave exactly like normal Foundry audio and play from beginning to end.

• Custom Playback Range
  Disable Full Track and define a precise Start and End time for a sound.

  Example:

  Start: 100.000s
End: 120.000s

  The sound will begin at 100 seconds and stop at 120 seconds.

• Range Looping
  Enable Loop Range to continuously repeat only the configured Start → End section.
• Fade In / Fade Out
  Configure simple fade transitions for the selected playback range.

• Interactive Timeline
  The progress bar always represents the complete audio file while visually showing the configured Start and End positions.

  In Full Track mode, the entire timeline can be used for seeking.

  In Custom Range mode, seeking is limited to the configured playback range.

• Play / Pause / Resume / Stop
  • Play always starts a new playback from the beginning of the active playback range.
  • Pause preserves the current playback position.
  • Resume continues exactly where playback was paused.
  • Stop ends playback and resets the position to the beginning of the Full Track or Custom Range.

• Selected Track and Playing Track
  The module distinguishes between the sound currently being edited and the sound currently playing.

  You may select and configure another sound while music continues playing.

  When a new sound begins playback, the Enhanced Audio Player automatically follows it and loads its saved configuration.

• Explicit Configuration with OK
  Start, End, Loop, Fade, and Full Track settings are edited locally first.

  Nothing is written to the Foundry document while you are typing.

  Press OK to validate and save the configuration.

• Reset Track
  Removes the Enhanced Audio Player configuration from the selected sound and restores the default Full Track behavior.

Configuration Is Per Playlist Sound

Enhanced Audio Player stores its settings on the individual PlaylistSound, not on the audio file itself.

This means the same audio file can behave differently in different playlists.

For example:

Playlist A

• Start: 100s
• End: 120s
• Loop: On

Playlist B

• Start: 15s
• End: 30s
• Loop: Off

Another occurrence

• Full Track

Each occurrence is completely independent.

Resetting a sound in one playlist does not reset another occurrence of the same audio file elsewhere.

This is useful not only for music, but also for sound effects. A GM can keep a long audio file available while configuring one occurrence to play only a specific effect or musical moment contained within it.

Playlist Integration

Saved playback settings are persistent.

When a configured sound begins playing through Foundry's playlist system, Enhanced Audio Player applies its saved playback policy automatically.

For a Custom Range with Loop disabled:

Start → End → Next Track

For a Custom Range with Loop enabled:

Start → End → Start → End → ...

Foundry remains responsible for playlist ordering and progression. Enhanced Audio Player only controls how the individual sound is played.

How to Use

1. Open Foundry's Playlists sidebar.
2. Expand a playlist.
3. Click a sound to select it in Enhanced Audio Player.
4. Leave Full Track enabled to use the entire sound, or disable it to configure a custom range.
5. Enter the desired Start and End times.
6. Optionally enable Loop Range and configure Fade In / Fade Out.
7. Press OK to save the configuration.
8. Use the Enhanced Audio Player controls or allow the playlist to reach that sound naturally.

Use Reset Track at any time to remove the module's settings from that particular sound.

Native Foundry Integration

Enhanced Audio Player is intentionally designed as a control layer rather than a replacement audio system.

Foundry continues to handle:

• Playlists
• PlaylistSounds
• Audio files
• Audio playback
• Volume
• Playlist ordering
• Multiplayer audio synchronization
• Native playlist management

The module stores only its additional playback configuration using Foundry document flags.

No separate audio library, custom playlist database, or replacement audio engine is created.

Compatibility

• Foundry VTT V13: 13.341 and newer
• Foundry VTT V14
• Game System: Any / System Agnostic

Design Philosophy

Enhanced Audio Player has a deliberately focused scope.

It is not intended to become an audio editor, soundboard, waveform editor, or replacement playlist manager.

Its purpose is simple:

Give Foundry's native audio system better control over when a sound starts, when it ends, whether that section loops, and how the GM interacts with playback — while leaving the underlying Foundry audio system intact.