Skip to content

Latest commit

 

History

History
64 lines (34 loc) · 4.09 KB

README.md

File metadata and controls

64 lines (34 loc) · 4.09 KB

Snap.Net.Broadcast

Overview

The purpose of this tool is to make it possible to stream audio from your Windows PC to snapserver. It uses Wasapi loopback to capture the audio coming through your audio device, and sends it to snapserver for syncronized playback. The delay between the audio being captured on your PC will more or less equal the buffer setting in snapserver which defaults to 1000ms (plus the network latency between your PC and snapserver, which should be negligible in most cases).

This also works really well with meta streams, as we only send audio to the server when something is actually played (silence is not sent).

It's also possible to capture the audio from any input device (eg. a microphone) and send it to snapserver. I can't think of many practical applications for broadcasting your own voice around the house, other than pranking the wife and kids in a thousand different ways.

Usage

List all output devices:
Snap.Net.Broadcast.exe --list --type Output

List all input devices:
Snap.Net.Broadcast.exe --list --type Input

Broadcast:
Snap.Net.Broadcast.exe --host <snapserver-ip> --port 4953 --type <Input/Output> --soundcard x (where x is the number of the soundcard identified via --list)

Setup

To make this work, you first need to set up a stream on snapserver which listens for incoming audio data over TCP. See https://github.com/badaix/snapcast/blob/master/doc/configuration.md#tcp-server

stream = tcp://<snapserver-ip>?port=4953&name=snapbroadcast

Note: If Snap.Net.Broadcast is unable to connect to your server even though the above config is added correctly, try using "0.0.0.0" as ip instead (see #29 )

Next, you need to choose an audio device from your PC to use for capturing loopback from. In most cases you won't want to use your main output device, because you can't use it for loopback and playback at the same time. E.g. audio being captured from your main speakers would just echo back ~1000ms after being broadcast. Volume and mute of your audio device is also applied to loopback, so you can't mute one without also muting the other.

There are 2 ways to work around this: either use an audio device which is not connected to any speakers (in my case I have a Digital Audio interface on my motherboard which isn't hooked up):

image

Or you can install a virtual audio device and just use that. Virtual Audio Cable works well for this:

image

Finally, it's just a matter of configuring the Broadcast tool within Snap.Net:

image

Or starting it via command line (use this for troubleshooting if something doesn't work):
Snap.Net.Broadcast.exe -s 2 -h <snapserver-ip> -p 4953

That's it! Now, any audio that is played to the device you've set up for loopback will get broadcast via snapserver.

Applications

The easiest way to make use of this, is to just set the broadcast audio device as your default: image

However, this will also include regular Windows alert sounds etc, which isn't great. A nicer way is to specify the output device in whatever media player you use to play music, so that only audio from that application gets broadcast.

You can even watch movies this way, because the delay is known we are able to compensate for it so that audio and video are perfectly in sync:

(example screenshots are from Media Player Classic)

image

image