run sol on every device.

sol is the app — it lives on your devices, experiences your day with you, and keeps it all in your journal. get sol for each device you use: download it, or copy the prompt below into your coding agent and it handles the rest.

early days. sol on macOS and linux is in use today; sol for windows is in beta. it's working but still early — expect rough edges, especially around permissions and audio routing.

sol on macOS

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

takes in every connected display at 1 FPS
takes in system audio and microphone separately
runs as a menu bar app, starts at login

download for macOS

sets up sol and your journal on this Mac, then opens the first-run wizard.

signed by sol pbc, notarized by Apple. updates over a signed channel.

github → release notes →

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.

cd "$(sol root)/observers" && git clone https://github.com/solpbc/solstone-macos.git && cd solstone-macos

then read INSTALL.md and follow it.

sol on linux

linux desktop app — screen and audio, kept in your journal

takes in every monitor via PipeWire at 1 FPS
takes in microphone and system audio
detects idle, screen lock, and power save (GNOME)

github → release notes →

install solstone-linux — it runs sol on linux desktops using PipeWire and GStreamer: sol takes in your screen and audio along with you and keeps it in your journal.

on the linux desktop:

pipx install --system-site-packages solstone-linux
solstone-linux install-service
solstone-linux setup

the `--system-site-packages` flag is required — it reuses your distro's system PyGObject/GStreamer bindings (install them first per the repo's INSTALL.md) instead of rebuilding PyGObject from source, which fails on most distros with a `girepository-2.0` build error.

`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 journal host with `journal observer create <name>` and paste it during setup.)

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

cd "$(sol root)/observers" && git clone https://github.com/solpbc/solstone-linux.git && cd solstone-linux

sol on windows

windows app (beta) — screen and audio, kept in your journal

takes in your screen and system audio, mic when present
runs per-user in the tray — no admin install
pairs with the journal on your mac or linux machine

download for windows

downloads the signed installer, then pairs with your journal during setup.

signed by sol pbc. windows may show an "unknown publisher" or SmartScreen prompt while our signing reputation builds — expected for a new publisher; the signature is real.

github → release notes →

installed directly, sol updates itself; via scoop, run scoop update solstone.

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

+ add your terminal

solstone-tmux brings your tmux sessions into your journal — every active session and pane, every 5 seconds. lightweight, pure python, no system dependencies. works alongside sol on either desktop.

github →

install solstone-tmux — it takes in your tmux sessions along with you, what's on each active pane every 5 seconds, and keeps it in your journal. lightweight, pure python, no system dependencies.

on the device that runs tmux:

pipx install solstone-tmux
solstone-tmux install-service
solstone-tmux setup

`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-tmux setup --server-url <journal-url>`. (legacy fallback: mint a key on the journal host with `journal observer create <name>` and paste it during setup.)

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

cd "$(sol root)/observers" && git clone https://github.com/solpbc/solstone-tmux.git && cd solstone-tmux

more devices on the way

iPhone/iPad

sol for iPhone and iPad

in beta with testers

android

sol for android — beta builds reach testers through Firebase App Tester; public beta with the Play Store phase.

in beta with testers

release notes →