Set up the AntennaHead workspace

Why use it

AntennaHead and ControlBooth use several of the other projects as local Swift packages, found by relative path (for example ../PipelineHelpers). Those paths only resolve when every project sits in the same parent folder. Cloning the projects one at a time into random places makes Xcode fail to find them, or quietly fall back to a copy from GitHub instead of your local one. The workspace script builds the right layout for you.

You’ll need: a Mac running macOS 14 (Sonoma) or later, Xcode 15 or later, and git (it comes with Xcode’s command line tools). An RTL-SDR radio is optional for building; you only need one to tune over-the-air stations.

Step 1: Make the umbrella folder and run the script

Pick a place for everything. The folder name doesn’t matter; this example calls it antennahead-umbrella. The script clones each project as a sibling of antennahead-workspace, so the workspace project goes inside the umbrella folder first.

mkdir antennahead-umbrella
cd antennahead-umbrella
git clone https://github.com/dsward2/antennahead-workspace.git
./antennahead-workspace/bootstrap.sh

The script reads repos.txt and prints == AntennaHead: cloning == and so on for each project. It ends with Done. Repos are siblings of: …. Run it from anywhere; it puts the projects next to antennahead-workspace, not in your current folder.

Step 2: What you get

Each project is its own independent git repository with its own history, issues and pull requests. The workspace only holds the list.

antennahead-umbrella/
  antennahead-workspace/   the manifest and bootstrap script
  AntennaHead/             the sandboxed macOS app
  ControlBooth/            the unsandboxed companion app
  LiveAudioServer/         the streaming server
  PipelineHelpers/         shared pipeline tools
  SharedLogging/           shared log viewer
  AirPlayReceiver/         AirPlay audio receiver package
  antennahead-librtlsdr/   RTL-SDR driver build
  AntennaHeadAPI/          JSON API types for the native apps
  AntennaHeadTV/           Apple TV app
  AntennaHeadiOS/          iPhone, iPad and Apple Watch apps
  AntennaHeadUninstaller/  cleanup tool
  StationDirector/         station automation prototype

Step 3: Open and build

If Xcode says a package can’t be found, check that the project folders really are siblings (ls in the umbrella folder should list them all).

Step 4: Keep it up to date

Run the script again any time. For a project that’s already cloned it fetches the latest changes without changing your files, so follow it with a pull in the projects you want to update:

./antennahead-workspace/bootstrap.sh
git -C AntennaHead pull --ff-only
git -C ControlBooth pull --ff-only

To update every project at once, run this in the umbrella folder. It skips any project with local changes it can’t fast-forward over:

for d in */; do git -C "$d" pull --ff-only; done

Changing or adding projects

antennahead-workspace on GitHub → All projects