refrain 0.2.5__tar.gz → 0.2.7__tar.gz

{refrain-0.2.5 → refrain-0.2.7}/.github/workflows/release.yml

@@ -104,10 +104,38 @@ jobs:
           mv *.AppImage.zsync ../../dist/ 2>/dev/null || true
           ls -la ../../dist/
 
+      # Extract the matching `## [X.Y.Z]` section from CHANGELOG.md
+      # and feed it into the GitHub release body. Without this we'd
+      # fall back to GitHub's auto-generated "Full Changelog: …"
+      # one-liner — which is also what the in-app
+      # Settings → Updates → "Latest release notes" pane renders, so
+      # users would only ever see the bare compare-link there.
+      - name: Extract CHANGELOG section for the release body
+        run: |
+          TAG="${GITHUB_REF#refs/tags/v}"
+          # awk: print everything between `## [TAG]` and the next
+          # top-level ## section, excluding the heading lines themselves.
+          awk -v ver="${TAG}" '
+            $0 ~ "^## \\[" ver "\\]" { p=1; next }
+            p && /^## \[/ { exit }
+            p { print }
+          ' CHANGELOG.md > release-notes.md
+          echo "::group::release-notes.md"
+          cat release-notes.md
+          echo "::endgroup::"
+          if [ ! -s release-notes.md ]; then
+            echo "::error::CHANGELOG section for v${TAG} extracted to nothing"
+            exit 1
+          fi
+
       - name: Create GitHub release
         uses: softprops/action-gh-release@v3
         with:
-          generate_release_notes: true
+          # Use our CHANGELOG section (extracted above), not GitHub's
+          # auto-generated notes — the in-app update dialog renders
+          # this body verbatim so it has to actually be the changelog.
+          body_path: release-notes.md
+          generate_release_notes: false
           draft: false
           prerelease: ${{ contains(github.ref, '-') }}   # e.g. v0.2.0-rc1
           name: "Refrain ${{ github.ref_name }}"

{refrain-0.2.5 → refrain-0.2.7}/CHANGELOG.md

