refrain 0.2.0__tar.gz → 0.2.2__tar.gz

{refrain-0.2.0 → refrain-0.2.2}/.github/workflows/release.yml

@@ -31,9 +31,13 @@ jobs:
       - name: Install + run tests (gate the release)
         run: |
           python -m pip install --upgrade pip
-          # System libs that dbus-python links against during build.
+          # System libs: dbus-python needs the *-dev headers at build
+          # time; PySide6.QtWidgets needs the EGL/xkbcommon/GL/fontconfig
+          # runtime libs to import (even under QT_QPA_PLATFORM=offscreen).
           sudo apt-get update
-          sudo apt-get install -y libdbus-1-dev libglib2.0-dev pkg-config
+          sudo apt-get install -y \
+            libdbus-1-dev libglib2.0-dev pkg-config \
+            libegl1 libxkbcommon0 libfontconfig1 libgl1
           # Install the package itself so the test imports get every
           # runtime dep (PySide6, pypresence, dbus-python) — without
           # this the new test_daemon_*.py files fail at collection.

{refrain-0.2.0 → refrain-0.2.2}/.github/workflows/tests.yml

@@ -26,11 +26,16 @@ jobs:
       - name: Install runtime + test dependencies
         # The newer tests import refrain modules that pull PySide6 /
         # pypresence / dbus-python at module load, so the runtime deps
-        # have to be present in CI too.
+        # have to be present in CI too. PySide6.QtWidgets requires the
+        # EGL / xkbcommon / GL / fontconfig system libs even when run
+        # under QT_QPA_PLATFORM=offscreen — without them the import
+        # itself fails before the test can opt out.
         run: |
           python -m pip install --upgrade pip
           sudo apt-get update
-          sudo apt-get install -y libdbus-1-dev libglib2.0-dev pkg-config
+          sudo apt-get install -y \
+            libdbus-1-dev libglib2.0-dev pkg-config \
+            libegl1 libxkbcommon0 libfontconfig1 libgl1
           pip install -e ".[dev]"
 
       - name: Compile-check every module

{refrain-0.2.0 → refrain-0.2.2}/.gitignore

@@ -32,7 +32,7 @@ env/
 .DS_Store
 
 # AI assistants
-.claude/
+.claude*/
 .cursor/
 .aider*
 

{refrain-0.2.0 → refrain-0.2.2}/CHANGELOG.md

