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 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're unable to hear sound from your target computer, your browser may be preventing TinyPilot from playing audio. Check that your browser's settings allow audio playback.
Check that https://tinypilot is listed in the "Allowed to play sound" section.
Browsers don't play audio until you’ve interacted with the webpage. When debugging audio issues by reloading the webpage, you may not hear any sound until you click somewhere on the page.
A faulty connection can prevent audio from streaming through the HDMI cable. If previous steps have not restored audio, try disconnecting and reconnecting the HDMI cable from both the TinyPilot device and the target computer.
Web browser extensions may interfere with audio playback functionality. Try a different browser without extensions, or use your browser's incognito or private browsing mode. This will tell you whether the audio issues are related to a browser extension.
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.
If you can't hear audio from a macOS target, you may need to set your TinyPilot as the sound output device in the Control Center and the app you're using.
Open the Control Center and expand the list of sound output devices by clicking on the AirPlay symbol:
Ensure that "TinyPilot" is the selected sound output device:
If you still can't hear audio, check if the app you're using has its own sound output controls:
If it does, ensure that "TinyPilot" is the selected sound output device.
Create a new thread in our help forum with the following details:
A log URL from your TinyPilot