solstone home

install solstone on every device.

the solstone app takes in what you share with it, and all of it goes into your journal. install solstone on each device you use: download it, or copy the prompt below into your coding agent and it handles the rest.

early days. solstone 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.

solstone 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? the solstone app and the journal are two separate apps, and most people want both. both require Apple Silicon; Intel macs aren't supported.

download the solstone app download the journal

the solstone app takes in what you share with it here; the journal is where it all gets kept. already have a journal on another machine? the solstone app 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.

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

then read INSTALL.md and follow it.

solstone 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
  • notices when you step away, on GNOME, KDE, and X11 sessions
github → release notes → 
install solstone-linux, which sets up the solstone app on 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 from the latest release:
https://github.com/solpbc/solstone-linux/releases/latest

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 — 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, 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

+ 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 the solstone app 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 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-tmux.git && cd solstone-tmux
more devices on the way

iPhone/iPad

solstone for iphone and ipad

in beta with testers

android

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

in beta with testers

release notes →