Note: Audio streaming is only available on TinyPilot Voyager 2a models.
If your target computer plays audio, TinyPilot can stream the remote system's audio through your browser. This page explains how to configure your TinyPilot for audio streaming and how to troubleshoot issues when audio isn't working.
Audio streaming is only available when TinyPilot is in H.264 streaming mode. You can check your TinyPilot's current streaming mode using the streaming mode indicator on the bottom left-hand corner of the TinyPilot web interface:
To enable audio, configure your video settings to use H.264 streaming mode:
If you purchased your TinyPilot Voyager 2a before Feb. 11th, 2023, you need to factory reset your device with the latest image to enable audio streaming.
TinyPilot runs on the Raspberry Pi OS. TinyPilot originally shipped with Pi OS 10, Buster. To enable audio, we had to switch to Pi OS 11, Bullseye.
Raspberry Pi OS unfortunately doesn't support major version upgrades, so the only way to move from a Buster system to a Bullseye system is to factory reset using TinyPilot Pro 2.5.3 or higher.
We understand that factory resetting your device is a burden on you, so we didn't take this decision lightly. We're currently working on tools in TinyPilot Pro 2.5.4 to make this transition easier, so you may choose to wait until that release to upgrade.
If you're unable to re-flash your microSD card, contact us for assistance.
If you can't hear any audio after switching to H.264 streaming, try the following troubleshooting steps:
For TinyPilot to capture audio, your target machine must output sound via HDMI. Check that your target machine is using HDMI as its sound output device.
The process of changing the output device varies by operating system, but you can usually find the sound output options in your computer's system settings under "Sound".
Go to your sound settings, select "Output", and then select "HDMI".
If you're unable to hear sound through TinyPilot's web interface, it could be because the target machine isn't producing audio at all.
To test whether the target machine is producing audio:
If you can hear sound on your target machine with TinyPilot disconnected, reconnect TinyPilot and re-verify muting and volume settings.
TinyPilot may fail to produce audio due to volume settings on your client system, the device from which you're viewing TinyPilot in the browser.
To test audio on your client sytem:
If your browser tab shows a speaker icon with a line through it, it means that the tab is muted:
Unmute by right-clicking on the tab for the tab's menu, then click "Unmute".
If you configured TinyPilot to use H.264 streaming mode, it's possible that H.264 streaming will fail over to MJPEG mode, which will prevent audio from streaming.
Check for a warning in TinyPilot's status bar about an H.264 streaming failure:
If you see an H.264 failure, refreshing the browser page may fix the issue.
Create a new thread in our help forum with the following details:
A log URL from your TinyPilot