Foundry Virtual Tabletop supports the use of audio to accentuate player actions or enrich the atmosphere during gaming sessions. This page details the use of Playlists and the sounds contained within them.


The Playlist Directory

The Playlist Directory allows Gamemasters and Assistants to create new Playlists and modify existing ones. All players can access this sidebar, to view the currently playing playlists and adjust client-side volume controls.

Global Volume Controls

Global volume controls are client-sided sliders that modify all sounds of certain categories, allowing players to fine-tune volume levels on their end.

The Playlists volume slider determines the master volume of playlists played by the Gamemaster.

The Ambient volume slider adjusts the master volume of Ambient Sounds heard in a Scene.

The Interface volume slider adjusts the master volume of sounds triggered through interface actions (such as chat messages and dice rolls).

Creating Playlists

In order to play audio tracks on demand, or as a sequence, they must be first added to a playlist. A playlist can contain multiple sounds, and the same sound can be in multiple playlists.

Click the "Create Playlist" button at the bottom of the Playlist Directory sidebar to create a playlist. From there, a prompt will appear, allowing you to enter the name of the playlist.

Playlists are added to the bottom of the list, but are sorted in alphabetical order once Foundry is refreshed.

Managing Playlists

The Playlist Directory Controls
The Gamemaster's view of the Playlist Directory sidebar.

Playlists on their own come with various buttons and toggles used to manage both the playlist itself and the playback of the sounds it contains.

Edit Playlist
Opens a prompt to edit the playlist's name and its Playback Mode
Add Sound
Adds a Sound to the playlist. See the "Adding Sounds" section in this article.
Delete Playlist
Deletes the playlist after accepting a confirmation prompt.
Playback Mode
Cycles through the various playback modes. Playback Mode determines the behavior of the playlist when the "Play Playlist" button is pressed.
Sequential Playback: Plays each sound in the playlist, one at a time, in order.
Shuffle Tracks: Plays each sound in the playlist, one at a time, in a random order.
Simultaneous Playback: Plays each sound in the playlist at the same time.
Soundboard Only: Does not allow the playlist to be played as a whole. The playlist will always be expanded when Foundry reloads, and each sound can be played separately as normal.
Play/Stop Playlist
Plays the tracks in the playlist according to the Playlist Mode. If stopping, all currently playing tracks in the playlist will stop playing.

Normally, only Gamemasters and Assistant users can view and manage playlists, but all players can see the names of playlists when they are played. Take care to keep your playlist and sound names spoiler-free!

Adding Sounds

The Playlist Sound Configuration Sheet
The New Track configuration window.

Once a playlist has been created, individual sounds can be added to it by clicking the "Add Sound" button next to the playlist (notated by a plus sign icon). This will bring up the configuration window allowing you to add the sound to the chosen playlist. Once a sound has been created in a playlist, the playlist can be expanded to manage the individual sound, such as editing the name or sound source, toggling the track to loop when played, or deleting the sound from the playlist.

Track Name
The name of the sound, as seen in the Playlists Directory. This is the name all players see in the Playlists Directory sidebar while the sound is playing.
Audio Source
The source file for the sound. This can either be a file stored in Foundry directories, or a direct URL link to a sound file online. FVTT supports .flac, .mp3, .wav, and .webm audio files.
Volume
The volume of the individual sound. The sound's volume is also affected by the Master Playlists volume slider.
Repeat
Determines whether the sound repeats when played. Note that currently, sounds do not loop seamlessly - there will be a short gap between loops, regardless of the sound file chosen.

API References

To interact with Playlists programmatically, consider using the following API concepts: