solstone-linux 0.1.0__tar.gz → 0.2.0__tar.gz

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/AGENTS.md

@@ -146,13 +146,10 @@ Tests use pytest with standard mocking. No system dependencies required for test
 ## Brand canon
 
 - **solstone-linux is an observer.** Owner-facing canon describes solstone as observers + journal; sol is the keeper who lives in and tends your journal. In engineering architecture, `observers + sol agent + journal` is the running software this repo's code talks to. This repo implements one of those observers.
-- **The canon lives elsewhere.** Owner-facing terminology comes from sol pbc's internal brand canon (system anatomy + voice terminology guides). This repo's branded prose follows it; the canon itself is not vendored here.
 - **Use co-experience language in branded prose.** In README, INSTALL, onboarding text, settings copy, and error messages, describe solstone-linux as something that experiences screen and audio along with the owner. Never describe it as watching, recording, monitoring, or tracking the owner.
 - **Keep code language in code-only contexts.** Internal architecture terms such as `Capture loop`, the capture pipeline, module names, and data-path names are canon-permitted here and must not be renamed just to match branded prose.
 - **Edit with the surface in mind.** If the owner sees the string, follow the canon. If the text is naming code, pipelines, modules, or storage artifacts for engineers, the existing internal vocabulary stays.
 
-Canon source of truth: sol pbc's internal brand canon (system-anatomy guide).
-
 ## License
 
 AGPL-3.0-only -- Copyright (c) 2026 sol pbc

solstone_linux-0.2.0/CHANGELOG.md

