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, linux, and windows is in use today — open source and hands-on. expect rough edges, and we'll fix them together as we go.

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

setting up a new Mac? sol and the journal are separate apps — most people want both.

download sol download the journal

sol experiences your day here; the journal is where it all gets kept. already have a journal on another machine? sol alone connects to it.

both signed by sol pbc, notarized by Apple. each updates over its own 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 — 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 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

+ 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 →