@@ -7,6 +7,226 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.7] - 2026-05-07
+
+Tray-menu polish + Discord-RPC reliability fixes. Every tray action
+now carries an icon, song-info rows render in normal menu text
+colour instead of greyed-out indented rows, middle-click on the
+tray toggles play/pause, and Discord handshake errors no longer
+spam the log with unexpected-exception tracebacks.
+
+### Added
+
+- **Middle-click on the tray icon toggles play/pause.** Clicks the
+  PlayPause command on whichever MPRIS source Refrain is currently
+  attached to — same path as the tray-menu Play/Pause item, but
+  reachable without opening the menu. Plain left-click still opens
+  Settings; right-click still shows the menu.
+- **Tray menu actions now all carry icons.** Once any QMenu item
+  has an icon, the menu reserves the icon column for *all* items —
+  so adding the red ✕ to Quit Refrain made every previously
+  text-only action read as misaligned with blank icon space. Action
+  items now use freedesktop theme icons (`configure`,
+  `view-list-text`, `view-refresh`, `media-skip-backward`,
+  `media-playback-start`, `media-playback-pause`,
+  `media-skip-forward`) which match the user's Plasma / GNOME /
+  Breeze icon set. Update + Quit keep their bundled coloured-accent
+  SVGs. Source strings for the playback / restart actions dropped
+  their unicode-glyph prefixes (`⏮ ⏵ ⏸ ⏭ ⟳`) so the new icons
+  don't read as duplicates; all 9 .ts files updated to match. The
+  Quit ✕ glyph was redrawn to fill its 16×16 viewBox edge-to-edge
+  so it visually matches the theme icons' pixel weight.
+- **Song-info rows in the tray menu now render with proper icons
+  and full-strength text colour.** Title / Artist / Progress /
+  Discord-status used to be `setEnabled(False)` so KDE's DBusMenu
+  rendered them muted-grey + indented + iconless next to the white
+  action labels below. They're now enabled (a stray click opens
+  Settings — their natural "tell me more" target) and carry
+  `view-media-track`, `view-media-artist`, `chronometer`, and
+  `network-connect` / `network-disconnect` icons. The `♪` prefix
+  on the title and the `●/○` prefix on the Discord-status row are
+  gone — the icons replace them.
+
+### Fixed
+
+- **Settings → Updates "Latest release notes" QTextBrowser was
+  parent-less.** `_build_updates_tab` called
+  `notes_group.setLayout(QVBoxLayout())` on a QGroupBox that
+  already had a QFormLayout installed by `_new_group`. Qt refuses
+  to install a second layout (logs "QLayout: Attempting to add
+  QLayout to QGroupBox which already has a layout") so the new
+  VBoxLayout was discarded and the QTextBrowser ended up as a
+  free-floating top-level widget kept alive only by the Python
+  reference. In production it still painted because the parent
+  page laid it out somewhere reasonable, but it was outside the
+  widget tree (`findChildren(QTextBrowser)` returned 0). The view
+  is now added via the existing form layout's `addRow`.
+- **Discord handshake errors logged as ERROR-level unexpected
+  exceptions with a full traceback every retry.** When Discord
+  responded to a `pypresence.Presence.connect()` with an error
+  message (e.g. "User logged out" — DiscordError code 1000, or
+  "Invalid Client ID"), the bare `except Exception:` clause in
+  `_ensure_connected` swallowed it as a programmer bug and emitted
+  a noisy traceback every backoff cycle. `pypresence.exceptions.
+  DiscordError` is now caught explicitly and logged at INFO; the
+  back-off jumps straight to the 15 s ceiling so Refrain doesn't
+  retry tightly while the user is signing back into Discord or
+  fixing a typo'd client_id.
+- **First Discord push after a forced reconnect could be deduped
+  out of existence.** The presence-update dedupe cache lived on
+  the orchestrator across `Presence` instance replacements; after
+  a reconnect with byte-identical payload data, the new pipe
+  carried no state on Discord's side but our cache still claimed
+  "we already pushed this", so the user saw "no activity" until
+  metadata changed. `_last_payload` is now reset to None in the
+  successful-connect path of `_ensure_connected`.
+- **Empty artist row in tray menu when nothing was playing.** The
+  artist QAction stayed visible with empty text whenever no track
+  was active, rendering as a tall blank line right under
+  "(nothing playing)". Now hidden until a real track populates it.
+- **Settings → Updates "Latest release notes" pane stayed empty
+  on every Refrain restart within the 24-hour update-check
+  cooldown.** `maybe_check_on_startup` short-circuited *before*
+  fetching anything when the cooldown was active, so
+  `releaseInfoFetched` never fired and `set_latest_release` never
+  populated the inline pane. The v0.2.6 workaround — re-fetching
+  on Updates-tab activation with `manual=True` — additionally
+  fired the "up to date" / "update available" popups on every tab
+  visit, which was its own bug. Startup now always fetches the
+  release info (silent, no popups) so the pane is populated
+  immediately; the cooldown only gates whether that fetch *also*
+  triggers the auto-popup. The on-tab-activation fetch is gone.
+
+## [0.2.6] - 2026-05-07
+
+Localization expansion plus a bundle of reliability fixes accumulated
+since v0.2.5 across the config layer, restart path, cover cache, IPC
+sandbox bridge, and update flow.
+
+### Added
+
+- **8 new UI languages.** Refrain ships full translations (127 / 127
+  strings each) for Spanish (`es`), French (`fr`), Portuguese (`pt`),
+  Italian (`it`), Russian (`ru`), Polish (`pl`), Japanese (`ja`), and
+  Simplified Chinese (`zh_CN`) on top of the existing English source
+  + German. The Settings → Advanced → Language dropdown lists each
+  language under its native endonym ("Español", "Français",
+  "Português", "Italiano", "Русский", "Polski", "日本語",
+  "简体中文"). Picking a language restarts Refrain so the
+  QTranslator picks up the new `.qm`. Together with English and
+  German, this covers roughly 3 billion native speakers.
+
+### Fixed
+
+- **GitHub release bodies were one-line "Full Changelog: …"** — the
+  release workflow used `generate_release_notes: true`, which is
+  GitHub's auto-generated content (just a compare-link to the
+  previous tag). The in-app inline release-notes pane and the
+  popup dialog rendered that 79-character body verbatim. The
+  workflow now extracts the matching `## [X.Y.Z]` section from
+  CHANGELOG.md via awk and feeds it as the release `body_path`.
+  Existing v0.1.0 – v0.2.5 release bodies were backfilled out-of-
+  band via `gh release edit --notes-file …` against the same
+  extraction.
+- **Release-notes pane stayed empty after every Refrain restart** —
+  the orchestrator's 24-hour startup cooldown blocks
+  `maybe_check_on_startup` whenever `last_check_ts` is recent, and
+  a fresh process has no cached `_latest`. `SettingsWindow` now
+  emits `updatesTabRequested` when the user activates the Updates
+  tab; app.py wires that to a slot that triggers
+  `updater.check_now(manual=True)` only when no cached release is
+  available this session. First visit fetches in the background;
+  subsequent visits use the cache.
+- **`os.execvp` failure during Restart had no fallback** — if
+  `sys.argv[0]` wasn't a runnable script (typical of
+  `python -m refrain` source-checkout invocation, where argv[0] is
+  `__main__.py`), execvp raised an unhandled OSError. Detect
+  unrunnable paths up front and fall back to
+  `<sys.executable> -m refrain`, which always works because
+  Refrain is currently importable. The fallback is also retried
+  from the actual OSError handler if the first execvp fails for
+  any other reason.
+- **`Config.save` leaked .tmp files on write failure** — a disk-
+  full / read-only / permission-denied error during the atomic
+  write left a stale `*.tmp` sibling next to the real config
+  forever. Now wrapped in a `try/finally` that unlinks the partial
+  file before re-raising.
+- **`Config._format_value` didn't escape newline / tab / CR** —
+  any string value with those characters (extremely rare in our
+  schema, but possible via a hand-edited config or a future
+  field) would produce broken TOML that tomllib rejects on next
+  load, tripping the "config unreadable, using defaults" fallback
+  and silently losing every setting. Added `\n` / `\r` / `\t`
+  escapes alongside the existing `\\` / `\"`.
+- **CHANGELOG link `[0.2.1]` was a 404** — pointed at a non-
+  existent `v0.2.1` tag (the v0.2.1 commit was made but never
+  tagged or published; its content rolled into v0.2.2). Replaced
+  with a commit-hash link to `6b339ba`. ROADMAP gained a matching
+  `(rolled into v0.2.2; never separately tagged)` suffix.
+- **Settings → Apply with a non-writable config directory crashed
+  silently.** `Config.save` raised OSError (read-only home, disk
+  full, permissions). PySide6's signal-slot machinery logged
+  "uncaught exception in slot" and Apply visibly did nothing.
+  Now wrapped in try/except: the user gets a `QMessageBox.critical`
+  naming the path + the OS error, and the in-memory daemon state
+  still updates so the rest of the session works.
+- **`autostart.enable` / `disable` raised on filesystem failure**
+  with no user feedback. Now they return a bool and log a warning
+  on failure; Settings → Apply continues instead of crashing.
+- **Update dialog `_on_update_clicked` could TypeError on a
+  re-entered click** — `close_btn.clicked.disconnect()` raises if
+  the signal has no connections (unusual but possible during
+  fast double-clicks while runner setup is in flight). Wrapped
+  in `contextlib.suppress(TypeError)` like the matching
+  `_on_runner_finished` path.
+- **Refrain crashed at startup when no D-Bus session bus was
+  available** — `single_instance.acquire()` propagated
+  `dbus.DBusException` past `app.py`'s `except AlreadyRunning`,
+  giving the user an unhandled exception traceback instead of a
+  message box. New `SessionBusUnavailable` exception type
+  surfaces the actual reason ("D-Bus session bus unavailable")
+  with hints about `dbus-daemon` / `DBUS_SESSION_BUS_ADDRESS`.
+- **`setup_logging(level)` and `_apply_log_level` crashed on
+  non-string `log_level`** — a hand-edited config with
+  `log_level = false` (boolean) or `log_level = 5` (int) would
+  AttributeError on `.upper()`. Now coerced to str defensively.
+- **`Config._construct` accepted wrongly-typed values silently** —
+  `cover_cache_size = "200"` (string) would survive the dataclass
+  __init__ but then crash in `_prune_cover_cache` with TypeError on
+  `len(files) - "200"`. The new `_coerce_value()` helper coerces
+  primitives where it makes sense (int from numeric string,
+  bool from "true"/"false") and drops + warns when it doesn't
+  (e.g. `log_level = false` → use the field default). 1 new test
+  in test_config.py.
+- **Cover-art cache writes leaked .tmp files on disk failure** —
+  `cover_art._write_cache` and `download_cover_image` called
+  `tmp.write_bytes()` / `os.replace()` without exception
+  handling. A read-only `~/.cache/refrain/covers/` left a stale
+  `*.tmp` next to the real file forever. Both now wrap in
+  try/except, clean up the partial tmp, and log debug.
+- **`_bridge_sandboxed_ipc_socket` could raise on locked-down
+  sandbox dirs** — a permission-denied `iterdir()` of one of the
+  Snap/Flatpak candidate paths used to propagate up through
+  `DiscordRPC._ensure_connected` → daemon `_tick`'s except, killing
+  the connect attempt every poll. Now wrapped: failures log debug
+  and the connect proceeds without sandbox-bridging.
+- **iTunes search shape-check.** A malformed response (string
+  error, list-not-dict, missing fields) used to AttributeError
+  on `data.get("results", [])` or `first.get(...)`. Now both
+  layers check `isinstance(...)` first and treat unexpected
+  shapes as "no result" — caller falls back to the bundled
+  brand icon.
+- **`_prune_cover_cache` could crash daemon startup** on a
+  permission-denied or corrupt cache dir. Now wraps the
+  enumerate/sort in try/except, logs debug, returns 0 — the
+  daemon starts normally and lives without prune until next
+  session. Plus defensive int() coercion of `max_entries`.
+
+### Tests
+
+- 3 new in `tests/test_config.py` covering newline-escape
+  round-trip and the .tmp cleanup-on-failure path.
+
 ## [0.2.5] - 2026-05-07
 
 A same-day patch on top of v0.2.4 driven by user feedback that the
