mini-eq 0.3.2__tar.gz → 0.4.0__tar.gz

{mini_eq-0.3.2 → mini_eq-0.4.0}/AGENTS.md

@@ -79,6 +79,13 @@ are unavailable.
   only when the user asked for that refactor or the change needs it.
 - Keep WirePlumber 0.4 and 0.5 compatibility in mind. Do not use a newer GI API
   without checking the compatibility layer and tests.
+- Treat the Mini EQ D-Bus control interface as a project-internal app/Shell
+  extension contract with version-skew tolerance. Keep `api_version = 1`
+  additive only: add state fields, methods, and capabilities when needed, but do
+  not remove or rename existing v1 members. Gate optional Shell extension
+  behavior on `capabilities`. Bump the API version only for semantic breaks, and
+  support the old version for a short, documented release window before removing
+  it.
 - Keep the `mini-eq` CLI user-oriented. Maintainer automation belongs in
   `tools/`, `docs/`, or this file.
 - Keep the GNOME Shell extension source in `extensions/gnome-shell/`; do not
@@ -159,7 +166,10 @@ During release preparation, verify that version-bearing files agree:
 URL. The package `__version__` is derived from release metadata and should not
 be hardcoded separately.
 
-Before publishing artifacts, run a focused leak scan:
+Before publishing artifacts, run `tools/release_preflight.py`; its focused leak
+scan covers `HEAD`, tracked worktree changes, and untracked non-ignored text
+files. If reproducing the scan manually, check all three surfaces instead of
+only committed history:
 
 ```bash
 git rev-list --count HEAD
@@ -171,6 +181,14 @@ git grep -n -I -E "$leak_pattern" HEAD -- . \
   ':(exclude)AGENTS.md' \
   ':(exclude)docs/release.md' \
   ':(exclude)tools/release_preflight.py'
+git grep -n -I -E "$leak_pattern" -- . \
+  ':(exclude)*.png' \
+  ':(exclude)AGENTS.md' \
+  ':(exclude)docs/release.md' \
+  ':(exclude)tools/release_preflight.py'
+git ls-files --others --exclude-standard -z -- . \
+  | grep -z -v -E '(^|/)(AGENTS\.md|docs/release\.md|tools/release_preflight\.py)$|\.png$' \
+  | xargs -0 -r grep -n -I -E "$leak_pattern" --
 ```
 
 Do not push local scratch branches or local safety tags.

{mini_eq-0.3.2 → mini_eq-0.4.0}/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.4.0 - 2026-05-05
+
+- Add opt-in background mode so closing the window can keep Mini EQ active.
+- Add Start at Login support through the Background portal in Flatpak and XDG
+  autostart for native installs.
+- Add D-Bus state fields and a Quit method for Shell extension compatibility.
+- Keep GNOME event sounds, notifications, and other system streams out of
+  system-wide EQ routing.
+- Route streams by writing both PipeWire `target.node` and `target.object`
+  metadata, avoiding metadata readback as a routing acknowledgement.
+
 ## 0.3.2 - 2026-05-04
 
 - Fix Flatpak system-wide routing by requesting PipeWire manager access from the WirePlumber client.

