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, the sounds contained within them, and the playlist's various settings.
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).
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.
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!
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.
- The volume of the individual sound. The sound's volume is also affected by the Master Playlists volume slider.
- 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.
- Large File Streaming
- Determines whether the sound should be streamed to players instead of using HTML5 audio. This toggle is meant for audio files greater than 5MB, as HTML5 Audio is not ideal for large audio files due to various technical reasons. This function will very likely be removed after the upcoming 0.8.1 update in favour of a better implementation of audio play.
To interact with Playlists programmatically, consider using the following API concepts:
- The Playlist Entity
- The Playlists Collection
- The PlaylistDirectory Sidebar Directory
- The PlaylistConfig Application
- The PlaylistSoundConfig Application