PocketAudio

Hear your Mac or PC speakers on your phone over Wi‑Fi or publicly via ngork. Tap Listen in the browser.

Download (ready-to-use)

Pre-built releases (server + web UI, no compiler needed):

Download	Platform
PocketAudio-macos-arm64.zip	macOS 15+ (Apple Silicon)
PocketAudio-windows-x64.zip	Windows 10/11 (64-bit)

1. Download and unzip the zip for your OS.
2. Open the folder — inside you’ll find pocket-audio-server (or .exe), a web/ folder, and START.txt.
3. Follow Run it below (use the unzipped folder instead of building from source).

You need

• macOS 15+ or Windows 11
• Phone on the same Wi‑Fi as the PC
• Mac: Screen Recording allowed for Terminal (System Settings → Privacy & Security)

Run it

Works the same whether you use a release zip or built from source.

Terminal 1 — server (folder with pocket-audio-server or pocket-audio-server.exe):

./pocket-audio-server

On Windows:

.\pocket-audio-server.exe

Terminal 2 — web (the web folder next to the server — in the zip or repo):

cd web
python3 -m http.server 8080 --bind 0.0.0.0

cd web
npx --yes serve -l tcp://0.0.0.0:8080

Phone: http://YOUR_PC_IP:8080/ — play audio on the computer, tap Listen.

Audio WebSocket: ws://YOUR_PC_IP:9000 (no HTTPS, no certs). Use your Mac or Windows LAN IP.

Build (macOS)

mkdir -p build && cd build
cmake ..
cmake --build .

The server binary is build/pocket-audio-server.

Build (Windows)

You need:

• Windows 11 (or Windows 10 with current updates)
• Visual Studio 2022 (or Build Tools for Visual Studio) with the Desktop development with C++ workload
• CMake 3.16+ (cmake.org or winget install Kitware.CMake)
• Git (for CMake to fetch ixwebsocket)

Open Developer PowerShell for VS 2022 (or any shell where cl and cmake work), then from the repo root:

mkdir build
cd build
cmake ..
cmake --build . --config Release

The executable is:

build\Release\pocket-audio-server.exe

(On a single-config generator it may be build\pocket-audio-server.exe instead.)

Run on Windows

Terminal 1 — server (from build\Release or wherever the .exe is):

.\pocket-audio-server.exe

You should see listening on 0.0.0.0:9000. Leave this window open.

Terminal 2 — web UI (from the repo web folder):

cd web
python -m http.server 8080 --bind 0.0.0.0

Or with Node:

cd web
npx --yes serve -l tcp://0.0.0.0:8080

Phone or another PC: open http://YOUR_PC_IP:8080/ (replace with the Windows machine’s LAN IP, e.g. from ipconfig), play audio on the PC, tap Listen.

• WebSocket: ws://YOUR_PC_IP:9000
• If the phone cannot connect, allow port 9000 (and 8080 for the web page) in Windows Defender Firewall for pocket-audio-server.exe or for private networks.
• For best quality, set Windows sound output to 48000 Hz (Settings → System → Sound → your output device → Properties → Advanced).

Auto-start on Windows (recommended)

Use the logon task — runs in your user session so WASAPI speaker capture works.
Do not use the Windows service for audio (Session 0 = silence).

Install (PowerShell, from repo scripts folder):

cd scripts
.\install-logon-task.ps1 -StartNow -AddFirewallRule

If the .exe is not auto-detected:

.\install-logon-task.ps1 -ExePath "C:\full\path\build\Release\pocket-audio-server.exe" -StartNow -AddFirewallRule

Flag	Purpose
-StartNow	Start the server immediately after install
-AddFirewallRule	Allow inbound TCP 9000 (Private/Domain networks)

Check status:

.\status-logon-task.ps1

Should show Port 9000: LISTENING and Last result: 0.

Log file: %LOCALAPPDATA%\PocketAudio\server.log

Remove:

.\uninstall-logon-task.ps1

The task runs at every sign-in, restarts up to 3 times if it crashes, and keeps running in the background (no console window).

Windows service (--install-service) is only for non-audio use — it cannot capture desktop speakers reliably.

Layout

server/          C++ app (capture + WebSocket)
  main.cpp
  core/          format, chunks, ports
  capture/       Mac / Windows audio in
  network/       WebSocket out
web/             browser UI

Problems

• Can't connect — server running? Same Wi‑Fi? Firewall open on port 9000?
• No sound — volume on PC and phone; tap Listen again.