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

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

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.3.2 - 2026-05-04
+
+- Fix Flatpak system-wide routing by requesting PipeWire manager access from the WirePlumber client.
+- Restore partially routed streams when initial routing fails and reset the routing switch after failures.
+- Avoid restarting output routing during GTK close shutdown.
+- Add a local Flatpak runtime smoke test and an experimental manual CI job for routing checks.
+
+## 0.3.1 - 2026-05-04
+
+- Improve adaptive layout spacing across compact, tall, and wide windows.
+- Remove unnecessary utility-pane scrolling at the minimum window height.
+- Lighten the utility pane presentation so tall windows keep focus on the controls.
+
 ## 0.3.0 - 2026-05-03
 
 - Add optional live LUFS loudness metering through libebur128 and the existing JACK monitor stream.

{mini_eq-0.3.0 → mini_eq-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-eq
-Version: 0.3.0
+Version: 0.3.2
 Summary: Compact PipeWire system-wide parametric equalizer for Linux desktops.
 Author: bhack
 License-Expression: GPL-3.0-or-later

{mini_eq-0.3.0 → mini_eq-0.3.2}/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.0/docs/screenshots/mini-eq.png</image>
+      <image>https://raw.githubusercontent.com/bhack/mini-eq/v0.3.2/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.0/docs/screenshots/mini-eq-dark.png</image>
+      <image>https://raw.githubusercontent.com/bhack/mini-eq/v0.3.2/docs/screenshots/mini-eq-dark.png</image>
       <caption>Use the equalizer with dark style</caption>
     </screenshot>
   </screenshots>
@@ -46,6 +46,24 @@
   <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.3.2" date="2026-05-04">
+      <description>
+        <ul>
+          <li>Fix Flatpak system-wide routing access through WirePlumber.</li>
+          <li>Restore partially routed streams when initial routing fails.</li>
+          <li>Avoid restarting routing during window-close shutdown.</li>
+        </ul>
+      </description>
+    </release>
+    <release version="0.3.1" date="2026-05-04">
+      <description>
+        <ul>
+          <li>Improve adaptive layout spacing across compact, tall, and wide windows.</li>
+          <li>Avoid unnecessary utility pane scrolling at the minimum window height.</li>
+          <li>Lighten the utility pane presentation so tall windows keep focus on the controls.</li>
+        </ul>
+      </description>
+    </release>
     <release version="0.3.0" date="2026-05-03">
       <description>
         <ul>

{mini_eq-0.3.0 → mini_eq-0.3.2}/docs/flathub.md

@@ -126,6 +126,14 @@ flatpak run --command=flathub-build org.flatpak.Builder --install io.github.bhac
 flatpak run io.github.bhack.mini-eq --check-deps
 ```
 
+When routing, WirePlumber access, Flatpak permissions, runtime dependencies, or
+shutdown behavior changed, also run the upstream runtime smoke test against the
+installed local build before opening or merging the Flathub PR:
+
+```bash
+python3 tools/check_flatpak_runtime.py --app-ref io.github.bhack.mini-eq//master
+```
+
 For a local source and full build check without installing the app:
 
 ```bash

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

@@ -94,6 +94,34 @@ If extensions.gnome.org asks for an extension screenshot, capture it from the
 nested fake-control Shell documented in `extensions/gnome-shell/README.md` so no
 real desktop, device, account, or path details are exposed.
 
+## Flatpak Runtime Smoke
+
+Run this after installing the local Flatpak build, and before release
+publication or Flathub handoff, whenever PipeWire routing, WirePlumber access,
+Flatpak permissions, runtime dependencies, or shutdown behavior changed. This
+check temporarily routes a silent host PipeWire stream through Mini EQ and then
+verifies that the stream is restored when the app exits, so keep it separate
+from the generic preflight.
+
+```bash
+flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo
+flatpak install --user -y flathub org.flatpak.Builder//stable
+flatpak run --command=flathub-build org.flatpak.Builder --install io.github.bhack.mini-eq.yaml
+python3 tools/check_flatpak_runtime.py --app-ref io.github.bhack.mini-eq//master
+```
+
+For shutdown changes, also run the installed Flatpak interactively, enable
+system-wide EQ, close the GTK window, and confirm that the app exits without a
+crash and streams are restored:
+
+```bash
+flatpak run io.github.bhack.mini-eq//master --auto-route
+```
+
+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.
+
 ## Build
 
 ```bash

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

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

{mini_eq-0.3.0 → mini_eq-0.3.2}/src/mini_eq/style.css

@@ -120,8 +120,21 @@
     color: alpha(var(--window-fg-color), 0.86);
 }
 
+overlay-split-view.mini-eq-workspace > widget.sidebar-pane {
+    background-color: transparent;
+}
+
+.mini-eq-dark overlay-split-view.mini-eq-workspace > widget.sidebar-pane {
+    background-color: transparent;
+}
+
+.utility-pane-scroller,
+.utility-pane-scroller viewport {
+    background-color: transparent;
+}
+
 .utility-section {
-    padding: 9px 10px;
+    padding: 7px 10px;
     border-radius: 12px;
     border: 1px solid var(--mini-border-soft);
     background-color: var(--mini-utility-section-bg);
@@ -132,13 +145,13 @@
 }
 
 .utility-row {
-    padding: 6px 0;
+    padding: 4px 0;
     border-radius: 0;
     background-color: transparent;
 }
 
 .compare-row {
-    padding: 6px 0;
+    padding: 4px 0;
     border-radius: 0;
     background-color: transparent;
 }
@@ -173,7 +186,7 @@
 }
 
 .preset-state-chip {
-    padding: 4px 10px;
+    padding: 3px 10px;
     border-radius: 999px;
     font-size: 9pt;
     font-weight: 800;
@@ -195,7 +208,7 @@
 }
 
 .system-state-chip {
-    padding: 4px 10px;
+    padding: 3px 10px;
     border-radius: 999px;
     font-size: 9pt;
     font-weight: 800;
@@ -222,7 +235,7 @@
 }
 
 .headroom-panel {
-    padding: 6px 0;
+    padding: 4px 0;
     border-radius: 8px;
     background-color: transparent;
 }
@@ -240,7 +253,7 @@
 }
 
 .headroom-peak-chip {
-    padding: 4px 9px;
+    padding: 3px 9px;
     border-radius: 999px;
     font-size: 9.5pt;
     font-weight: 800;
@@ -277,13 +290,13 @@
 }
 
 .monitor-strip {
-    margin-top: 3px;
-    padding-top: 7px;
+    margin-top: 1px;
+    padding-top: 5px;
     border-top: 1px solid var(--mini-border-subtle);
 }
 
 .monitor-detail-row {
-    min-height: 28px;
+    min-height: 24px;
 }
 
 .monitor-settings-button {
@@ -299,60 +312,7 @@
 }
 
 .loudness-meter-area {
-    min-height: 16px;
-}
-
-.utility-pane-dense .utility-section {
-    padding: 6px 8px;
-}
-
-.utility-pane-dense .utility-row,
-.utility-pane-dense .compare-row {
-    padding: 6px 8px;
-}
-
-.utility-pane-dense .toolbar-button {
-    min-height: 32px;
-    padding-top: 2px;
-    padding-bottom: 2px;
-}
-
-.utility-pane-dense .preset-row {
-    margin-top: 0;
-}
-
-.utility-pane-dense .preset-state-chip,
-.utility-pane-dense .system-state-chip,
-.utility-pane-dense .compare-state-chip,
-.utility-pane-dense .headroom-peak-chip {
-    padding-top: 2px;
-    padding-bottom: 2px;
-}
-
-.utility-pane-dense .headroom-panel {
-    padding: 6px 8px;
-}
-
-.utility-pane-dense .headroom-state {
-    font-size: 12pt;
-}
-
-.utility-pane-dense .headroom-meter-area {
-    min-height: 10px;
-}
-
-.utility-pane-dense .monitor-strip {
-    margin-top: 1px;
-    padding-top: 5px;
-}
-
-.utility-pane-dense .monitor-detail-row {
-    min-height: 24px;
-}
-
-.utility-pane-dense .monitor-settings-button {
-    min-width: 32px;
-    min-height: 32px;
+    min-height: 14px;
 }
 
 .headroom-state.headroom-safe {

{mini_eq-0.3.0 → mini_eq-0.3.2}/src/mini_eq/window.py

@@ -352,7 +352,7 @@ class MiniEqWindow(
                 self.updating_ui = False
 
             try:
-                self.controller.route_system_audio(False, announce=False)
+                self.controller.route_system_audio(False, announce=False, refresh_output=False)
             except Exception:
                 pass
             finally:
@@ -780,6 +780,11 @@ class MiniEqWindow(
             self.controller.route_system_audio(enabled)
             route_changed = True
         except Exception as exc:
+            self.updating_ui = True
+            try:
+                switch.set_active(self.controller.routed)
+            finally:
+                self.updating_ui = False
             self.set_status(str(exc))
         finally:
             self.update_eq_power_indicator()

{mini_eq-0.3.0 → mini_eq-0.3.2}/src/mini_eq/window_layout.py

@@ -34,7 +34,6 @@ from .window_utils import (
 )
 
 ADAPTIVE_NARROW_BREAKPOINT_SP = 1320
-RESPONSIVE_COMFORTABLE_HEIGHT = 720
 RESPONSIVE_ROOMY_HEIGHT = 960
 COMPACT_BREAKPOINT_SP = 1080
 DEFAULT_GRAPH_CONTENT_WIDTH = 900
@@ -184,6 +183,7 @@ class MiniEqWindowLayoutMixin:
         root.append(toolbar_stack)
 
         workspace = Adw.OverlaySplitView()
+        workspace.add_css_class("mini-eq-workspace")
         workspace.set_hexpand(True)
         workspace.set_vexpand(True)
         workspace.set_valign(Gtk.Align.FILL)
@@ -219,6 +219,7 @@ class MiniEqWindowLayoutMixin:
         right_column.add_css_class("utility-pane-shell")
 
         right_scroller = Gtk.ScrolledWindow()
+        right_scroller.add_css_class("utility-pane-scroller")
         right_scroller.set_policy(Gtk.PolicyType.NEVER, Gtk.PolicyType.AUTOMATIC)
         right_scroller.set_propagate_natural_height(False)
         right_scroller.set_size_request(310, -1)
@@ -620,32 +621,27 @@ class MiniEqWindowLayoutMixin:
                 ROOMY_FADER_SCROLLER_MIN_HEIGHT,
                 layout_height,
             )
-            dense = layout_height < RESPONSIVE_COMFORTABLE_HEIGHT
-            right_column.set_spacing(8 if dense else 12)
-            right_column.set_margin_top(2 if dense else 4)
-            right_column.set_margin_bottom(0 if dense else 2)
-            preset_section.set_spacing(6 if dense else 8)
-            system_section.set_spacing(6 if dense else 8)
-            self.headroom_panel.set_spacing(4 if dense else 7)
-            self.headroom_meter_area.set_content_height(10 if dense else 14)
-            monitor_panel.set_spacing(2 if dense else 4)
-            if dense:
-                right_column.add_css_class("utility-pane-dense")
-            else:
-                right_column.remove_css_class("utility-pane-dense")
+            right_column.set_spacing(responsive_value(6, 12, layout_height))
+            right_column.set_margin_top(responsive_value(2, 4, layout_height))
+            right_column.set_margin_bottom(responsive_value(0, 2, layout_height))
+            preset_section.set_spacing(responsive_value(5, 8, layout_height))
+            system_section.set_spacing(responsive_value(5, 8, layout_height))
+            self.headroom_panel.set_spacing(responsive_value(3, 7, layout_height))
+            self.headroom_meter_area.set_content_height(responsive_value(9, 14, layout_height))
+            monitor_panel.set_spacing(responsive_value(1, 4, layout_height))
 
             if compact:
                 right_column.set_margin_start(18)
                 right_column.set_margin_end(12)
-                graph_shell.set_spacing(4 if not dense else 2)
+                graph_shell.set_spacing(responsive_value(2, 4, layout_height))
                 self.graph_area.set_content_height(graph_height)
                 self.analyzer_area.set_content_height(analyzer_height)
                 self.graph_response_area.set_content_height(graph_height)
                 fader_section.set_spacing(COMPACT_FADER_SECTION_SPACING)
                 fader_section.set_vexpand(False)
                 fader_section.set_valign(Gtk.Align.START)
-                fader_section.set_margin_top(6 if not dense else 4)
-                fader_section.set_margin_bottom(4 if not dense else 3)
+                fader_section.set_margin_top(responsive_value(4, 6, layout_height))
+                fader_section.set_margin_bottom(responsive_value(3, 4, layout_height))
                 self.fader_scroller.set_vexpand(False)
                 self.fader_scroller.set_valign(Gtk.Align.START)
                 self.fader_scroller.set_min_content_height(fader_scroller_height)
@@ -679,21 +675,23 @@ class MiniEqWindowLayoutMixin:
 
             right_column.set_margin_start(14)
             right_column.set_margin_end(10)
-            graph_shell.set_spacing(2 if dense else 6)
+            graph_shell.set_spacing(responsive_value(2, 6, layout_height))
             self.graph_area.set_content_height(graph_height)
             self.analyzer_area.set_content_height(analyzer_height)
             self.graph_response_area.set_content_height(graph_height)
-            fader_section.set_spacing(COMPACT_FADER_SECTION_SPACING if dense else DEFAULT_FADER_SECTION_SPACING)
+            fader_section.set_spacing(
+                responsive_value(COMPACT_FADER_SECTION_SPACING, DEFAULT_FADER_SECTION_SPACING, layout_height)
+            )
             fader_section.set_vexpand(False)
             fader_section.set_valign(Gtk.Align.START)
-            fader_section.set_margin_top(4 if dense else 8)
-            fader_section.set_margin_bottom(3 if dense else 6)
+            fader_section.set_margin_top(responsive_value(4, 8, layout_height))
+            fader_section.set_margin_bottom(responsive_value(3, 6, layout_height))
             self.fader_scroller.set_vexpand(False)
             self.fader_scroller.set_valign(Gtk.Align.START)
             self.fader_scroller.set_min_content_height(fader_scroller_height)
             self.fader_scroller.remove_css_class("fader-scroller-compact")
-            fader_grid.set_margin_top(2 if dense else 4)
-            fader_grid.set_margin_bottom(2 if dense else 4)
+            fader_grid.set_margin_top(responsive_value(2, 4, layout_height))
+            fader_grid.set_margin_bottom(responsive_value(2, 4, layout_height))
             band_editor.remove_css_class("band-editor-compact-active")
             band_editor.remove_css_class("band-editor-inline-compact")
             band_editor.set_child_spacing(8)

{mini_eq-0.3.0 → mini_eq-0.3.2}/src/mini_eq/wireplumber_backend.py

@@ -12,6 +12,8 @@ SPA_ID_TYPE = "Spa:Id"
 STREAM_OUTPUT_AUDIO = "Stream/Output/Audio"
 AUDIO_SINK = "Audio/Sink"
 FILTER_CHAIN_MODULE_NAME = "libpipewire-module-filter-chain"
+PIPEWIRE_CLIENT_NAME = "Mini EQ"
+PIPEWIRE_MEDIA_CATEGORY = "Manager"
 
 
 @dataclass(frozen=True)
@@ -367,7 +369,15 @@ class WirePlumberBackend:
         if not target.object_serial:
             raise WirePlumberError(f"audio sink has no object.serial: {target_node_name}")
 
-        self.set_metadata_and_wait(stream.bound_id, TARGET_OBJECT_KEY, SPA_ID_TYPE, target.object_serial)
+        moved = self.set_metadata_and_wait(stream.bound_id, TARGET_OBJECT_KEY, SPA_ID_TYPE, target.object_serial)
+        if moved:
+            return
+
+        target_object, target_type = self.stream_target_object(stream.bound_id)
+        if target_object != target.object_serial or target_type not in {None, SPA_ID_TYPE}:
+            raise WirePlumberError(
+                f"WirePlumber did not acknowledge moving {stream.display_name} to {target_node_name}"
+            )
 
     def stream_targets_node(self, stream_bound_id: int, target_node_name: str) -> bool:
         target = self.audio_sink_by_name(target_node_name)
@@ -468,8 +478,12 @@ class WirePlumberBackend:
 
     @staticmethod
     def _new_core(Wp):
+        properties = Wp.Properties.new_empty()
+        properties.set("application.name", PIPEWIRE_CLIENT_NAME)
+        properties.set("media.category", PIPEWIRE_MEDIA_CATEGORY)
+
         try:
-            return Wp.Core.new(None, None, None)
+            return Wp.Core.new(None, None, properties)
         except TypeError:
             return Wp.Core.new(None, None)
 

{mini_eq-0.3.0 → mini_eq-0.3.2}/src/mini_eq/wireplumber_stream_router.py

@@ -104,7 +104,7 @@ class WirePlumberStreamRouter:
         self.routed_stream_ids.clear()
         return restored
 
-    def refresh(self) -> bool:
+    def refresh(self, *, raise_errors: bool = False) -> bool:
         if not self.enabled:
             return False
 
@@ -114,6 +114,8 @@ class WirePlumberStreamRouter:
                 self.emit_status(f"routed {routed_now} stream(s) to {self.virtual_sink_name}")
         except Exception as exc:
             self.emit_status(f"routing warning: {exc}")
+            if raise_errors:
+                raise
 
         return False
 
@@ -140,14 +142,14 @@ class WirePlumberStreamRouter:
         if self.event_source_id == 0:
             self.event_source_id = GLib.idle_add(self.on_stream_event_idle)
 
-    def start_monitoring(self) -> None:
+    def start_monitoring(self, *, require_initial_route: bool = False) -> None:
         self.backend.connect()
         self.accept_stream_events = True
 
         if self.object_added_handler_id == 0:
             self.object_added_handler_id = self.backend.connect_object_added(self.handle_object_added)
 
-        self.refresh()
+        self.refresh(raise_errors=require_initial_route)
 
     def stop_monitoring(self) -> None:
         self.accept_stream_events = False
@@ -162,7 +164,13 @@ class WirePlumberStreamRouter:
 
     def enable(self) -> None:
         self.enabled = True
-        self.start_monitoring()
+        try:
+            self.start_monitoring(require_initial_route=True)
+        except Exception:
+            self.enabled = False
+            self.stop_monitoring()
+            self.restore_output_streams()
+            raise
 
     def disable(self, announce: bool = True) -> None:
         if not self.enabled and not self.routed_stream_ids:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mini-eq
-Version: 0.3.0
+Version: 0.3.2
 Summary: Compact PipeWire system-wide parametric equalizer for Linux desktops.
 Author: bhack
 License-Expression: GPL-3.0-or-later

{mini_eq-0.3.0 → mini_eq-0.3.2}/src/mini_eq.egg-info/SOURCES.txt

@@ -82,6 +82,7 @@ tests/test_mini_eq_wireplumber_stream_router.py
 tests/test_version_metadata.py
 tools/benchmark_fader_drag.py
 tools/check_flathub_manifest_drift.py
+tools/check_flatpak_runtime.py
 tools/check_gnome_shell_extension.py
 tools/check_wireplumber_gi.py
 tools/demo_runtime.py

{mini_eq-0.3.0 → mini_eq-0.3.2}/tests/test_mini_eq_window.py

@@ -58,7 +58,9 @@ def test_begin_close_request_shutdown_restores_routing_before_delayed_quit(monke
         updating_ui=False,
         route_switch=FakeSwitch(True),
         controller=SimpleNamespace(
-            route_system_audio=lambda enabled, announce=True: calls.append(("route", enabled, announce))
+            route_system_audio=lambda enabled, announce=True, refresh_output=True: calls.append(
+                ("route", enabled, announce, refresh_output)
+            )
         ),
         update_info_label=lambda: calls.append("info"),
         update_status_summary=lambda: calls.append("summary"),
@@ -74,7 +76,7 @@ def test_begin_close_request_shutdown_restores_routing_before_delayed_quit(monke
     assert fake_window.updating_ui is False
     assert fake_window.close_finish_source_id == 321
     assert calls == [
-        ("route", False, False),
+        ("route", False, False, False),
         "info",
         "summary",
         ("visible", False),
@@ -86,3 +88,32 @@ def test_begin_close_request_shutdown_restores_routing_before_delayed_quit(monke
 
     assert fake_window.close_finish_source_id == 0
     assert application.quit_count == 1
+
+
+def test_on_route_changed_resets_switch_when_routing_fails() -> None:
+    calls: list[object] = []
+
+    def fail_route(_enabled: bool) -> None:
+        raise RuntimeError("metadata permission denied")
+
+    fake_window = SimpleNamespace(
+        updating_ui=False,
+        controller=SimpleNamespace(
+            eq_enabled=True,
+            routed=False,
+            route_system_audio=fail_route,
+        ),
+        update_eq_power_indicator=lambda: calls.append("power"),
+        update_info_label=lambda: calls.append("info"),
+        update_status_summary=lambda: calls.append("summary"),
+        update_focus_summary=lambda: calls.append("focus"),
+        set_status=lambda message: calls.append(("status", message)),
+        notify_control_state_changed=lambda: calls.append("notify"),
+    )
+    route_switch = FakeSwitch(True)
+
+    window.MiniEqWindow.on_route_changed(fake_window, route_switch, None)
+
+    assert route_switch.get_active() is False
+    assert fake_window.updating_ui is False
+    assert ("status", "metadata permission denied") in calls