Foundry Virtual Tabletop allows for local ambient sound effects which are activated when a player-controlled Token is moved into it's area of effect. This can be useful for environmental features like a waterfall or a crackling campfire which your players will be able to hear when their Tokens are nearby.

Create an Ambient Sound using a left-mouse drag workflow on the Sounds Layer.

Ambient Sounds are created by navigating to the Sounds layer of the active Scene by clicking on the musical notes icon in the Scene control palette. While on the Sounds layer, you can create a new Sound by using a left-click and drag workflow to expand the area of effect (you can change it later). Once you are done dragging the Sound Configuration form will appear. You must select a sound file to play in order to complete the creation. The Sound Configuration shown in the following figure and it's configuration options are explained below:

Ambient Sound Configuration
Double click the Ambient Sound to open the Configuration Form.
Sound Type

Configure the type of sound emitted by this source. Ambient Sounds can either be local which are blocked by any Walls which inhibit perception or global which are always audible within their area regardless of the presence of Walls.

Audio Source

You must choose a path to a valid sound file which plays when Tokens are within the area of effect. Ambient Sounds always repeat on loop, so it is recommended to use a format like webm, wav, or ogg which allows for seamless looping, but other audio file formats are also supported.


The x-coordinate for the center of the Ambient Sound area of effect.


The y-coordinate for the center of the Ambient Sound area of effect.

Sound Radius

The radius of the area of effect for the Ambient Sound, expressed in distance units. For example, if your Scene is configured where each square represents 5ft.

Volume Easing

This option specifies that the volume of the Ambient Sound should automatically reduce as Tokens are further from it's origin (but still within the area) and increase in volume when Tokens are closer to the origin of the sound. If this option is disabled, the volume level of the Ambient Sound will be the same everywhere within the affected area.

Maximum Volume

This slider configures the maximum volume level of the Ambient Sound at it's point of origin (if easing is applied) or throughout the area (if no easing).

Modifying Placed Sounds

After an Ambient Sound has been created, you can edit it later by double clicking on its control icon that is visible when on the Sounds Layer. To move the position of an existing Ambient Sound you can click and drag it's icon to move it. You may also use CTRL+C and CTRL+V commands to copy and paste sounds.

Players can control the volume level of playing Ambient Sounds using the global Ambient slider in the Playlists tab of the Sidebar.

Note that Ambient Sounds always loop if a Token is within their area of effect. If you are interested in one-time audio effects which play at a certain time that will be handled by the Event Trigger system, a post-release feature that is not yet added.

API References

To interact with Ambient Sound objects programmatically, you will primarily use the following API concepts:


"Fossil Caves" map by FableKit on Patreon.