solstone-linux#

Standalone Linux desktop observer for solstone. Captures screen and audio from a GNOME Wayland session, stores segments locally, and syncs to a solstone server.

Note: Activity detection (idle timeout, screen lock, power save) currently requires a GNOME desktop. On other desktops (KDE, Sway, Hyprland, XFCE), screen and audio capture works but activity-based segment boundaries won't trigger.

System Dependencies#

Fedora:

dnf install python3-gobject gtk4 gstreamer1-plugins-base gstreamer1-plugin-pipewire pipewire-gstreamer alsa-lib-devel pulseaudio-utils pipewire-pulseaudio

Debian/Ubuntu:

apt install python3-gi gir1.2-gdk-4.0 gir1.2-gtk-4.0 gstreamer1.0-pipewire libasound2-dev pulseaudio-utils pipewire-pulse

Arch:

pacman -S python-gobject gtk4 gstreamer gst-plugin-pipewire libpulse alsa-lib

Install#

Packages are not yet on PyPI. Install from source:

git clone https://github.com/solpbc/solstone-linux.git
cd solstone-linux
pipx install --system-site-packages .

--system-site-packages is required for PyGObject/GStreamer access.

Setup#

solstone-linux setup

Run#

# Foreground
solstone-linux run

# As a systemd user service
solstone-linux install-service

Status#

solstone-linux status

License#

AGPL-3.0-only — Copyright (c) 2026 sol pbc