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. 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
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.
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)
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
+ 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.
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
windows
sol for windows — screen and audio
in beta
iPhone/iPad
sol for iPhone and iPad
in beta with testers
android
sol for android
in beta with testers