solstone needs to experience your life with you.

solstone doesn't observe anything on its own — it needs an observer to experience your day along with you. pick the one for your platform, copy the prompt below into your coding agent, and it handles the rest.

early days. macOS and linux observers are in use today. they're working but still early — expect rough edges, especially around permissions and audio routing.

solstone-macos

native macOS screen and audio observer

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

download for macOS

the macOS observer. sets up sol and your journal for you, 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.

solstone-linux

linux desktop screen and audio observer

observes 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 the solstone-linux observer — it experiences your screen and audio along with you on linux desktops using PipeWire and GStreamer, and sends to your journal.

on the machine that will host the observer:

pipx install solstone-linux
solstone-linux install-service
solstone-linux setup

`setup` prompts for your journal URL and registers the observer for you. if this machine can't reach your solstone host, mint a key from there with `sol 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

coming soon

windows

native windows screen and audio observer

planning stages

iPhone/iPad

for multiple sensors

active development

android

for multiple sensors

next in roadmap

+ add a terminal observer

solstone-tmux observes all active tmux sessions and panes every 5 seconds. lightweight, pure python, no system dependencies. works alongside either desktop observer.

github →

install the solstone-tmux observer — it experiences your tmux sessions along with you, taking in what's on each pane every 5 seconds. lightweight, pure python, no system dependencies.

on the machine that will host the observer:

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

`setup` prompts for your journal URL and registers the observer for you. if this machine can't reach your solstone host, mint a key from there with `sol 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