@@ -7,6 +7,209 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-05-06
+
+Two roadmap features pulled forward from v0.3 plus a substantial batch
+of reliability + UX work driven by live-testing the v0.2.1 build.
+
+### Added
+
+- **Multiple Discord profiles** — per-source `client_id_mpris` and
+  `client_id_bluetooth` fields in `Config.discord` plus matching UI in
+  Settings → General → Discord. Empty falls back to the default
+  Client ID. The daemon reconnects RPC under the source-specific ID
+  the moment the active source flips, so each source can render with
+  its own application name + uploaded artwork in the user's profile.
+- **MPRIS-server mode** — Refrain registers itself as
+  `org.mpris.MediaPlayer2.refrain` on the session bus so KDE Plasma's
+  panel media-controls applet (and KDE Connect, GNOME Shell, Mako
+  notifications, …) drive the same Play/Pause/Next/Previous as the
+  tray, and render the same track Discord renders. Implemented with
+  `dbus-python` + a daemon GLib main loop running in its own thread
+  so it doesn't compete with Qt's event loop. Falls back gracefully
+  when PyGObject isn't installed.
+- **iTunes track duration in the cover-fetcher cache** —
+  `trackTimeMillis` from the iTunes Search API rides along with
+  `cover_url` / `song_url` in the on-disk cache and exposed via
+  `CoverFetcher.get_duration_ms()`. Used as a defensive fallback when
+  MPRIS reports an obviously-wrong preview-clip length.
+- **Per-player MPRIS timeout blacklist** — if a property `Get` times
+  out we banish that bus name for 5 s so a hung player (typically
+  plasma-browser-integration on a frozen Apple Music tab) can't keep
+  eating the daemon's poll cycle one tick at a time.
+
+### Changed
+
+- **Welcome wizard** redesigned: 56×56 icon-badge + title + subtitle
+  header, intro line about tray-driven controls, dedicated diagnostics
+  card with two clearly-labelled rows (Discord / iTunes), Discord
+  Application ID block with helper text + readable italic styling
+  (the previous `palette(mid)` tone went invisible on Plasma Breeze
+  dark themes), Skip ghost-style on the left + Apply primary on the
+  right.
+- **Welcome wizard now opens Settings on confirmation** instead of
+  silently dropping into the tray, and reloads the Settings form so
+  the just-saved Discord Client ID appears in the input field.
+- **`compute_rpc_start_ts` accepts `is_preview_clip=True`** to skip
+  the drift-resync path on tracks whose MPRIS Position field loops
+  0→8s instead of advancing monotonically. Discord's elapsed counter
+  no longer resets every ~8 s on preview-mode playback.
+- **Reset-all-settings preserves every Discord Client ID** (default +
+  per-source mpris + per-source bluetooth) and the dialog text now
+  states this explicitly. Reset-dialog button labels are localised
+  (`Reset` / `Zurücksetzen` / `Cancel` / `Abbrechen`) instead of the
+  generic Yes / No.
+- **Default `notify_delay_ms` lowered from 600 ms to 0 ms** — cover
+  cache hits fire instantly, cache misses still get the existing
+  retry loop up to 2 s for the iTunes download.
+- **Default `poll_interval_ms` lowered from 1 s to 500 ms** — track
+  changes, position updates, and tray controls feel noticeably more
+  responsive without measurable CPU impact.
+- **Idle detection skips preview-clip-length tracks** (duration <
+  30 s) — Apple Music keeps reporting the same metadata while a
+  preview replays, and clearing Discord under those conditions hid
+  the activity mid-listen.
+- **Idle-detection log fires once per dangling-track instance**
+  instead of every poll tick.
+
+### Fixed
+
+- **Discord RPC connect now happens within ~1 s of the first track
+  detection** (was: up to 51 s). Root cause: dbus-python's default
+  25 s reply timeout combined with plasma-browser-integration
+  introspection hangs blocked the daemon's poll. Fix: pass
+  `introspect=False` on every `bus.get_object` and `timeout=0.5` on
+  every property `Get` and method dispatch.
+- **Discord RPC reconnects eagerly when the user changes their
+  Application ID** (welcome wizard or Settings → General). Previously
+  the new pipe wasn't established until the next *playing-state*
+  poll, so paused users sat there waiting forever.
+- **Skip / Previous reach Apple Music reliably**: dispatch tries
+  the browser-native MPRIS player (chromium / firefox) first, then
+  falls back to plasma-browser-integration. Plasma's wrapper claims
+  `CanGoNext=True` on Apple Music but its Next routes through a
+  flaky mediaSession path; the browser-native player reaches the
+  same handler via a more reliable path.
+- **Per-property `_safe_get` inside MPRIS read** — chromium MPRIS
+  rejecting one optional property (notably `DesktopEntry`, with a
+  generic `Error.Failed`) no longer drops the whole player from our
+  candidate list, which previously hid the chromium player entirely
+  from the skip-fallback chain.
+- **All apple-music candidates** beyond the metadata winner join the
+  control-fallback list, so the chromium player is reachable for
+  skip dispatches even when plasma wins the metadata pick.
+- **Notification fires immediately on cover-cache hits** (50 ms vs.
+  the previous unconditional 600-1500 ms `notify_delay_ms` wait).
+- **Discord progress bar dropped entirely on preview-clip mode**
+  (MPRIS duration < 30 s) — no `start`, no `end` in the activity
+  payload — so the elapsed timer doesn't loop nonsensically with
+  the 8-second preview.
+- **`update_config` invocation from the welcome wizard** now goes
+  through `settings.applied.emit(config)` (already QueuedConnection-
+  wired to the worker thread) instead of `QMetaObject.invokeMethod
+  (… Q_ARG(object, …))`, which PySide6 rejects with "Unable to find
+  a QMetaType for 'object'" — that exception was silently breaking
+  the post-wizard handshake on first-run.
+- **Welcome wizard X / Esc** marks `first_run_complete=True` (via
+  `reject()` override) so the wizard doesn't re-appear on the next
+  launch when the user dismisses without confirming.
+- **Welcome wizard Apply with empty ID** asks for confirmation
+  before silently saving "no Discord".
+- **Refrain's own published MPRIS bus name skipped** during the
+  source read loop — reading our own publish path back was
+  circular and added noticeable latency.
+- **`_control` exception handling** — a TypeError in
+  `getattr(src, action)()` no longer kills the entire dispatch
+  before the follow-up polls fire.
+- **Reset preserves per-source Discord IDs** (`client_id_mpris` /
+  `client_id_bluetooth`), not just the default `client_id`.
+- **dbus.proxies / dbus.connection log spam silenced** — their
+  Introspect-error tracebacks against unrelated MPRIS players
+  drowned the live log in noise that has nothing to do with
+  refrain.
+
+### Removed
+
+- **Dead `_diag_label` shim** in `WelcomeDialog` that was only there
+  for a backwards-compat path no longer in use.
+
+## [0.2.1] - 2026-05-06
+
+Polish release built around the v0.2.0 surface. The Settings window got
+a UI overhaul, two notification cover-art races are gone, and the
+external code-review punch list landed in full (atomic config writes,
+AppImage size validation, `.ts` source files no longer ship in the
+wheel, dead D-Bus watcher module deleted).
+
+### Added
+
+- **Auto-restart on Discord client_id change** — Apply now triggers an
+  in-process re-exec when the client_id field has changed, same
+  pattern as the language switch. pypresence binds to the client_id
+  at connect time, so a fresh process is the simplest way to re-init
+  cleanly.
+- **AppImage update size validation** — `_apply_appimage` now compares
+  the downloaded file against the GitHub Releases manifest's
+  `appimage_size` before replacing the live binary. A truncated
+  download is rejected and the tmp file cleaned up instead of
+  bricking the next launch.
+- **MPRIS dispatch logging** — `Next` / `Previous` / `PlayPause` log
+  which player actually received the call (INFO level). Diagnoses
+  "Next pauses instead of skipping" type bugs where a fallback
+  player handles the action wrong.
+- **RPC track-change diagnostics** — log raw `pos`, `dur`, `start_ts`
+  on every recompute so duration mismatches (browser MPRIS reporting
+  preview-clip lengths, etc.) are visible in the live log.
+
+### Changed
+
+- **Settings window UI overhaul** — every tab uses a consistent
+  `QGroupBox` + form-layout with left-aligned titles via stylesheet
+  (overrides Plasma Breeze's centered default). Inputs are
+  fixed-width: 220 px default, 360 px for the Discord group whose
+  Client ID placeholder + privacy-mode labels need more room.
+  `FieldsStayAtSizeHint` + per-widget `setFixedWidth` is the only
+  combo that holds across both Fusion (offscreen tests) and Breeze
+  (Plasma) — `AllNonFixedFieldsGrow` was ignoring fixed-width caps.
+- **Discord RPC reconnect cap lowered to 15 s** — autostart launches
+  refrain before Discord is ready; the previous 60 s ceiling meant
+  the user could sit there for almost a minute after Discord
+  finished loading before refrain noticed and connected.
+- **Atomic config writes** — `Config.save` now writes to a `.tmp`
+  sibling and `os.replace`s into place. A crash mid-write would
+  otherwise leave an empty / half-written TOML and refrain
+  silently falls back to defaults on parse error, losing every
+  setting the user picked.
+- **Discord client_id Apply re-init** — wired `restartRequested`
+  emission so picking up a new client_id no longer requires a
+  manual restart.
+
+### Fixed
+
+- **Notification cover flicker** — `notify-send -i` now carries the
+  same image as the `--hint string:image-path:...` payload. KDE
+  Plasma briefly rendered the `-i refrain` brand badge (~50–100 ms)
+  while it loaded the image-path file from disk; using the same
+  file for both makes the transition invisible.
+- **Discord activity-card cover flicker** — defer the first RPC
+  update for a new track until the iTunes-search cover URL is in
+  cache, capped at 3 polls (~3 s). Without this, Discord briefly
+  rendered the `refrain` brand fallback before the real cover
+  paint, exactly the issue cover-fetcher was supposed to fix.
+- **Group titles centered on Plasma Breeze** — explicit stylesheet
+  overrides Breeze's default centered `QGroupBox::title`.
+
+### Removed
+
+- **Dead `dbus_watcher` module** — 155 lines of `MPRISWatcher` /
+  `BluetoothWatcher` machinery that was never wired up after the
+  signal-driven path was abandoned for v0.2.x. The companion
+  `_refresh_watchers` and `_on_external_change` slots in
+  `Daemon` went with it.
+- **`.ts` translation sources from the wheel** — only the compiled
+  `.qm` files ship now. Linguist sources stay in the source tree
+  for translator PRs.
+
 ## [0.2.0] - 2026-05-06
 
 First minor-version bump. Five planned v0.2 features land together

{refrain-0.2.0 → refrain-0.2.2}/CONTRIBUTING.md

@@ -122,31 +122,34 @@ descriptions instead.
 
 ## Translations
 
-User-visible strings live wrapped in `tr()` calls; the source list is
-maintained in `src/refrain/i18n/refrain_<lang>.ts` (Qt Linguist format).
-German is shipped complete. French, Spanish, Italian, Portuguese, Dutch,
-Polish, Japanese, and Simplified Chinese have stub `.ts` files with all
-source strings already extracted, marked
-`<translation type="unfinished"></translation>` — those are the ones we'd
-love community PRs for.
+User-visible strings live wrapped in `tr()` calls; translations are
+kept in `src/refrain/i18n/refrain_<lang>.ts` (Qt Linguist format).
+English is the source language. German is the only translation we
+ship complete right now.
 
-To translate one of the stub languages end-to-end:
+To add a new language end-to-end:
 
 ```sh
-# 1. Pick a language file. Linguist (the GUI) is friendlier than
-#    editing XML by hand.
-pyside6-linguist src/refrain/i18n/refrain_fr.ts
+# 1. Copy the German translation as a starting point (gives you all
+#    the strings already extracted).
+cp src/refrain/i18n/refrain_de.ts src/refrain/i18n/refrain_fr.ts
 
-# 2. Replace each "unfinished" translation with the real string.
+# 2. Open it in Qt Linguist (friendlier than editing XML by hand) and
+#    replace each German line with your translation.
+pyside6-linguist src/refrain/i18n/refrain_fr.ts
 
-# 3. Compile to .qm and run the result locally.
+# 3. Compile to .qm.
 make i18n
+
+# 4. Add your code to settings_window.py's language combo so users can
+#    pick it from the Localization group, then run Refrain locally to
+#    smoke-test.
 LANG=fr_FR.UTF-8 refrain
 ```
 
-If you've wrapped any new strings on the source side, run
-`make i18n-update` first — it refreshes every `.ts` file's
-source-string list while preserving existing translations.
+If you've wrapped any new English strings on the source side, run
+`make i18n-update` first — it refreshes the `.ts` file's source-string
+list while preserving existing translations.
 
-PRs that just translate a `.ts` (no source changes) are very welcome.
-So is native-speaker review of an existing translation.
+PRs that add a new language (or fix typos in an existing one) are
+very welcome.

{refrain-0.2.0 → refrain-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: refrain
-Version: 0.2.0
+Version: 0.2.2
 Summary: Discord Rich Presence for Apple Music on Linux
 Project-URL: Homepage, https://github.com/Rockykln/refrain
 Project-URL: Repository, https://github.com/Rockykln/refrain
@@ -162,7 +162,9 @@ same file; you almost never need to touch it by hand.
 
 ```toml
 [discord]
-client_id = ""                     # paste your own Application ID here
+client_id = ""                     # default Application ID — paste yours here
+client_id_mpris = ""               # optional per-source override (browser / Apple Music)
+client_id_bluetooth = ""           # optional per-source override (Bluetooth headphones)
 
 [sources]
 mpris_enabled = true
@@ -177,12 +179,28 @@ autostart = false
 notifications = true
 cover_art = true
 show_buttons = true
+notify_delay_ms = 0                # 0 = fire ASAP; the cover-art retry loop still waits up to ~2 s
 
 [advanced]
-poll_interval_ms = 1000
+poll_interval_ms = 500
 log_level = "INFO"
+cover_cache_size = 200             # disk cap for cached covers
+idle_grace_s = 30                  # clear status when same track plays past duration + grace; 0 disables
+language = "system"                # "system" follows QLocale; "en" / "de" / … force a translation
 ```
 
+Per-source `client_id_*` fields let Apple Music render under one Discord
+application (with the album-grid as artwork) and Bluetooth headphones under
+another (with a generic Bluetooth glyph). Empty falls back to the default
+`client_id`.
+
+## MPRIS server
+
+Refrain publishes itself as `org.mpris.MediaPlayer2.refrain` on the session
+bus, so KDE Plasma's panel media-controls applet (and KDE Connect, GNOME
+Shell, Mako, …) drive the same Play/Pause/Next/Previous as the tray and
+render the same track Discord renders.
+
 ## Tray
 
 <p align="center">

{refrain-0.2.0 → refrain-0.2.2}/README.md

@@ -128,7 +128,9 @@ same file; you almost never need to touch it by hand.
 
 ```toml
 [discord]
-client_id = ""                     # paste your own Application ID here
+client_id = ""                     # default Application ID — paste yours here
+client_id_mpris = ""               # optional per-source override (browser / Apple Music)
+client_id_bluetooth = ""           # optional per-source override (Bluetooth headphones)
 
 [sources]
 mpris_enabled = true
@@ -143,12 +145,28 @@ autostart = false
 notifications = true
 cover_art = true
 show_buttons = true
+notify_delay_ms = 0                # 0 = fire ASAP; the cover-art retry loop still waits up to ~2 s
 
 [advanced]
-poll_interval_ms = 1000
+poll_interval_ms = 500
 log_level = "INFO"
+cover_cache_size = 200             # disk cap for cached covers
+idle_grace_s = 30                  # clear status when same track plays past duration + grace; 0 disables
+language = "system"                # "system" follows QLocale; "en" / "de" / … force a translation
 ```
 
+Per-source `client_id_*` fields let Apple Music render under one Discord
+application (with the album-grid as artwork) and Bluetooth headphones under
+another (with a generic Bluetooth glyph). Empty falls back to the default
+`client_id`.
+
+## MPRIS server
+
+Refrain publishes itself as `org.mpris.MediaPlayer2.refrain` on the session
+bus, so KDE Plasma's panel media-controls applet (and KDE Connect, GNOME
+Shell, Mako, …) drive the same Play/Pause/Next/Previous as the tray and
+render the same track Discord renders.
+
 ## Tray
 
 <p align="center">