@@ -411,6 +631,11 @@ of reliability + UX work driven by live-testing the v0.2.1 build.
 
 ## [0.2.1] - 2026-05-06
 
+> **Note:** v0.2.1 was never tagged or published as a separate
+> release. The changes documented below were rolled into the
+> subsequent v0.2.2 release. Kept here for changelog continuity —
+> see [v0.2.2](#022---2026-05-06) for the actually-shipped delta.
+
 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,
@@ -844,12 +1069,14 @@ with a proper, installable Linux app.
   pip-audit, trufflehog, release), Dependabot, issue + PR templates,
   `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md`.
 
-[Unreleased]: https://github.com/Rockykln/refrain/compare/v0.2.5...HEAD
+[Unreleased]: https://github.com/Rockykln/refrain/compare/v0.2.7...HEAD
+[0.2.7]: https://github.com/Rockykln/refrain/compare/v0.2.6...v0.2.7
+[0.2.6]: https://github.com/Rockykln/refrain/compare/v0.2.5...v0.2.6
 [0.2.5]: https://github.com/Rockykln/refrain/compare/v0.2.4...v0.2.5
 [0.2.4]: https://github.com/Rockykln/refrain/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/Rockykln/refrain/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/Rockykln/refrain/compare/v0.2.1...v0.2.2
