AudioRoute 0.1.3 — Friendly Onboarding Preview

A friendlier start with AudioRoute: the README now shows what you can ask Claude Code or Codex to do before the installation steps. Installer screens explain the benefits, what goes on your Mac, how to start chatting with an agent, and how to uninstall later.

This preview updates installation text and onboarding. It uses the same 0.1.3 audio binaries and uninstaller behavior as preview 1.

Downloads

• To install or update, choose AudioRoute-0.1.3-universal-unsigned.pkg.
• To remove AudioRoute, choose AudioRoute-0.1.3-uninstaller-unsigned.pkg.

Both are unsigned, unnotarized developer previews for macOS 14.2 or later. The installer supports Apple Silicon and Intel Macs. SHA-256 checksums are included.

Open the installer, approve the administrator prompt, restart, and ask Claude Code or Codex on your Mac to run audioroute setup --start and help create your mix.

The uninstaller removes installed components and keeps your saved setups. Finish calls/recordings using AudioRoute before removal, then restart afterward.

Both packages passed inspection without executing their installation/removal scripts. The underlying binaries and removal behavior retain the automated validation from preview 1; a real fresh-machine install/uninstall remains unverified.

Changes: #5

AudioRoute 0.1.3 — Uninstaller Included

Adds a Finder-friendly AudioRoute uninstaller and clear removal instructions in the README.

Choose your download

• Install or update: AudioRoute-0.1.3-universal-unsigned.pkg.
• Uninstall: AudioRoute-0.1.3-uninstaller-unsigned.pkg.
• Each package has a SHA-256 checksum.

Both are unsigned, unnotarized developer previews. Requires macOS 14.2 or later. The installer has universal Apple Silicon and Intel binaries.

Install

Open the universal installer, approve the administrator prompt, restart the Mac, then run audioroute setup --start. Updates preserve saved routes. Includes the installer upgrade permission fix from 0.1.2.

Uninstall

Finish calls or recordings using AudioRoute. Open the uninstaller, approve the administrator prompt, and restart afterward. It stops routing and removes the installed app, CLI, audio driver and broker service. Saved routes and virtual-device configuration are retained for a future reinstall. Virtual devices disappear after the audio driver unloads on restart.

Validation: full automated suite passed, including 25 Swift tests, driver/realtime sanitizer checks, installer guards, uninstaller fixtures, 115 help checks, setup and CLI integration. Both packages were inspected without executing their installation scripts. Removal fixtures cover repeated/no-install removal, shutdown failures and saved-state preservation. A real uninstall and signed/notarized distribution have not yet been tested.

Changes: #4

AudioRoute 0.1.2 — Installer Upgrade Fix

Fixes installation over an existing AudioRoute setup.

The installer incorrectly rejected valid shared audio folder permissions because macOS stat %Lp omits the set-group-ID bit. Both preinstall and postinstall now check the full permission mode, owner and group correctly. Existing routes and virtual-device state are preserved. Unsafe modes and symbolic links remain rejected.

If 0.1.0 or 0.1.1 installation failed with “Existing shared audio folder permissions need repair”, download this installer and retry. That failure occurred before payload replacement; no manual permission repair should be needed for correctly configured folders.

Download AudioRoute-0.1.2-universal-unsigned.pkg and its checksum. Requires macOS 14.2 or later; universal Apple Silicon/Intel payload. This remains an unsigned, unnotarized developer preview. After successful installation, restart the Mac, then run audioroute setup and audioroute setup --start.

Validation: all 25 Swift tests, driver/realtime sanitizer checks, installer upgrade regression tests, 115 help checks, setup checks, CLI integration and universal package inspection passed. Regression tests execute installer guards against temporary folders and confirm valid setgid upgrades, rejection of unsafe modes/links and preservation of saved state. A real installation retry and fresh-machine/Intel audio tests have not yet been performed.

PR: #3

AudioRoute 0.1.1 — Developer Preview

Agent-first audio routing for macOS 14.2 and later. This developer preview includes a universal installer for Apple Silicon and Intel Macs.

Changes

• Route status now shows the actual selected channel indices, distinguishing channel 9 from a count of one channel.
• Device inspection exposes stream order, starting channels, formats, and preferred stereo pairs.
• AudioRoute reconnects when the device stream layout changes, preserving explicit channel selections.
• Added CLI help and a channel troubleshooting guide, plus small code cleanup.

The reported Zoom computer-audio-sharing channel switch has not been reproduced. These changes improve observability and layout-change recovery; they do not claim to fix Zoom's private channel settings or the interface's internal routing.

Download and installation

Download AudioRoute-0.1.1-universal-unsigned.pkg and its SHA-256 checksum. This is an unsigned, unnotarized developer preview, not a trusted public installer. Developer ID signing credentials are not configured yet.

After installing through macOS Installer, restart the Mac, then run audioroute setup and audioroute setup --start. Starting restores saved scenarios. Microphone permissions and the input/output selections inside Zoom or other apps may still need attention.

Validation

All 25 Swift tests, driver/realtime sanitizer checks, 115 offline CLI discovery checks, setup checks, and isolated CLI integration passed. Universal binaries and installer contents, ownership, scripts, and deployment targets were verified. Packaging did not install anything or interrupt the running audio session. Fresh-install testing and real Intel audio testing were not performed for this release.

Changes: #1

AudioRoute 0.1.0 — Developer Preview

Describe the audio setup you want, then let your coding agent create it.

AudioRoute is a macOS audio routing CLI with virtual microphones and speakers, independent destination mixes, persistent scenarios, and built-in help designed for agents.

Download status

This is an unsigned developer preview, not a signed consumer release. The .pkg contains ad hoc signed code but has no Developer ID Installer signature and has not been notarized. macOS may block it under normal security settings. Do not disable security protections to install it. Developers can use the documented source-build path instead. A signed installer is the next distribution milestone.

Included

• One universal installer containing Apple Silicon and Intel binaries; macOS 14.2 or later.
• CLI, background app, virtual audio driver, and transport broker.
• Explicit Send/Return routing for guitar lessons: guitar + voice to Zoom, guitar + teacher to headphones.
• Separate source, per-destination, and master levels.
• audioroute setup, machine-readable command help, schema, guide, and editable scenario examples.
• Agent-first README, setup prompt, and new AudioRoute header logo.

Getting started

Read the README and hand its setup prompt to your coding agent. The agent quickstart explains discovery, configuration, and testing. Developers building locally should follow source setup.

After an authorized installation and a Mac restart to load the driver:

audioroute setup
audioroute setup --start

The installer does not restart Core Audio or start microphone capture automatically. Setup can restore previously saved routes when started. This preview supports one routing account per Mac.

Verification and limits

The universal build and non-installing package inspection passed: architecture slices, macOS targets, expected installation paths, internal code signatures, root ownership, version consistency, and script syntax. Offline help/onboarding and isolated CLI tests passed during development. Local testing confirmed guitar/voice playback through Zoom and the virtual Return path.

A clean-machine package install, Developer ID signing/notarization, real Intel audio, and a remote lesson are not yet verified. Bluetooth monitoring has device latency. See the verification record.

The .sha256 file accompanies the installer for integrity checking. GitHub's source archives contain the tagged project; local personal routing files and build caches are excluded.