{refrain-0.2.0 → refrain-0.2.2}/ROADMAP.md

@@ -145,6 +145,30 @@ What's done, what's next, what's deliberately not in scope.
 - **Window-title cleanup** — no more "Refrain — Settings — Refrain"
   triple; Qt's auto-suffix is the only place "Refrain" appears.
 
+## Done — v0.2.1
+
+- **Settings UI overhaul** — consistent `QGroupBox` + form-layout
+  across every tab, left-aligned group titles via stylesheet
+  (Plasma Breeze centers them by default), fixed-width inputs
+  (220 px default, 360 px in the Discord group). Switched from
+  `AllNonFixedFieldsGrow` to `FieldsStayAtSizeHint` because the
+  former silently ignored fixed-width caps on Plasma Breeze.
+- **Notification cover-flicker fix** — `notify-send -i` now
+  carries the same image as the `--hint string:image-path:`
+  payload so KDE Plasma can't briefly render the brand badge.
+- **Discord RPC cover flicker fix** — defer the first activity
+  update for a new track until the iTunes cover URL is in cache,
+  capped at ~3 polls so cover-less songs still update.
+- **Auto-restart on Discord client_id Apply** — same pattern as
+  the language switch, since pypresence binds to the client_id
+  at connect time.
+- **AppImage update size validation** + tmp cleanup, **atomic
+  config writes** (tmp + os.replace), **dead `dbus_watcher`
+  module removed** (155 lines), **RPC reconnect backoff capped
+  at 15 s** instead of 60 s, **`.ts` source files no longer ship
+  in the wheel**, **MPRIS dispatch logging at INFO** so
+  Next/Previous routing is visible in the live log.
+
 ## Up next — v0.3
 
 - **Polishing the wrapped i18n surface** — wrap the remaining
