AudioBridger for macOS
======================

Stream audio between computers on your local network in real time.

This zip contains three command-line apps:

  ab_sender    Picks an input device and broadcasts its audio.
  ab_receiver  Listens for a sender and plays the audio out.
  ab_hub       Optional. Web dashboard at http://<hub-ip>:4466 for
               routing, monitoring, and remote control.


First run
---------

In two terminal windows on the same Wi-Fi or wired LAN:

  Terminal A:  ./ab_sender
               # picks an input device when prompted

  Terminal B:  ./ab_receiver
               # finds the sender automatically over the LAN


Optional: the hub
-----------------

  Terminal C:  ./ab_hub
               # then open http://localhost:4466 in a browser

  In the dashboard you can drag wires between senders and receivers,
  mute receivers, pick output devices, and listen to any sender's AAC
  stream right in the browser.


Capturing system or app audio
-----------------------------

A real microphone or hardware line-in works out of the box. To send
audio from a specific app, or your machine's overall output, install
one of:

  - BlackHole       https://existential.audio/blackhole/    (free)
  - Loopback        https://rogueamoeba.com/loopback/       (paid, polished)

Then pick it as the input device when ab_sender asks.


First-launch prompts
--------------------

The first time each app runs, macOS will pop up:

  - A microphone permission prompt for ab_sender. Allow it.
  - A firewall prompt for ab_receiver and ab_hub. Allow it.


Useful flags
------------

  ./ab_sender --version          show version and exit
  ./ab_sender --activate <CODE>  activate a paid licence (online)
  ./ab_sender -o                 print this machine's UUID for offline activation
  ./ab_receiver <sender-ip>      bypass mDNS, connect directly
  ./ab_hub --http-port 8080      use a different dashboard port

Run any app with no arguments for the interactive flow.


Licensing
---------

The trial runs for 30 minutes per launch on the sender and hub.
Receivers are always free. Buy a licence at:

  https://bluetomatomedia.com/buy/audio-bridger/

See LICENSE in this zip for the full terms.


Trouble?
--------

  support@bluetomatomedia.com

Include your activation code if it's an activation problem.