-[0.2.1]: https://github.com/Rockykln/refrain/compare/v0.2.0...v0.2.1
+[0.2.1]: https://github.com/Rockykln/refrain/commit/6b339ba
 [0.2.0]: https://github.com/Rockykln/refrain/compare/v0.1.5...v0.2.0
 [0.1.5]: https://github.com/Rockykln/refrain/compare/v0.1.4...v0.1.5
 [0.1.4]: https://github.com/Rockykln/refrain/compare/v0.1.3...v0.1.4

{refrain-0.2.5 → refrain-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: refrain
-Version: 0.2.5
+Version: 0.2.7
 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
@@ -153,6 +153,15 @@ registers their own (free, takes 30 seconds):
 4. Launch Refrain → *Settings → General → Discord Client ID* → paste,
    *Apply*.
 
+The first time you launch Refrain without a configured ID, the
+welcome wizard pops up with the setup steps + a live diagnostics
+panel that probes your D-Bus session and Discord IPC socket so you
+know up front whether your environment can host the RPC at all.
+
+<p align="center">
+  <img src="docs/screenshots/welcome.png" alt="Welcome wizard" width="560"/>
+</p>
+
 That's it. The status will appear in Discord on the next track change.
 
 ## Configuration
@@ -187,7 +196,7 @@ 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
+language = "system"                # "system" follows QLocale; "en", "de", "es", "fr", "pt", "it", "ru", "pl", "ja", "zh_CN" force a translation
 ```
 
 Per-source `client_id_*` fields let Apple Music render under one Discord

{refrain-0.2.5 → refrain-0.2.7}/README.md

@@ -119,6 +119,15 @@ registers their own (free, takes 30 seconds):
 4. Launch Refrain → *Settings → General → Discord Client ID* → paste,
    *Apply*.
 
+The first time you launch Refrain without a configured ID, the
+welcome wizard pops up with the setup steps + a live diagnostics
+panel that probes your D-Bus session and Discord IPC socket so you
+know up front whether your environment can host the RPC at all.
+
+<p align="center">
+  <img src="docs/screenshots/welcome.png" alt="Welcome wizard" width="560"/>
+</p>
+
 That's it. The status will appear in Discord on the next track change.
 
 ## Configuration
@@ -153,7 +162,7 @@ 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
+language = "system"                # "system" follows QLocale; "en", "de", "es", "fr", "pt", "it", "ru", "pl", "ja", "zh_CN" force a translation
 ```
 
 Per-source `client_id_*` fields let Apple Music render under one Discord

{refrain-0.2.5 → refrain-0.2.7}/ROADMAP.md

@@ -145,7 +145,7 @@ 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
+## Done — v0.2.1 (rolled into v0.2.2; never separately tagged)
 
 - **Settings UI overhaul** — consistent `QGroupBox` + form-layout
   across every tab, left-aligned group titles via stylesheet
@@ -285,14 +285,97 @@ What's done, what's next, what's deliberately not in scope.
 
 ## Up next — v0.3
 
-- **Polishing the wrapped i18n surface** — wrap the remaining
-  fixed-position strings (date formatters, advanced-tab subtitles,
-  bluetooth picker labels) so the German build covers everything a
-  user sees, not just the high-traffic widgets.
 - **Stable-release AUR build** that doesn't rely on the GitHub
   release tarball — switch to a `git`-source PKGBUILD pinned to the
   signed tag, so AUR users get the exact same commit the release
   workflow ships.
+- **Wrap the remaining fixed-position strings** (date formatters,
+  bluetooth picker labels) so every language reaches 100% coverage,
+  not just the high-traffic widgets.
+
+## Done — v0.2.7
+
+- **Tray-menu polish.** Every action carries an icon now —
+  freedesktop theme icons (`configure`, `view-list-text`,
+  `view-refresh`, `media-skip-{backward,forward}`,
+  `media-playback-{start,pause}`) for built-in actions plus the
+  bundled coloured-accent SVGs for Update / Quit. Source strings
+  for the playback / restart / Discord-status entries dropped
+  their unicode-glyph prefixes (`⏮ ⏵ ⏸ ⏭ ⟳ ●/○`); all 9 .ts
+  files updated. Quit ✕ glyph redrawn to fill its 16×16 viewBox.
+- **Song-info rows render with proper colour + icons.** Title /
+  Artist / Progress / Discord-status used to be `setEnabled(False)`
+  so KDE / GNOME's DBusMenu painted them muted-grey + indented +
+  iconless. They're now enabled (a click opens Settings) and
+  carry `view-media-{track,artist}`, `chronometer`, and
+  `network-{connect,disconnect}` icons.
+- **Middle-click on the tray icon toggles play/pause.** Same
+  PlayPause command as the tray-menu Play/Pause item, but
+  reachable without opening the menu.
+- **Discord handshake errors no longer crash-log.** `pypresence.
+  exceptions.DiscordError` (raised when Discord rejects the
+  handshake — "User logged out", "Invalid Client ID") fell
+  through the bare `except Exception:` and emitted a full
+  traceback every retry cycle. Now caught explicitly, logged at
+  INFO, with backoff jumping straight to the 15 s ceiling so
+  Refrain doesn't retry tightly while you sign back into Discord.
+- **First Discord push after a forced reconnect can no longer be
+  deduped out.** `_last_payload` is reset in the connect-success
+  path so the dedup cache from a previous Presence instance
+  doesn't suppress the first push on the new pipe.
+- **Settings → Updates "Latest release notes" pane populates on
+  every restart.** v0.2.6's startup auto-check short-circuited
+  before fetching when the 24h cooldown was active; the v0.2.6
+  workaround re-fetched on every Updates-tab visit. Both gone —
+  startup runs a silent fetch (no popups, no cooldown bump) so
+  the pane is populated immediately, while the cooldown still
+  gates the auto-nag popup.
+- **Empty artist row in tray menu when nothing was playing**
+  (`setVisible(False)` until a real track populates it).
+
+## Done — v0.2.6
+
+- **8 new UI languages** at 127/127 strings each: Spanish (`es`),
+  French (`fr`), Portuguese (`pt`), Italian (`it`), Russian
+  (`ru`), Polish (`pl`), Japanese (`ja`), Simplified Chinese
+  (`zh_CN`). Settings → Advanced → Language dropdown lists each
+  under its native endonym. Together with English + German this
+  covers ~3 billion native speakers.
+- **GitHub release bodies were one-line "Full Changelog: …"**
+  because the workflow used `generate_release_notes: true`. Now
+  extracts the matching `## [X.Y.Z]` section from CHANGELOG.md
+  via awk and feeds it as `body_path`; existing v0.1.0 – v0.2.5
+  bodies were backfilled out-of-band.
+- **Reliability sweep**: `os.execvp` Restart fallback to
+  `python -m refrain` when `argv[0]` isn't runnable;
+  Config.save .tmp cleanup on disk-full / read-only;
+  `Config._format_value` escapes `\n / \r / \t`;
+  `Config._construct` coerces wrongly-typed primitives (e.g.
+  `cover_cache_size = "200"`) instead of crashing in
+  `_prune_cover_cache`; cover-art `_write_cache` +
+  `download_cover_image` clean up `.tmp` siblings on disk
+  failure; `_bridge_sandboxed_ipc_socket` permission-error wrap;
+  iTunes Search shape-checks; `SessionBusUnavailable` exception
+  surfacing instead of bare DBusException; Apply error toast for
+  non-writable config dirs; `setup_logging`/`_apply_log_level`
+  coerce non-string `log_level`.
+
+## Done — v0.2.5
+
+- **AUR + Flatpak self-update spawns a terminal automatically**
+  running the package-manager command (`yay -Syu refrain` /
+  `flatpak update io.github.Rockykln.Refrain`) instead of just
+  showing the command in a popup. Falls back to the previous
+  message-box hint when no terminal is on PATH (probe list:
+  konsole, gnome-terminal, xfce4-terminal, kitty, alacritty,
+  foot, xterm, wezterm).
+- **pip auto-update detects "no-op" exits.** PyPI's CDN can lag
+  the GitHub Releases API by minutes, so a "0.2.X available"
+  check could succeed while pip exited 0 with "Requirement
+  already satisfied" (no upgrade). Refrain now parses pip's
+  stdout to distinguish "Successfully installed" from
+  "Requirement already satisfied" and tells the user to retry
+  shortly instead of restarting into the same version.
 
 ## Done — v0.2.2
 

{refrain-0.2.5 → refrain-0.2.7}/docs/screenshots/README.md

@@ -4,14 +4,16 @@ The README references screenshots from this directory. To regenerate them:
 
 | File                       | What to capture                                      |
 |----------------------------|------------------------------------------------------|
-| `tray-menu.png`            | Right-click the Refrain tray icon while a track plays. The full menu, with track name, artist, time and player controls visible. |
+| `tray-menu.png`            | Right-click the Refrain tray icon while a track plays. Captures title / artist / progress / Discord-status info rows + Previous / Play-Pause / Next / Settings / Live log / Restart / Quit, all with theme icons. |
 | `settings-general.png`     | Settings window → *General* tab, showing Discord client ID, Privacy combo, autostart, notifications, cover art, buttons. |
 | `settings-sources.png`     | Settings window → *Sources* tab, showing MPRIS toggle, Bluetooth toggle, and the paired-device dropdown populated. |
-| `settings-updates.png`     | Settings window → *Updates* tab. Auto-check on, last-checked timestamp visible, hint text wrapped. |
+| `settings-updates.png`     | Settings window → *Updates* tab. Auto-check on, last-checked timestamp visible, the "Latest release notes" pane populated from CHANGELOG. |
+| `settings-advanced.png`    | Settings window → *Advanced* tab, showing the Language dropdown (11 entries: System default + 10 native endonyms), poll interval, log level, cover cache size, idle grace, and the Reset-all-settings button. |
 | `update-dialog.png`        | The update-available dialog (only appears when a new version is found). Trigger it locally by editing `__version__` to something older and clicking *Check for updates now*. |
 | `discord-rpc.png`          | Cropped section of your Discord profile showing the "Listening to" card with cover art + elapsed/total timer. |
 | `notification.png`         | A desktop notification fired by Refrain on track change. KDE Plasma's notification with the album cover at left. |
 | `live-log.png`             | The live-log window, opened via tray → *Live log…*, with at least 10 lines of streamed log. |
+| `welcome.png`              | First-run welcome wizard — shown when no `client_id` is configured yet. Diagnostics panel + Discord-app guidance. |
 
 ## How to capture on KDE Plasma
 

{refrain-0.2.5 → refrain-0.2.7}/packaging/appimage/AppImageBuilder.yml

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

{refrain-0.2.5 → refrain-0.2.7}/packaging/aur/refrain/.SRCINFO

@@ -1,6 +1,6 @@
 pkgbase = refrain
 	pkgdesc = Discord Rich Presence for Apple Music on Linux
-	pkgver = 0.2.4
+	pkgver = 0.2.6
 	pkgrel = 1
 	url = https://github.com/Rockykln/refrain
 	arch = any
@@ -14,7 +14,7 @@ pkgbase = refrain
 	depends = python-dbus
 	depends = pyside6
 	optdepends = python-gobject: enables MPRIS-server publication so Plasma media controls reach Refrain
-	source = refrain-0.2.4.tar.gz::https://github.com/Rockykln/refrain/archive/v0.2.4.tar.gz
-	sha256sums = cb4e712a2809bd237c4ccaebd2cc81afa28286b4d260072f74bf94ce530a0ea3
+	source = refrain-0.2.6.tar.gz::https://github.com/Rockykln/refrain/archive/v0.2.6.tar.gz
+	sha256sums = d5d99a19be2b7414e7d7d1324c7893d2a227a60d15c14969d69102f9d2850294
 
 pkgname = refrain

{refrain-0.2.5 → refrain-0.2.7}/packaging/aur/refrain/PKGBUILD

@@ -1,7 +1,7 @@
 # Maintainer: Rockykln <contact@rockykln.com>
 
 pkgname=refrain
-pkgver=0.2.5
+pkgver=0.2.7
 pkgrel=1
 pkgdesc="Discord Rich Presence for Apple Music on Linux"
 arch=('any')
@@ -23,7 +23,7 @@ makedepends=(
     'python-wheel'
 )
 source=("$pkgname-$pkgver.tar.gz::https://github.com/Rockykln/refrain/archive/v$pkgver.tar.gz")
-sha256sums=('SKIP')
+sha256sums=('d5d99a19be2b7414e7d7d1324c7893d2a227a60d15c14969d69102f9d2850294')
 
 build() {
     cd "$pkgname-$pkgver"

{refrain-0.2.5 → refrain-0.2.7}/packaging/flatpak/io.github.Rockykln.Refrain.metainfo.xml

@@ -51,6 +51,38 @@
   <content_rating type="oars-1.1" />
 
   <releases>
+    <release version="0.2.7" date="2026-05-07">
+      <description>
+        <p>
+          Tray menu polish + Discord-RPC reliability. Every tray
+          action now carries an icon (theme-matched on Plasma /
+          GNOME / Breeze), the song-info rows render in normal text
+          colour with proper icons instead of greyed-out indented
+          rows, and middle-clicking the tray icon toggles
+          play/pause. Discord handshake errors (e.g. "User logged
+          out", "Invalid Client ID") are now caught explicitly
+          instead of crash-logged as unexpected exceptions, with a
+          longer back-off so Refrain doesn't retry tightly while
+          you're signing back in. The Settings → Updates
+          "Latest release notes" pane populates on every restart
+          regardless of the 24-hour update-check cooldown.
+        </p>
+      </description>
+    </release>
+    <release version="0.2.6" date="2026-05-07">
+      <description>
+        <p>
+          Localization expansion. Refrain now ships full UI
+          translations for 8 additional languages — Spanish,
+          French, Portuguese, Italian, Russian, Polish, Japanese,
+          and Simplified Chinese — covering an additional ~3
+          billion native speakers worldwide on top of English and
+          German. Also fixes the empty "Latest release notes" pane
+          that pipx-installed v0.2.5 showed on the Updates tab
+          when no auto-check had fetched the body yet.
+        </p>
+      </description>
+    </release>
     <release version="0.2.5" date="2026-05-07">
       <description>
         <p>

{refrain-0.2.5 → refrain-0.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "refrain"
-version = "0.2.5"
+version = "0.2.7"
 description = "Discord Rich Presence for Apple Music on Linux"
 readme = "README.md"
 requires-python = ">=3.11"

refrain-0.2.7/src/refrain/__init__.py

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