@@ -156,6 +180,48 @@ What's done, what's next, what's deliberately not in scope.
   signed tag, so AUR users get the exact same commit the release
   workflow ships.
 
+## Done — v0.2.2
+
+- **Multiple Discord profiles** — per-source `client_id_mpris` and
+  `client_id_bluetooth` overrides on top of the default `client_id`,
+  so Apple Music can render under one Discord application (with the
+  album-grid as artwork) and Bluetooth headphones under another (with
+  a generic Bluetooth glyph). Daemon reconnects RPC the moment the
+  active source flips.
+- **MPRIS-server mode** — Refrain publishes itself as
+  `org.mpris.MediaPlayer2.refrain` so KDE Plasma's panel media-controls
+  applet, KDE Connect, GNOME Shell, etc. drive the same Play/Pause/
+  Next/Previous as the tray and render the same track. Built on
+  `dbus-python` with a GLib main loop in its own thread so it
+  doesn't conflict with Qt's event loop.
+- **Welcome wizard redesign** — icon-badge header, subtitle, dedicated
+  diagnostics card with two clearly-labelled probe rows, readable
+  helper text on Plasma Breeze Dark (was invisible with `palette(mid)`).
+  Apply now opens Settings automatically with the just-saved Discord
+  ID pre-filled.
+- **Live-tier responsiveness** — default `poll_interval_ms` 1 s → 500 ms,
+  `notify_delay_ms` 600 ms → 0 ms (cache hits fire instantly), Discord
+  RPC connect happens within ~1 s of first track detection (was up to
+  51 s due to dbus-python's 25 s default reply timeout combined with
+  plasma-browser-integration introspection hangs — fixed via
+  `introspect=False` + per-property `timeout=0.5` + per-player
+  blacklist when a player times out).
+- **iTunes `trackTimeMillis` fallback** for Apple Music preview-clip
+  durations (< 30 s). Discord drops `start`/`end` entirely on preview
+  mode so the elapsed counter doesn't reset every 8 s.
+- **Skip / Previous reach Apple Music reliably** — chromium-native
+  MPRIS dispatched first, plasma-browser-integration as fallback,
+  cascade follow-up polls (0/50/150/350/750 ms) so the track-change
+  reflects in Discord + tray within ~250 ms of detection.
+- **Reset preserves all three Discord IDs**, dialog button labels
+  localised (`Reset` / `Zurücksetzen`), text states what's preserved
+  explicitly.
+- **Welcome wizard X / Esc** marks `first_run_complete=True` so the
+  wizard doesn't re-appear; Apply with empty ID asks for confirmation.
+- **Theme-aware text colors** — every helper-text label switched from
+  `palette(mid)` to `palette(text)` after Plasma Breeze Dark
+  rendered them invisible.
+
 ## Maybe — v0.3+
 
 - **Flathub submission**, second attempt. The manifest under
