An Add-on Module for Foundry Virtual Tabletop

Author: bekit Project Source: Project URL Versions 0.7.0+ (Verified 10) Last Updated 2 years, 3 months ago

What is Walkie-Talkie

Transmit voice chat to an individual with a push-to-talk microphone.

Are you running a game and the bard just decided to step through the magic portal by himself? Are you a player and want to use the message spell for a secret between you and another player? Does a warlock patron need to speak to his underling without the rest of the party knowing about the influence?

Walkie-Talkie is for any situation where one-to-one audio is needed.

What it is not

Walkie-Talkie is not meant as a replacement for a full AV client. It can work beside and in addition to these clients.

Walkie-Talkie will also not help in situations with interesting network challenges. This module relies on websockets and STUN/TURN WebRTC protocols. It may not be able to establish a connection between peers in all cases, and it will not work in low-bandwidth situations. However, the connection is as lightweight as possible; so it may work in some situations where a heavier AV client doesn't.


You can install this module through the FVTT module browser or by using the following manifest URL:

How to use

By default, Walkie-Talkie does not not establish any connections between users. This helps prevent any unnecessary resources from being used. When users first connect, they will see a grey icon next to each other user in the FVTT Player List to indicate that no connection is established.

example image - no connections from gm example image - no connections from player

To establish a connection to another user, simply click the microphone next to their name, this will attempt to establish a two way connection between the users. If the connection is fully established with an audio connection, the microphone will turn dark green.

example image - gm connected to player 1 with audio

If the connection is established, but unable to send audio (e.g., if the user denied access to their microphone), the microphone will turn orange to indicate that they are connected and may receive audio, but cannot send audio.

example image - player 1 connected to gm without audio

To transmit audio, click and hold down on the microphone next to the user you want to send to. Your microphone will turn bright green to show that you are sending your audio. If you are receiving audio from another user, the microphone next to that user will highlight in yellow.

example image - gm transmitting audio to player 1 example image - player 1 receiving audio from gm

To change the microphone or audio output device used by Walkie-Talkie, you can change the Audio Capture Device or Audio Output Device under the standard FVTT Audio/Video Configuration settings.

Module Options

example image - module options

Toggle sending audio - Default off

Changes the default push-to-talk microphone behavior to a toggle. With this enabled, it's possible to transmit audio to more than one user at a time.

Disable AV client microphone - Default on

If using another AV Client for full communication, this option automatically activates mute on the main AV client so your audio is only sent through Walkie-Talkie when pressing a microphone. This option is ignored if Toggle sending audio is enabled.

Enable debug logging - Default off

Increases the logging level of the module. Useful for debugging connection issues.

Known limitations



Support my work

Become a Patron Donate via Ko-Fi


Available Versions

  1. Version 0.2.4

    2 years, 3 months ago
    Foundry Version 0.7.0+ (Verified 10) Manifest URL Read Notes
  2. Version 0.2.3

    Foundry Version 0.7.0+ (Verified 9.231) Manifest URL Read Notes
  3. Version 0.2.2

    Foundry Version 0.7.0+ (Verified 0.8.8) Manifest URL Read Notes
  4. Version 0.2.1

    Foundry Version 0.7.0+ (Verified 0.8.6) Manifest URL Read Notes
  5. Version 0.2.0

    Foundry Version 0.7.0+ (Verified 0.8.5) Manifest URL Read Notes
  6. Version 0.1.6

    Foundry Version 0.7.0+ (Verified 0.8.1) Manifest URL Read Notes
  7. Version 0.1.5

    Foundry Version 0.7.0+ (Verified 0.8.0) Manifest URL Read Notes
  8. Version 0.1.4

    Foundry Version 0.7.0+ (Verified 0.8.0) Manifest URL Read Notes
  9. Version 0.1.3

    Foundry Version 0.7.0+ (Verified 0.8.0) Manifest URL Read Notes
  10. Version 0.1.2

    Foundry Version 0.7.0+ (Verified 0.8.0) Manifest URL Read Notes
  11. Version 0.1.0

    Foundry Version 0.7.0+ (Verified 0.8.0) Manifest URL Read Notes