Standalone Linux desktop observer for solstone
Project description
solstone-linux
Standalone Linux desktop observer for solstone. Experiences your screen and audio along with you on a GNOME Wayland session, stores segments locally, and syncs to your solstone journal.
Note: Activity detection (idle timeout, screen lock, power save) currently requires a GNOME desktop. On other desktops (KDE, Sway, Hyprland, XFCE), the observer still experiences your screen and audio, but activity-based segment boundaries won't trigger.
System Dependencies
Fedora:
sudo dnf install python3-gobject python3-cairo gtk4 gstreamer1-plugins-base pipewire-gstreamer alsa-lib-devel pulseaudio-utils pipewire-pulseaudio xdg-desktop-portal pipx gcc python3-devel pkgconf-pkg-config cairo-devel cairo-gobject-devel
Debian / Ubuntu:
sudo apt install python3-gi python3-cairo gir1.2-gtk-4.0 gstreamer1.0-pipewire gstreamer1.0-tools libasound2-dev pulseaudio-utils pipewire-pulse xdg-desktop-portal pipx gcc python3-dev pkg-config libcairo2-dev
Arch:
sudo pacman -S python-gobject gtk4 gstreamer gst-plugin-pipewire gst-plugins-good libpulse alsa-lib xdg-desktop-portal python-pipx uv python-cairo
openSUSE:
sudo zypper install python3-gobject python3-gobject-Gdk typelib-1_0-Gtk-4_0 gtk4-tools gstreamer-plugins-base gstreamer-plugin-pipewire pipewire-pulseaudio pulseaudio-utils alsa-devel xdg-desktop-portal python3-pipx
Install
solstone (the journal) must already be installed and running on the host this observer reports to. If it isn't, start with the journal install.
On the machine that will host the observer:
pipx install solstone-linux
solstone-linux install-service
solstone-linux setup
setup registers the observer against your journal over the local http://localhost:5015 link, so there's no URL to type. If this machine reaches your solstone host 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.)
Developers building from source
git clone https://github.com/solpbc/solstone-linux.git
cd solstone-linux
make install-service
solstone-linux setup
See INSTALL.md for distro packages, tray notes, and troubleshooting details.
Setup
solstone-linux setup
Run
# Foreground
solstone-linux run
Status
solstone-linux status
License
AGPL-3.0-only — Copyright (c) 2026 sol pbc
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file solstone_linux-0.4.0.tar.gz.
File metadata
- Download URL: solstone_linux-0.4.0.tar.gz
- Upload date:
- Size: 118.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0818d9b33514ae7167022197d92eb4fb91f68e1ec1bf3a1120d0327158111d2b
|
|
| MD5 |
1c2fcace728a3af070220d825f4fe557
|
|
| BLAKE2b-256 |
5c493ce054fe840738df461796b1dda6731c6025bf263dfba43d1336c3c2c42a
|
File details
Details for the file solstone_linux-0.4.0-py3-none-any.whl.
File metadata
- Download URL: solstone_linux-0.4.0-py3-none-any.whl
- Upload date:
- Size: 86.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d2ff4bf14347d82647f12e2a083e3c889569cf0c97244b868eb3e86d287415a3
|
|
| MD5 |
4c8a1969e046f8c2c609a3d0dc53f8df
|
|
| BLAKE2b-256 |
53c03a53ce269cb03cabd9c7814b99621e5de07461f73b252f23ded90355839d
|