@@ -167,11 +233,6 @@ What's done, what's next, what's deliberately not in scope.
 - **Cover-art replacement notifications**: re-send the desktop notification
   via `--replace-id` once the cover finishes downloading, so the embed
   swaps in even when the initial retry window times out.
-- **Multiple Discord profiles**: per-source client IDs so Bluetooth and
-  Apple Music Web can render with different artwork in the user's profile.
-- **MPRIS-server mode**: expose Refrain as an MPRIS player itself, so KDE
-  Plasma's media controls in the panel show the same track Refrain shows
-  in Discord.
 
 ## Deliberately not in scope
 

{refrain-0.2.0 → refrain-0.2.2}/packaging/appimage/AppImageBuilder.yml

@@ -30,7 +30,7 @@ AppDir:
     id: io.github.Rockykln.Refrain
     name: Refrain
     icon: refrain
-    version: 0.2.0
+    version: 0.2.2
     exec: usr/bin/python3
     exec_args: -m refrain $@
 

{refrain-0.2.0 → refrain-0.2.2}/packaging/aur/refrain/PKGBUILD

@@ -1,7 +1,7 @@
 # Maintainer: Rockykln <contact@rockykln.com>
 
 pkgname=refrain
-pkgver=0.2.0
+pkgver=0.2.2
 pkgrel=1
 pkgdesc="Discord Rich Presence for Apple Music on Linux"
 arch=('any')