@@ -0,0 +1,84 @@
+# Changelog
+
+All notable changes to solstone-linux are documented here.
+The format is based on Keep a Changelog (https://keepachangelog.com/),
+and this project adheres to Semantic Versioning.
+
+## [0.2.0] - 2026-06-13
+
+setup is now hands-off: the first time the observer runs, it connects itself
+to your journal automatically, with no separate key step.
+
+### Changed
+
+- **first run sets itself up.** earlier versions asked you to create and paste
+  a key to connect the observer to your journal. now the observer introduces
+  itself to your journal on first run and remembers the connection on its own.
+  you go straight from install to observing, with no manual key step.
+
+## [0.1.1] - 2026-06-02
+
+A focused maintenance release: two reliability fixes and a round of
+install-instruction corrections from fresh-machine testing on Fedora,
+Debian, and openSUSE.
+
+### Fixed
+
+- **Idle monitors no longer silently drop observations.** When a monitor
+  produced no frames during a segment (a static screen with nothing
+  changing on it), GStreamer still wrote a header-only WebM file. Those
+  empty files were finalized, uploaded, and then failed to process in your
+  journal — so that monitor's segment was lost without any signal. The
+  observer now drops these empty recordings at the source and emits an
+  `observe.stream_silent` event (logged at WARNING) so the gap is visible
+  instead of silent.
+- **Install no longer clobbers your system icon theme.** On GNOME,
+  `install-service` was writing a stray `index.theme` into the shared
+  hicolor icon directory, which shadowed the system index and caused
+  unrelated app icons to render as the solstone diamond. The installer now
+  drops only the solstone status icons (the system index already declares
+  their directory) and self-heals any previously broken install on the next
+  `install-service` run. A foreign or unreadable `index.theme` is left
+  untouched.
+
+### Documentation
+
+- Corrected the Fedora and Debian system-dependency lines after fresh-box
+  install testing: dropped packages that do not exist in their repos
+  (`gstreamer1-plugin-pipewire` on Fedora, `gir1.2-gdk-4.0` on Debian) and
+  hoisted the cairo / pycairo build toolchain onto the main install line so
+  a fresh install succeeds in one shot. Added `gstreamer1.0-tools` to the
+  Debian line — `gst-launch-1.0` is required for screen recording and is
+  not pulled in transitively.
+- Added a verified openSUSE dependency block and mirrored the corrected
+  dependency lists between `README.md` and `INSTALL.md`.
+- Updated the install path to lead with `pipx install solstone-linux`, then
+  `solstone-linux install-service`, then `solstone-linux setup`.
+
+### Internal
+
+- The release script now tags the commit and cuts a GitHub release only on
+  a production PyPI run; a TestPyPI run no longer leaves a tag or public
+  release behind.
+
+## [0.1.0] - 2026-05-19
+
+First public release of solstone-linux — the Linux desktop observer
+for your solstone journal.
+
+solstone-linux runs as a systemd user service in your GNOME Wayland
+session. It experiences screen and audio along with you, holds short
+segments locally, and uploads them to your journal in the background.
+
+### Install paths
+
+- From PyPI: `pipx install --system-site-packages solstone-linux`,
+  then `solstone-linux install-service` to register the systemd unit.
+- From a clone: `git clone` this repo and run `make install-service`
+  for development or unreleased changes.
+
+Both paths rely on host packages for PyGObject, GStreamer with the
+PipeWire plugin, PipeWire itself, `pactl`, and `xdg-desktop-portal`
+with ScreenCast support. PyGObject and the GStreamer bindings ride
+along from system site-packages — that is why `--system-site-packages`
+matters.

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/INSTALL.md

@@ -4,7 +4,7 @@ these instructions are for a coding agent and human working together. solstone-l
 
 solstone must already be installed and running. if it isn't, start there: https://solstone.app/install
 
-> **most users should run `sol observer install` from the solstone host instead of following this file by hand.** that one command handles the clone, the system-package preflight, the build, the registration, and the systemd unit — including a `--dry-run` mode to preview every step. the instructions below are for developers building from source or troubleshooting the install.
+> **most users install solstone-linux from PyPI in three commands** on the machine that will host the observer: `pipx install solstone-linux`, `solstone-linux install-service`, then `solstone-linux setup` (which prompts for your journal URL and auto-registers). if the observer machine can't reach your solstone host, mint a key from there first with `sol observer create <name>` and paste it during setup. the instructions below are for developers building from source or troubleshooting the install.
 
 ## before you begin
 
@@ -34,16 +34,18 @@ The observer connects to your solstone journal over HTTPS — colocation is opti
 
 ## install sequence
 
+this is the developer/from-source path; most installs should use the `pipx install solstone-linux` + `solstone-linux install-service` + `solstone-linux setup` flow described in the callout above.
+
 1. install system dependencies for your distro, including `pipx`. if you need sudo, walk your human through it.
 
    **fedora:**
    ```
-   sudo dnf install python3-gobject gtk4 gstreamer1-plugins-base gstreamer1-plugin-pipewire pipewire-gstreamer alsa-lib-devel pulseaudio-utils pipewire-pulseaudio xdg-desktop-portal pipx
+   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 gir1.2-gdk-4.0 gir1.2-gtk-4.0 gstreamer1.0-pipewire libasound2-dev pulseaudio-utils pipewire-pulse xdg-desktop-portal pipx
+   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:**
@@ -60,7 +62,11 @@ The observer connects to your solstone journal over HTTPS — colocation is opti
    ```
    note: package names diverge from Fedora — `typelib-1_0-Gtk-4_0` (not `gtk4`), `gstreamer-plugin-pipewire` (singular), and `alsa-devel` (not `alsa-lib-devel`).
 
-2. If you have local sol, cloning into `$(sol root)/observers` keeps observers colocated with your solstone journal. For remote-sol setups, clone anywhere — the observer runs independently of your journal at runtime:
+   the `cairo` headers + `gcc` + Python dev headers in the Fedora/Debian lines above are there because `pycairo` builds from source during install; without them the install fails with a compile error before you'd reach the Troubleshooting section. they're the same fixes listed under Troubleshooting, hoisted up so a fresh install works in one shot.
+
+   `uv` / `pipx`: Fedora packages both (`sudo dnf install uv pipx`); Debian/Ubuntu package `pipx` but not `uv`. the PyPI install flow only needs `pipx` — `uv` is optional and used by the from-source dev workflow in the Makefile.
+
+2. cloning into `$(sol root)/observers` is only a developer convenience for keeping observer checkouts colocated with a local solstone clone. for remote-sol setups, clone anywhere — the observer runs independently of your journal at runtime:
    ```
    cd "$(sol root)/observers"
    git clone https://github.com/solpbc/solstone-linux.git
@@ -73,7 +79,7 @@ The observer connects to your solstone journal over HTTPS — colocation is opti
    ```
    solstone-linux setup
    ```
-   this prompts for the journal URL and auto-registers via `sol` when available.
+   this prompts for the journal URL and registers the observer with your journal.
 
 4. verify the service is running:
    ```

solstone_linux-0.2.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: solstone-linux
+Version: 0.2.0
+Summary: Standalone Linux desktop observer for solstone
+License-Expression: AGPL-3.0-only
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: dbus-next
+Requires-Dist: numpy
+Requires-Dist: pygobject
+Requires-Dist: requests
+Requires-Dist: soundcard
+Requires-Dist: soundfile
+Description-Content-Type: text/markdown
+
+# solstone-linux
+
+Standalone Linux desktop observer for [solstone](https://solpbc.org). 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 libpulse alsa-lib xdg-desktop-portal pipx
+   ```
+
+   **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](https://solstone.app/install).
+
+On the machine that will host the observer:
+
+```bash
+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 directly, mint a key from there with `sol observer create <name>` and paste it during setup.
+
+### Developers building from source
+
+```bash
+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
+
+```bash
+solstone-linux setup
+```
+
+## Run
+
+```bash
+# Foreground
+solstone-linux run
+```
+
+## Status
+
+```bash
+solstone-linux status
+```
+
+## License
+
+AGPL-3.0-only — Copyright (c) 2026 sol pbc

solstone_linux-0.2.0/README.md

@@ -0,0 +1,75 @@
+# solstone-linux
+
+Standalone Linux desktop observer for [solstone](https://solpbc.org). 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 libpulse alsa-lib xdg-desktop-portal pipx
+   ```
+
+   **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](https://solstone.app/install).
+
+On the machine that will host the observer:
+
+```bash
+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 directly, mint a key from there with `sol observer create <name>` and paste it during setup.
+
+### Developers building from source
+
+```bash
+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
+
+```bash
+solstone-linux setup
+```
+
+## Run
+
+```bash
+# Foreground
+solstone-linux run
+```
+
+## Status
+
+```bash
+solstone-linux status
+```
+
+## License
+
+AGPL-3.0-only — Copyright (c) 2026 sol pbc

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "solstone-linux"
-version = "0.1.0"
+version = "0.2.0"
 description = "Standalone Linux desktop observer for solstone"
 readme = "README.md"
 license = "AGPL-3.0-only"

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/scripts/release.sh

@@ -89,6 +89,13 @@ fi
 TWINE_USERNAME=__token__ TWINE_PASSWORD="$TOKEN" \
   "${RUN[@]}" uvx twine upload "${REPOSITORY_ARGS[@]}" dist/*
 
+# Tag + GitHub release only for production. A TestPyPI dry-run should not leave
+# a git tag or a public release behind.
+if [[ "$TARGET" != "PyPI" ]]; then
+  echo "skipping git tag + GitHub release (TestPyPI run)"
+  exit 0
+fi
+
 TAG="v${VERSION}"
 "${RUN[@]}" git tag -a "$TAG" -m "solstone-linux ${VERSION}"
 if ! "${RUN[@]}" git push origin "$TAG"; then

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/src/solstone_linux/__init__.py

@@ -3,4 +3,4 @@
 
 """Standalone Linux desktop observer for solstone."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/src/solstone_linux/activity.py

@@ -24,6 +24,7 @@ from dbus_next.errors import (
 logger = logging.getLogger(__name__)
 
 _DBUS_PROBE_TIMEOUT_SEC = 2.0
+_POWER_SAVE_WARNED_BACKENDS: set[str] = set()
 
 _SERVICE_MISSING_ERRORS = (
     "org.freedesktop.DBus.Error.ServiceUnknown",
@@ -212,6 +213,22 @@ async def is_power_save_active(bus: MessageBus) -> bool:
 
     Returns True if power save is active, False otherwise.
     """
+
+    def log_backend_failure_once(backend: str, bus_name: str, path: str, exc) -> None:
+        level = logger.warning
+        if backend in _POWER_SAVE_WARNED_BACKENDS:
+            level = logger.debug
+        else:
+            _POWER_SAVE_WARNED_BACKENDS.add(backend)
+        level(
+            "is_power_save_active %s backend failed: service=%s path=%s: %s: %s",
+            backend,
+            bus_name,
+            path,
+            type(exc).__name__,
+            exc,
+        )
+
     # Try GNOME Mutter DisplayConfig first
     try:
         intro = await bus.introspect(DISPLAY_CONFIG_BUS, DISPLAY_CONFIG_PATH)
@@ -227,11 +244,10 @@ async def is_power_save_active(bus: MessageBus) -> bool:
         OSError,
     ) as exc:
         if not _is_service_missing(exc):
-            logger.warning(
-                "is_power_save_active Mutter backend failed: service=%s path=%s: %s: %s",
+            log_backend_failure_once(
+                "Mutter",
                 DISPLAY_CONFIG_BUS,
                 DISPLAY_CONFIG_PATH,
-                type(exc).__name__,
                 exc,
             )
 
@@ -248,13 +264,7 @@ async def is_power_save_active(bus: MessageBus) -> bool:
         OSError,
     ) as exc:
         if not _is_service_missing(exc):
-            logger.warning(
-                "is_power_save_active KDE backend failed: service=%s path=%s: %s: %s",
-                KDE_POWER_BUS,
-                KDE_POWER_PATH,
-                type(exc).__name__,
-                exc,
-            )
+            log_backend_failure_once("KDE", KDE_POWER_BUS, KDE_POWER_PATH, exc)
         return False
 
 

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/src/solstone_linux/cli.py

@@ -134,44 +134,23 @@ def cmd_setup(args: argparse.Namespace) -> int:
         )
         return 0
 
-    print(f"Stream: {config.stream}")
     save_config(config)
 
     if not config.key:
-        sol = shutil.which("sol")
-        if sol:
-            print("Registering via sol CLI...")
-            try:
-                result = subprocess.run(
-                    [sol, "observer", "--json", "create", config.stream],
-                    capture_output=True,
-                    text=True,
-                    timeout=10,
-                )
-                if result.returncode == 0:
-                    data = json.loads(result.stdout)
-                    config.key = data["key"]
-                    save_config(config)
-                    print(f"Registered (key: {config.key[:8]}...)")
-                else:
-                    print("CLI registration failed, trying HTTP...")
-            except (subprocess.TimeoutExpired, json.JSONDecodeError, KeyError, OSError):
-                print("CLI registration failed, trying HTTP...")
-
-        if not config.key:
-            print("Registering with your journal...")
-            client = UploadClient(config)
-            if client.ensure_registered(config):
-                config = load_config()
-                print(f"Registered (key: {config.key[:8]}...)")
-            else:
-                print(
-                    "Warning: registration failed. Run setup again when your journal is available."
-                )
-                if non_interactive:
-                    return 1
+        print("Registering with your journal...")
+        client = UploadClient(config)
+        if client.ensure_registered(config):
+            print(f"Registered (key: {config.key[:8]}...)")
+            print(f"Stream: {config.stream}")
+        else:
+            print(
+                "Warning: registration failed. Run setup again when your journal is available."
+            )
+            if non_interactive:
+                return 1
     else:
         print(f"Already registered (key: {config.key[:8]}...)")
+        print(f"Stream: {config.stream}")
 
     print(f"\nConfig saved to {config.config_path}")
     print(f"Captures will go to {config.captures_dir}")
@@ -203,46 +182,24 @@ def _cmd_setup_interactive() -> int:
         except ValueError as e:
             print(f"Error deriving stream name: {e}", file=sys.stderr)
             return 1
-    print(f"Stream: {config.stream}")
 
     # Save config before registration (so URL is persisted)
     config.ensure_dirs()
     save_config(config)
 
-    # Auto-register — try sol CLI first (no server needed), fall back to HTTP
     if not config.key:
-        sol = shutil.which("sol")
-        if sol:
-            print("Registering via sol CLI...")
-            try:
-                result = subprocess.run(
-                    [sol, "observer", "--json", "create", config.stream],
-                    capture_output=True,
-                    text=True,
-                    timeout=10,
-                )
-                if result.returncode == 0:
-                    data = json.loads(result.stdout)
-                    config.key = data["key"]
-                    save_config(config)
-                    print(f"Registered (key: {config.key[:8]}...)")
-                else:
-                    print("CLI registration failed, trying HTTP...")
-            except (subprocess.TimeoutExpired, json.JSONDecodeError, KeyError, OSError):
-                print("CLI registration failed, trying HTTP...")
-
-        if not config.key:
-            print("Registering with your journal...")
-            client = UploadClient(config)
-            if client.ensure_registered(config):
-                config = load_config()
-                print(f"Registered (key: {config.key[:8]}...)")
-            else:
-                print(
-                    "Warning: registration failed. Run setup again when your journal is available."
-                )
+        print("Registering with your journal...")
+        client = UploadClient(config)
+        if client.ensure_registered(config):
+            print(f"Registered (key: {config.key[:8]}...)")
+            print(f"Stream: {config.stream}")
+        else:
+            print(
+                "Warning: registration failed. Run setup again when your journal is available."
+            )
     else:
         print(f"Already registered (key: {config.key[:8]}...)")
+        print(f"Stream: {config.stream}")
 
     print(f"\nConfig saved to {config.config_path}")
     print(f"Captures will go to {config.captures_dir}")
@@ -321,15 +278,31 @@ def cmd_install_service(args: argparse.Namespace) -> int:
                 shutil.copy2(svg, status_dir / svg.name)
                 print(f"Installed {status_dir / svg.name}")
 
-        # Copy index.theme only if one doesn't already exist
-        index_dest = icon_dest / "index.theme"
-        if not index_dest.exists():
-            shutil.copy2(icon_source / "index.theme", index_dest)
-            print(f"Wrote {index_dest}")
+        # Self-heal: earlier installs copied a solstone index.theme into this
+        # shared hicolor dir. Because the user icon dir out-ranks
+        # /usr/share/icons, that file shadowed the system hicolor index (which
+        # declares ~649 dirs) with one that declared only scalable/status, so
+        # every unrelated app-icon lookup fell back to hicolor, missed, and
+        # rendered as our diamond. Remove only our own file — matched on the
+        # exact "Name=solstone" line — and never touch a foreign index.theme.
+        legacy_index = icon_dest / "index.theme"
+        if legacy_index.exists():
+            try:
+                content = legacy_index.read_text()
+            except (OSError, UnicodeDecodeError):
+                print(f"Left existing icon theme index in place: {legacy_index}")
+            else:
+                if "Name=solstone" in content.splitlines():
+                    legacy_index.unlink()
+                    print(f"Removed stale solstone icon theme index: {legacy_index}")
 
-        # Update icon cache (non-fatal)
+        # Refresh the icon cache (non-fatal). --ignore-theme-index keeps it
+        # quiet now that this dir ships no index.theme of its own.
         try:
-            subprocess.run(["gtk-update-icon-cache", str(icon_dest)], check=False)
+            subprocess.run(
+                ["gtk-update-icon-cache", "--ignore-theme-index", str(icon_dest)],
+                check=False,
+            )
         except FileNotFoundError:
             pass
 

{solstone_linux-0.1.0 → solstone_linux-0.2.0}/src/solstone_linux/observer.py

@@ -42,7 +42,7 @@ from .audio_recorder import AudioRecorder
 from .chat_bridge import run_chat_bridge
 from .config import Config
 from .recovery import write_segment_metadata
-from .screencast import Screencaster, StreamInfo
+from .screencast import Screencaster, SilentStream, StreamInfo
 from .sync import SyncService
 from .upload import UploadClient
 
@@ -162,6 +162,7 @@ class Observer:
         self._client = UploadClient(self.config)
         if self.config.server_url:
             self._client.ensure_registered(self.config)
+        self.stream = self.config.stream
         self._sync = SyncService(self.config, self._client)
 
         from .dbus_service import BUS_NAME, OBJECT_PATH, ObserverService
@@ -317,7 +318,9 @@ class Observer:
         # Stop screencast first (closes file handles)
         if self.current_mode == MODE_SCREENCAST:
             logger.info("Stopping previous screencast")
-            await self.screencaster.stop()
+            healthy, silent = await self.screencaster.stop()
+            for s in silent:
+                self._emit_stream_silent(s)
             self.current_streams = []
 
         # Save audio if we have enough threshold hits
@@ -389,6 +392,24 @@ class Observer:
 
         return True
 
+    def _emit_stream_silent(self, silent: SilentStream) -> None:
+        if self._client is None:
+            return
+        segment_dir_basename = self.segment_dir.name if self.segment_dir else ""
+        duration_seconds = int(time.time() - self.start_at) if self.start_at else 0
+        self._client.relay_event(
+            "observe",
+            "stream_silent",
+            connector=silent.connector,
+            position=silent.position,
+            node_id=silent.node_id,
+            file_bytes=silent.file_bytes,
+            segment_dir=segment_dir_basename,
+            duration_seconds=duration_seconds,
+            host=HOST,
+            platform=PLATFORM,
+        )
+
     def emit_status(self):
         """Emit observe.status event with current state (fire-and-forget)."""
         if not self._client:
@@ -437,7 +458,6 @@ class Observer:
             activity=activity_info,
             host=HOST,
             platform=PLATFORM,
-            stream=self.stream,
         )
 
     def _refresh_tray(self):
@@ -551,7 +571,9 @@ class Observer:
                 if self._paused:
                     if self.segment_dir:
                         if self.current_mode == MODE_SCREENCAST:
-                            await self.screencaster.stop()
+                            healthy, silent = await self.screencaster.stop()
+                            for s in silent:
+                                self._emit_stream_silent(s)
                             self.current_streams = []
                         if self.threshold_hits >= MIN_HITS_FOR_SAVE:
                             self._save_audio_segment(
@@ -603,7 +625,9 @@ class Observer:
                     and not self.screencaster.is_healthy()
                 ):
                     logger.warning("Screencast recording failed, stopping gracefully")
-                    await self.screencaster.stop()
+                    healthy, silent = await self.screencaster.stop()
+                    for s in silent:
+                        self._emit_stream_silent(s)
                     self.current_streams = []
                     self.current_mode = MODE_IDLE
 
@@ -692,7 +716,9 @@ class Observer:
         # Stop screencast first (closes file handles)
         if self.current_mode == MODE_SCREENCAST:
             logger.info("Stopping screencast for shutdown")
-            await self.screencaster.stop()
+            healthy, silent = await self.screencaster.stop()
+            for s in silent:
+                self._emit_stream_silent(s)
             await asyncio.sleep(0.5)
 
         # Save final audio if threshold met