# stream.sh

A quick-and-dirty solution for streaming audio over TCP/IP between
Linux computers with ALSA.

# usage

The architecture consists of a server (Computer With Speakers) and
a client (Computer With Crappier Speakers But We Have Media On It).
The script is self-contained, so you can distribute the same version
to client and server computers.

On the server, run

```
./stream.sh server 1337
```

... and then, on the client, run

```
./stream.sh set
./stream.sh client 10.21.37.1 1337
```

This is enough to get you started, you should start hearing audio
from your local applications on the remote computer. By default,
stream.sh uses WAVE in a RIFF container - this provides a high
quality, low-latency solution. In case your network isn't fast
enough to support raw audio data, you can specify a codec and
bitrate:

```
./stream.sh client 10.21.37.1 1337 libopus 64
```

# debugging

stream.sh has a built-in benchmarking functionality that tries to
guess the correct timings for your hardware. If this is inaccurate
and you hear pops, or the audio drops off completely every ~60s,
you may want to run

```
./stream.sh benchmark ffmpeg
```

and modify the delay variable in the `USER-CONFIGURABLE VARIABLES`
section of stream.sh


# building

```
./pack.sh > stream.sh
```