Set up both ends.

Start with the desktop receiver, then install the companion. Public signed installers and store listings are not available yet.

Build the desktop preview

Install Node.js 22+ and npm 10+. Clone the FoneStream repository, then run:

npm ci
npm run build
npm run dev

To make a package, run npm run package -w @phonestream/desktop -- --publish never on its target operating system. This does not sign or notarize a build without credentials.

macOS

Choose Apple Silicon for M-series Macs or Intel for x64 Macs. A published DMG installs by dragging FoneStream into Applications; ZIP builds should be extracted first. Check origin and signing status before opening a development build.

Windows

Use the x64 installer or extract the portable ZIP into a writable folder. Unsigned development builds can trigger SmartScreen. Do not treat an unsigned build as a verified production release.

Linux

AppImage and Debian packages target x64. Give a trusted AppImage permission to execute in file properties, then run it. Use your package manager for the Debian package. The current distribution validation target is Ubuntu 24.04.

Install the companion

Android development APK instructions · iPhone signing and installation

Network permission

Allow the receiver on your trusted local network. The pairing service uses TCP 47839; OBS output uses loopback TCP 47840. Guest networks may prevent local devices from reaching one another.

Next: make your first capture.