{mini_eq-0.3.2/src/mini_eq.egg-info → mini_eq-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-eq
-Version: 0.3.2
+Version: 0.4.0
 Summary: Compact PipeWire system-wide parametric equalizer for Linux desktops.
 Author: bhack
 License-Expression: GPL-3.0-or-later
@@ -68,6 +68,8 @@ libebur128 is available, the monitor can also show live LUFS loudness.
   compatibility layer.
 - Per-output preset links for automatically using different saved presets with
   headphones, speakers, HDMI, and other outputs.
+- Optional background mode keeps the EQ active after closing the window, with a
+  separate Start at Login preference.
 - Optional GNOME Shell extension for quick panel access to routing, EQ,
   analyzer status, presets, and output preset links.
 - Equalizer APO preset import from the UI or `--import-apo`, including

{mini_eq-0.3.2 → mini_eq-0.4.0}/README.md

@@ -25,6 +25,8 @@ libebur128 is available, the monitor can also show live LUFS loudness.
   compatibility layer.
 - Per-output preset links for automatically using different saved presets with
   headphones, speakers, HDMI, and other outputs.
+- Optional background mode keeps the EQ active after closing the window, with a
+  separate Start at Login preference.
 - Optional GNOME Shell extension for quick panel access to routing, EQ,
   analyzer status, presets, and output preset links.
 - Equalizer APO preset import from the UI or `--import-apo`, including

{mini_eq-0.3.2 → mini_eq-0.4.0}/data/io.github.bhack.mini-eq.metainfo.xml

@@ -34,11 +34,11 @@
   </description>
   <screenshots>
     <screenshot type="default">
-      <image>https://raw.githubusercontent.com/bhack/mini-eq/v0.3.2/docs/screenshots/mini-eq.png</image>
+      <image>https://raw.githubusercontent.com/bhack/mini-eq/v0.4.0/docs/screenshots/mini-eq.png</image>
       <caption>Adjust sound output with equalizer controls</caption>
     </screenshot>
     <screenshot>
-      <image>https://raw.githubusercontent.com/bhack/mini-eq/v0.3.2/docs/screenshots/mini-eq-dark.png</image>
+      <image>https://raw.githubusercontent.com/bhack/mini-eq/v0.4.0/docs/screenshots/mini-eq-dark.png</image>
       <caption>Use the equalizer with dark style</caption>
     </screenshot>
   </screenshots>
@@ -46,6 +46,15 @@
   <url type="bugtracker">https://github.com/bhack/mini-eq/issues</url>
   <url type="vcs-browser">https://github.com/bhack/mini-eq</url>
   <releases>
+    <release version="0.4.0" date="2026-05-05">
+      <description>
+        <ul>
+          <li>Add background mode and Start at Login support.</li>
+          <li>Keep GNOME event sounds and notifications out of system-wide EQ routing.</li>
+          <li>Add Shell extension controls for showing and quitting the background app.</li>
+        </ul>
+      </description>
+    </release>
     <release version="0.3.2" date="2026-05-04">
       <description>
         <ul>

{mini_eq-0.3.2 → mini_eq-0.4.0}/docs/release.md

@@ -68,6 +68,11 @@ extension source changed since the relevant release tag. If it reports that an
 upload may be needed, test the extension and upload the generated zip to
 extensions.gnome.org after the release is ready.
 
+The preflight also prints a Flatpak background portal smoke notice when
+background mode, Start at Login, hidden-window lifecycle, Shell control, or
+Flatpak integration paths changed. That notice is change-aware; do the manual
+portal smoke only for releases that touch those paths.
+
 ## Check Locally
 
 ```bash
@@ -118,9 +123,32 @@ crash and streams are restored:
 flatpak run io.github.bhack.mini-eq//master --auto-route
 ```
 
+For background portal changes, run one clean-permission Flatpak smoke in a real
+GNOME session:
+
+```bash
+flatpak permission-remove background background io.github.bhack.mini-eq || true
+flatpak run --command=flathub-build org.flatpak.Builder --install io.github.bhack.mini-eq.yaml
+flatpak run io.github.bhack.mini-eq//master
+```
+
+Then enable **Keep Running in Background**, approve the portal prompt, enable
+**Start at Login**, close the window, and confirm the app stays available from
+the GNOME Shell extension. Use the Shell extension's **Show Mini EQ** and
+**Quit Mini EQ** actions to verify hidden-window recovery and full exit.
+
 There is also an experimental non-blocking GitHub Actions path for this check:
-manually dispatch the `CI` workflow with `flatpak_runtime_smoke=true`. Treat it
-as extra signal only until it has proven stable in the hosted runner.
+manually dispatch the `CI` workflow with `flatpak_runtime_smoke=true` and, when
+iterating only on the smoke harness, `smoke_only=true`. For quick harness
+iterations against the published Flathub app, use `flatpak_runtime_build=false`,
+`flatpak_runtime_install_remote=true`, and the default blank
+`flatpak_runtime_app_ref` so the harness runs the installed Flathub ref. Set
+`flatpak_runtime_expected_version` when using the published app, because Flathub
+metadata can lag after an update. Leave `flatpak_runtime_build=true` for any
+release check that must test current source or the local manifest. Use hosted
+smoke as the validation for harness-only CI changes and as extra release signal;
+keep the local runtime smoke as the release check when app/runtime routing
+behavior changed.
 
 ## Build
 
@@ -170,7 +198,17 @@ documentation.
 
 ## Security
 
-Before publishing release artifacts, run a focused leak scan:
+Before publishing release artifacts, run the full preflight. Its focused leak
+scan covers `HEAD`, tracked worktree changes, and untracked non-ignored text
+files, so run it again after any release-process edits:
+
+```bash
+python3 tools/release_preflight.py
+```
+
+If reproducing the scan manually, check committed history, the tracked worktree,
+and untracked non-ignored files. Do not rely on a `HEAD`-only scan before
+committing release files:
 
 ```bash
 git rev-list --count HEAD
@@ -182,6 +220,14 @@ git grep -n -I -E "$leak_pattern" HEAD -- . \
   ':(exclude)AGENTS.md' \
   ':(exclude)docs/release.md' \
   ':(exclude)tools/release_preflight.py'
+git grep -n -I -E "$leak_pattern" -- . \
+  ':(exclude)*.png' \
+  ':(exclude)AGENTS.md' \
+  ':(exclude)docs/release.md' \
+  ':(exclude)tools/release_preflight.py'
+git ls-files --others --exclude-standard -z -- . \
+  | grep -z -v -E '(^|/)(AGENTS\.md|docs/release\.md|tools/release_preflight\.py)$|\.png$' \
+  | xargs -0 -r grep -n -I -E "$leak_pattern" --
 ```
 
 Keep these GitHub security features enabled in Settings > Advanced Security:

{mini_eq-0.3.2 → mini_eq-0.4.0}/extensions/gnome-shell/mini-eq@bhack.github.io/extension.js

@@ -69,6 +69,7 @@ class MiniEqIndicator extends PanelMenu.Button {
         this._running = false;
         this._routed = false;
         this._eqEnabled = false;
+        this._capabilities = new Set();
         this.visible = false;
 
         const box = new St.BoxLayout({
@@ -119,6 +120,11 @@ class MiniEqIndicator extends PanelMenu.Button {
         });
         this.menu.addMenuItem(openItem);
 
+        this._quitItem = new PopupMenu.PopupMenuItem(_('Quit Mini EQ'));
+        this._quitItem.visible = false;
+        this._quitItem.connect('activate', () => this._quitMiniEq());
+        this.menu.addMenuItem(this._quitItem);
+
         this._signalId = Gio.DBus.session.signal_subscribe(
             BUS_NAME,
             INTERFACE_NAME,
@@ -292,6 +298,16 @@ class MiniEqIndicator extends PanelMenu.Button {
         this._call('PresentWindow', null, null, () => {});
     }
 
+    _quitMiniEq() {
+        this._call('Quit', null, null, () => {
+            this._setDisconnectedState();
+            this._scheduleRefresh(500);
+        }, () => {
+            this._quitItem.visible = false;
+            this._scheduleRefresh(500);
+        });
+    }
+
     _showWindow(event) {
         const app = Shell.AppSystem.get_default().lookup_app(APP_DESKTOP_ID);
         const windows = app?.get_windows().filter(window => !window.skip_taskbar) ?? [];
@@ -322,6 +338,9 @@ class MiniEqIndicator extends PanelMenu.Button {
         const routed = Boolean(unpackValue(state.routed));
         const presetName = unpackValue(state.preset_name) || _('Current State');
         const outputPresetName = unpackValue(state.output_preset_name) || '';
+        const capabilities = unpackValue(state.capabilities) || [];
+        this._capabilities = new Set(Array.isArray(capabilities) ? capabilities : []);
+        const canQuit = this._capabilities.has('quit');
 
         this._running = running;
         this._routed = routed;
@@ -345,12 +364,14 @@ class MiniEqIndicator extends PanelMenu.Button {
         this._presetsItem.label.text = running ? _('Preset: %s').format(presetName) : _('Presets');
         this._statusItem.label.text = this._statusText(running, routed, eqEnabled);
         this._outputPresetItem.label.text = this._outputPresetText(running, outputPresetName);
+        this._quitItem.visible = running && canQuit;
     }
 
     _setDisconnectedState() {
         this._running = false;
         this._routed = false;
         this._eqEnabled = false;
+        this._capabilities = new Set();
         this.visible = false;
         this._syncPanelStateStyle(false, false, false);
         this._updating = true;
@@ -367,6 +388,7 @@ class MiniEqIndicator extends PanelMenu.Button {
         this._presetsItem.label.text = _('Presets');
         this._statusItem.label.text = _('Mini EQ is not running');
         this._outputPresetItem.label.text = _('Output preset: None');
+        this._quitItem.visible = false;
         this._setAnalyzerLevels([]);
         this._setPresets([]);
     }

{mini_eq-0.3.2 → mini_eq-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mini-eq"
-version = "0.3.2"
+version = "0.4.0"
 description = "Compact PipeWire system-wide parametric equalizer for Linux desktops."
 readme = "README.md"
 requires-python = ">=3.11"

{mini_eq-0.3.2 → mini_eq-0.4.0}/src/mini_eq/app.py

@@ -11,8 +11,15 @@ gi.require_version("Adw", "1")
 from gi.repository import Adw, Gio, GLib, GLibUnix
 
 from .appearance import apply_appearance_preference, load_appearance_preference
+from .background import (
+    load_background_mode,
+    load_start_at_login,
+    save_background_mode,
+    save_start_at_login,
+    set_background_status,
+)
 from .cli import parse_args
-from .dbus_control import MiniEqDbusControl
+from .dbus_control import MiniEqDbusControl, call_present_window
 from .desktop_integration import APP_ICON_NAME, APP_ID, install_app_icon, install_desktop_integration
 from .glib_utils import destroy_glib_source
 from .instance import MiniEqAlreadyRunningError, MiniEqInstanceGuard
@@ -29,6 +36,8 @@ class MiniEqApplication(Adw.Application):
         self.dbus_control: MiniEqDbusControl | None = None
         self.signal_source_ids: list[int] = []
         self.window_present_source_id = 0
+        self.background_mode = load_background_mode() or bool(getattr(args, "background", False))
+        self.start_at_login = load_start_at_login()
 
     def do_startup(self) -> None:
         Adw.Application.do_startup(self)
@@ -37,7 +46,7 @@ class MiniEqApplication(Adw.Application):
         self.install_standard_actions()
         self.dbus_control = MiniEqDbusControl(self)
         self.dbus_control.register()
-        self.signal_source_ids = install_unix_signal_handlers(self.quit)
+        self.signal_source_ids = install_unix_signal_handlers(self.quit_fully)
 
     def install_standard_actions(self) -> None:
         quit_action = Gio.SimpleAction.new("quit", None)
@@ -51,11 +60,7 @@ class MiniEqApplication(Adw.Application):
         self.set_accels_for_action("app.close", ["<primary>w"])
 
     def on_quit_action(self, _action: Gio.SimpleAction, _parameter: GLib.Variant | None) -> None:
-        if self.window is not None and not self.window.ui_shutting_down:
-            self.window.close()
-            return
-
-        self.quit()
+        self.quit_fully()
 
     def on_close_action(self, _action: Gio.SimpleAction, _parameter: GLib.Variant | None) -> None:
         if self.window is not None and not self.window.ui_shutting_down:
@@ -65,12 +70,19 @@ class MiniEqApplication(Adw.Application):
         self.quit()
 
     def do_activate(self) -> None:
+        self.ensure_window(present=not bool(getattr(self.args, "background", False)))
+
+    def ensure_window(self, *, present: bool) -> None:
         install_app_icon()
 
         if self.window is not None:
             if self.window.ui_shutting_down:
                 return
-            self.window.present()
+            if present:
+                self.window.present_after_setup = True
+                self.window.set_visible(True)
+                self.window.present()
+                self.emit_control_state_changed()
             self.window.schedule_post_present_setup()
             return
 
@@ -90,10 +102,47 @@ class MiniEqApplication(Adw.Application):
         self.controller = controller
         self.window = MiniEqWindow(self, self.controller, self.args.auto_route)
         self.window.set_icon_name(APP_ICON_NAME)
-        self.window.set_visible(True)
-        self.window.present()
+        self.window.present_after_setup = present
+        self.window.set_visible(present)
+        if present:
+            self.window.present()
         self.window.schedule_post_present_setup()
-        self.window_present_source_id = GLib.idle_add(self.on_window_present_idle)
+        if present:
+            self.window_present_source_id = GLib.idle_add(self.on_window_present_idle)
+        else:
+            self.update_background_status()
+            self.emit_control_state_changed()
+
+    def present_main_window(self) -> None:
+        self.ensure_window(present=True)
+
+    def quit_fully(self) -> None:
+        if self.window is not None and not self.window.ui_shutting_down:
+            self.window.begin_close_request_shutdown(force_quit=True)
+            return
+
+        self.quit()
+
+    def set_background_mode(self, enabled: bool) -> None:
+        self.background_mode = bool(enabled)
+        save_background_mode(self.background_mode)
+        self.emit_control_state_changed()
+
+    def set_start_at_login(self, enabled: bool) -> None:
+        self.start_at_login = bool(enabled)
+        save_start_at_login(self.start_at_login)
+        self.emit_control_state_changed()
+
+    def update_background_status(self) -> None:
+        if self.controller is not None and self.controller.routed and self.controller.eq_enabled:
+            message = "System-wide EQ active"
+        else:
+            message = "Mini EQ ready"
+
+        try:
+            set_background_status(message)
+        except Exception:
+            pass
 
     def on_window_present_idle(self) -> bool:
         self.window_present_source_id = 0
@@ -104,6 +153,8 @@ class MiniEqApplication(Adw.Application):
         return False
 
     def emit_control_state_changed(self) -> None:
+        if self.window is not None and not self.window.get_visible():
+            self.update_background_status()
         if self.dbus_control is not None:
             self.dbus_control.emit_state_changed()
 
@@ -197,6 +248,15 @@ def run_from_args(args: Namespace) -> int:
     try:
         instance_guard = MiniEqInstanceGuard.acquire()
     except MiniEqAlreadyRunningError as exc:
+        if getattr(args, "background", False):
+            return 0
+
+        try:
+            call_present_window()
+            return 0
+        except Exception:
+            pass
+
         print(str(exc), file=sys.stderr)
         return 2
 

{mini_eq-0.3.2 → mini_eq-0.4.0}/src/mini_eq/appearance.py

@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import json
 from pathlib import Path
 from typing import Final
 
@@ -10,7 +9,8 @@ gi.require_version("Adw", "1")
 
 from gi.repository import Adw
 
-from .core import app_config_dir
+from .settings import load_settings, update_setting
+from .settings import settings_path as _settings_path
 
 APPEARANCE_SYSTEM: Final = "system"
 APPEARANCE_LIGHT: Final = "light"
@@ -29,40 +29,15 @@ def normalize_appearance(value: object) -> str:
 
 
 def settings_path() -> Path:
-    return app_config_dir() / SETTINGS_FILE_NAME
+    return _settings_path()
 
 
 def load_appearance_preference() -> str:
-    path = settings_path()
-    if not path.is_file():
-        return DEFAULT_APPEARANCE
-
-    try:
-        payload = json.loads(path.read_text(encoding="utf-8"))
-    except (OSError, json.JSONDecodeError):
-        return DEFAULT_APPEARANCE
-
-    if not isinstance(payload, dict):
-        return DEFAULT_APPEARANCE
-
-    return normalize_appearance(payload.get(APPEARANCE_KEY))
+    return normalize_appearance(load_settings().get(APPEARANCE_KEY))
 
 
 def save_appearance_preference(appearance: str) -> None:
-    path = settings_path()
-    payload: dict[str, object] = {}
-
-    if path.is_file():
-        try:
-            loaded = json.loads(path.read_text(encoding="utf-8"))
-        except (OSError, json.JSONDecodeError):
-            loaded = {}
-        if isinstance(loaded, dict):
-            payload = loaded
-
-    payload[APPEARANCE_KEY] = normalize_appearance(appearance)
-    path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_text(json.dumps(payload, indent=2) + "\n", encoding="utf-8")
+    update_setting(APPEARANCE_KEY, normalize_appearance(appearance))
 
 
 def color_scheme_for_appearance(appearance: str):

{mini_eq-0.3.2 → mini_eq-0.4.0}/src/mini_eq/assets/icons/hicolor/scalable/apps/io.github.bhack.mini-eq.svg

@@ -1,5 +1,5 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024" role="img" aria-label="Mini EQ">
-  <g transform="translate(512 522) scale(1.11) translate(-512 -512)">
+  <g transform="translate(512 514) scale(1.08) translate(-512 -512)">
     <rect x="162" y="146" width="700" height="732" rx="118" fill="#38545f" stroke="#8bd2dc" stroke-width="24"/>
     <path d="M280 178h464c64 0 86 22 86 86v86c-76-48-180-72-318-72s-242 24-318 72v-86c0-64 22-86 86-86Z" fill="#5f7c86" opacity="0.24"/>
     <rect x="194" y="180" width="636" height="664" rx="92" fill="none" stroke="#18303a" stroke-width="8" opacity="0.60"/>