install solstone on every device.

solstone on macOS

native macOS app, with screen and audio kept in your journal

• what you share from every connected display goes into your journal at 1 FPS
• what you share from system audio and microphone goes into your journal separately
• runs as a menu bar app, starts at login

developer build (build from source). most people should download the DMG above. this path requires Xcode (full IDE, not just command line tools) and is here for developers who want to build, modify, or hand the install to a coding agent.

git clone https://github.com/solpbc/solstone-macos.git && cd solstone-macos

then read INSTALL.md and follow it.

solstone on linux

x86_64 linux desktop app, with screen and audio kept in your journal

• what you share from every monitor goes into your journal via PipeWire at 1 FPS
• what you share from microphone and system audio goes into your journal
• screen and audio pause when you step away, on GNOME, KDE, and X11 sessions

verify the signed release manifest before you install. apt and dnf do not check our minisign signature.

install solstone-linux, which sets up the solstone app on x86_64 linux desktops using PipeWire and GStreamer. the solstone app takes in your screen and audio along with you, and it all goes into your journal.

on the linux desktop, download the package for your distro, the *.rust-release-manifest.json file, and its adjacent .minisig file from the latest release:
https://github.com/solpbc/solstone-linux/releases/latest

verify first. minisign authenticates the manifest; then check the package against the authenticated digest. replace <downloaded-package> with its exact filename. you run both checks; apt and dnf do not:
curl -fLo solstone-linux-release.pub https://updates.solstone.app/solstone-linux/minisign.pub
minisign -Vm solstone-linux-<VERSION>-linux-x86_64.rust-release-manifest.json -p solstone-linux-release.pub
jq -r --arg package '<downloaded-package>' '.artifacts[] | select(.path == $package) | "\(.sha256)  \(.path)"' solstone-linux-<VERSION>-linux-x86_64.rust-release-manifest.json | sha256sum -c -

if either command refuses the files, stop. then install:
debian / ubuntu:   sudo apt install ./solstone-linux_<VERSION>-1_amd64.deb
fedora / rhel:     sudo dnf install ./solstone-linux-<VERSION>-1.x86_64.rpm

then:

solstone-linux install-service
solstone-linux setup

solstone-linux needs PipeWire, GStreamer (core, base, good, pipewire, x11), xdg-desktop-portal and xdg-utils on the desktop first. the repo's INSTALL.md lists the exact package names for debian, fedora, arch and openSUSE.

`setup` registers this device with your journal over the local http://localhost:5015 link, so there's no URL to type. if this device reaches your journal directly instead, run `solstone-linux setup --server-url <journal-url>`. (legacy fallback: mint a key on the machine that keeps your journal with `journal observer create <name>` and paste it during setup.)

building from source instead? (developers only) clone the repo and follow its INSTALL.md:

git clone https://github.com/solpbc/solstone-linux.git && cd solstone-linux

solstone on windows

windows app, with screen and audio kept in your journal

• what you share from your screen, system audio, and mic when present goes into your journal
• runs per-user in the tray, with no admin install
• pairs with the journal on your mac or linux machine

installed directly, the solstone app updates itself; via winget, run winget upgrade solstone; via scoop, run scoop update solstone.

winget install solstone

scoop bucket add solstone https://github.com/solpbc/scoop-solstone
scoop install solstone