@@ -20,7 +20,7 @@ makedepends=(
     'python-wheel'
 )
 source=("$pkgname-$pkgver.tar.gz::https://github.com/Rockykln/refrain/archive/v$pkgver.tar.gz")
-sha256sums=('d88df042b1ce2d403c65a3c0c6883f0de4eda038c5f44e1fb8f4d5b54bddd5cf')
+sha256sums=('SKIP')  # set after release tag is pushed: updpkgsums
 
 build() {
     cd "$pkgname-$pkgver"

{refrain-0.2.0 → refrain-0.2.2}/packaging/flatpak/io.github.Rockykln.Refrain.metainfo.xml

@@ -51,6 +51,41 @@
   <content_rating type="oars-1.1" />
 
   <releases>
+    <release version="0.2.2" date="2026-05-06">
+      <description>
+        <p>
+          Two roadmap features pulled forward: per-source Discord
+          client IDs (so Apple Music and Bluetooth can render under
+          different Discord applications, with their own artwork in
+          the user's profile), and MPRIS-server mode (Refrain
+          publishes itself as org.mpris.MediaPlayer2.refrain so KDE
+          Plasma's panel media-controls applet, KDE Connect, GNOME
+          Shell, etc. drive the same Play / Pause / Next / Previous
+          as the tray and render the same track Discord renders).
+        </p>
+      </description>
+    </release>
+    <release version="0.2.1" date="2026-05-06">
+      <description>
+        <p>
+          Settings UI overhaul: every tab now uses a consistent
+          GroupBox + form-layout with left-aligned titles, fixed-width
+          inputs that hold across Plasma Breeze and other Qt styles,
+          and a compact 220 px field default (360 px for the Discord
+          group whose values need more room). Notification cover-art
+          flicker is gone — `notify-send -i` and `image-path` now
+          carry the same image so KDE Plasma can't briefly render
+          the brand badge. Discord RPC defers the first update for
+          a new track until the cover URL is in cache so the brand
+          fallback never flashes in the activity card. Apply now
+          auto-restarts when the Discord client_id changes (same
+          pattern as the language switch). Dead D-Bus watcher code
+          removed (155 lines), atomic config writes, AppImage
+          updater validates downloaded size, RPC reconnect backoff
+          capped at 15 s instead of 60 s.
+        </p>
+      </description>
+    </release>
     <release version="0.2.0" date="2026-05-06">
       <description>
         <p>

{refrain-0.2.0 → refrain-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "refrain"
-version = "0.2.0"
+version = "0.2.2"
 description = "Discord Rich Presence for Apple Music on Linux"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -50,12 +50,11 @@ Changelog = "https://github.com/Rockykln/refrain/blob/main/CHANGELOG.md"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/refrain"]
-# Include compiled translations + bundled assets in the wheel.
-# .qm files are pre-compiled (via `make i18n`) and committed; .ts files
-# are the editable Linguist sources for translators.
+# Include compiled translations + bundled assets in the wheel. Only the
+# pre-compiled .qm files ship — .ts (Linguist source) files belong in
+# the source tree for translators to edit, not in the runtime wheel.
 artifacts = [
     "src/refrain/i18n/*.qm",
-    "src/refrain/i18n/*.ts",
     "src/refrain/assets/**/*",
 ]
 

refrain-0.2.2/src/refrain/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.2"