refrain 0.2.6__tar.gz → 0.2.7__tar.gz

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

@@ -7,6 +7,96 @@ 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
@@ -979,7 +1069,8 @@ 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.6...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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: refrain
-Version: 0.2.6
+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.6 → 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.6 → refrain-0.2.7}/ROADMAP.md

@@ -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.6 → 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.6 → 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.6
+    version: 0.2.7
     exec: usr/bin/python3
     exec_args: -m refrain $@
 

{refrain-0.2.6 → 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.5
+	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.5.tar.gz::https://github.com/Rockykln/refrain/archive/v0.2.5.tar.gz
-	sha256sums = 7ee7b991fab3ba2149fe72745b1432ef11abd7714ffba71cafd3bf1b6af5a6c4
+	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.6 → refrain-0.2.7}/packaging/aur/refrain/PKGBUILD

@@ -1,7 +1,7 @@
 # Maintainer: Rockykln <contact@rockykln.com>
 
 pkgname=refrain
-pkgver=0.2.6
+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=('7ee7b991fab3ba2149fe72745b1432ef11abd7714ffba71cafd3bf1b6af5a6c4')
+sha256sums=('d5d99a19be2b7414e7d7d1324c7893d2a227a60d15c14969d69102f9d2850294')
 
 build() {
     cd "$pkgname-$pkgver"

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

@@ -51,6 +51,24 @@
   <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>

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "refrain"
-version = "0.2.6"
+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"

{refrain-0.2.6 → refrain-0.2.7}/src/refrain/app.py

@@ -390,25 +390,35 @@ class UpdateOrchestrator(QObject):
         self._thread: QThread | None = None
         self._worker: _UpdateCheckWorker | None = None
         self._manual = False
+        # When True, the in-flight check is purely for populating the
+        # in-app release-notes pane — suppress all popups and don't
+        # bump last_check_ts (which gates the auto-nag cooldown).
+        self._silent = False
 
     @property
     def latest(self) -> ReleaseInfo | None:
         return self._latest
 
     def maybe_check_on_startup(self) -> None:
+        """Always fire one fetch on startup so the Settings → Updates
+        pane has data immediately. The 24-hour cooldown only gates
+        whether this fetch can ALSO trigger the auto-popup for new
+        releases — within the cooldown the fetch runs silently and
+        only refreshes the inline release-notes pane."""
         if not self._config.update.auto_check:
             return
         elapsed = time.time() - self._config.update.last_check_ts
-        if elapsed < self.UPDATE_CHECK_COOLDOWN_S:
-            log.debug("Auto-update check skipped (cooldown, %.0fs since last)", elapsed)
-            return
-        self.check_now(manual=False)
+        silent = elapsed < self.UPDATE_CHECK_COOLDOWN_S
+        if silent:
+            log.debug("Auto-update check running silently (cooldown active)")
+        self.check_now(manual=False, silent=silent)
 
-    def check_now(self, manual: bool = True) -> None:
+    def check_now(self, manual: bool = True, silent: bool = False) -> None:
         if self._thread is not None:
             log.debug("Update check already in progress")
             return
         self._manual = manual
+        self._silent = silent
         self._thread = QThread()
         self._thread.setObjectName("refrain-update-check")
         self._worker = _UpdateCheckWorker()
@@ -418,11 +428,21 @@ class UpdateOrchestrator(QObject):
         self._thread.start()
 
     def _on_check_finished(self, release: ReleaseInfo | None) -> None:
-        self._config.update.last_check_ts = int(time.time())
-        try:
-            self._config.save()
-        except Exception as e:
-            log.debug("Could not persist last_check_ts: %s", e)
+        manual = self._manual
+        silent = self._silent
+        self._manual = False
+        self._silent = False
+
+        # Only bump the cooldown timestamp when this was a real auto-
+        # nag check. A silent pane-refresh shouldn't reset the cooldown
+        # — otherwise every startup would block the next day's auto-
+        # nag. Manual checks always count as "I just checked".
+        if not silent:
+            self._config.update.last_check_ts = int(time.time())
+            try:
+                self._config.save()
+            except Exception as e:
+                log.debug("Could not persist last_check_ts: %s", e)
 
         if self._thread is not None:
             self._thread.quit()
@@ -430,9 +450,6 @@ class UpdateOrchestrator(QObject):
             self._thread = None
             self._worker = None
 
-        manual = self._manual
-        self._manual = False
-
         # Always fan out the raw fetch result so subscribers (Settings
         # tab, etc.) can render whatever state they want regardless of
         # whether this constitutes "an update". Cache it too so a
@@ -441,6 +458,15 @@ class UpdateOrchestrator(QObject):
             self._latest = release
         self.releaseInfoFetched.emit(release)
 
+        # Silent fetches stop here — the pane is populated, no nags.
+        if silent:
+            log.info(
+                "Silent update check finished: latest=%s, current=%s",
+                release.version if release else "?",
+                __version__,
+            )
+            return
+
         if release is None:
             log.info("Update check: no release info returned")
             if manual:
@@ -608,19 +634,6 @@ def main() -> int:
     )
     updater.releaseInfoFetched.connect(settings.set_latest_release)
 
-    # Auto-fetch on first visit to Settings → Updates so the inline
-    # release-notes pane populates without the user needing to click
-    # "Check for updates now". Skipped when we already have a cached
-    # release this session — re-fetching every tab open is wasteful
-    # and can hit GitHub's unauthenticated rate limit on multi-restart
-    # debug sessions. The 24-hour startup cooldown stays in place for
-    # actual auto-checks; this is opt-in via tab activation.
-    def _maybe_fetch_for_tab() -> None:
-        if updater.latest is None and updater._thread is None:
-            updater.check_now(manual=True)
-
-    settings.updatesTabRequested.connect(_maybe_fetch_for_tab)
-
     # Log-window wireup
     def _show_log() -> None:
         log_window.show()

refrain-0.2.7/src/refrain/assets/icons/menu-quit.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="16" height="16">
+  <path d="M 2.5 4 L 4 2.5 L 8 6.5 L 12 2.5 L 13.5 4 L 9.5 8 L 13.5 12 L 12 13.5 L 8 9.5 L 4 13.5 L 2.5 12 L 6.5 8 Z" fill="#da4453"/>
+</svg>

{refrain-0.2.6 → refrain-0.2.7}/src/refrain/discord_rpc.py

@@ -143,6 +143,12 @@ class DiscordRPC:
             p.connect()
             self._presence = p
             self._backoff_s = 2.0
+            # A fresh IPC pipe carries no state on Discord's side —
+            # so the dedup cache from a *previous* presence object
+            # would wrongly skip the first update on the new
+            # connection (Discord would then keep showing nothing
+            # until the daemon picks up a metadata change).
+            self._last_payload = None
             log.info("Discord RPC connected")
             return True
         except (
@@ -153,6 +159,17 @@ class DiscordRPC:
             OSError,
         ) as e:
             log.debug("Discord RPC connect failed: %s", e)
+        except ppx.DiscordError as e:
+            # Discord accepted the IPC pipe but sent back an error
+            # response to the handshake. Common reasons:
+            #   - "User logged out": user signed out of Discord
+            #   - "Invalid Client ID": client_id is malformed / not a
+            #     Discord application (Settings → Discord input typo)
+            # These aren't bugs in Refrain — log at INFO and back off
+            # longer than the standard transient-error retry, since
+            # the user has to take action (sign back in, fix ID).
+            log.info("Discord RPC handshake rejected: %s", e)
+            self._backoff_s = self._max_backoff_s
         except Exception:
             log.exception("Discord RPC connect unexpected error")
         self._presence = None

{refrain-0.2.6 → refrain-0.2.7}/src/refrain/i18n/refrain_de.ts

@@ -420,24 +420,24 @@ Nach dem Bestätigen unten im Einstellungen-Fenster auf „Übernehmen“ klicke
     <message>
         <location filename="../ui/tray.py" line="81"/>
         <location filename="../ui/tray.py" line="174"/>
-        <source>○  Discord: not connected</source>
-        <translation>○  Discord: nicht verbunden</translation>
+        <source>Discord: not connected</source>
+        <translation>Discord: nicht verbunden</translation>
     </message>
     <message>
         <location filename="../ui/tray.py" line="84"/>
-        <source>⏮  Previous</source>
-        <translation>⏮  Zurück</translation>
+        <source>Previous</source>
+        <translation>Zurück</translation>
     </message>
     <message>
         <location filename="../ui/tray.py" line="86"/>
         <location filename="../ui/tray.py" line="159"/>
-        <source>⏵  Play</source>
-        <translation>⏵  Wiedergabe</translation>
+        <source>Play</source>
+        <translation>Wiedergabe</translation>
     </message>
     <message>
         <location filename="../ui/tray.py" line="88"/>
-        <source>⏭  Next</source>
-        <translation>⏭  Weiter</translation>
+        <source>Next</source>
+        <translation>Weiter</translation>
     </message>
     <message>
         <location filename="../ui/tray.py" line="102"/>
@@ -457,8 +457,8 @@ Nach dem Bestätigen unten im Einstellungen-Fenster auf „Übernehmen“ klicke
     </message>
     <message>
         <location filename="../ui/tray.py" line="111"/>
-        <source>⟳  Restart Refrain</source>
-        <translation>⟳  Refrain neu starten</translation>
+        <source>Restart Refrain</source>
+        <translation>Refrain neu starten</translation>
     </message>
     <message>
         <location filename="../ui/tray.py" line="113"/>
@@ -467,8 +467,8 @@ Nach dem Bestätigen unten im Einstellungen-Fenster auf „Übernehmen“ klicke
     </message>
     <message>
         <location filename="../ui/tray.py" line="157"/>
-        <source>⏸  Pause</source>
-        <translation>⏸  Pause</translation>
+        <source>Pause</source>
+        <translation>Pause</translation>
     </message>
     <message>
         <location filename="../ui/tray.py" line="164"/>
@@ -477,8 +477,8 @@ Nach dem Bestätigen unten im Einstellungen-Fenster auf „Übernehmen“ klicke
     </message>
     <message>
         <location filename="../ui/tray.py" line="172"/>
-        <source>●  Discord: connected</source>
-        <translation>●  Discord: verbunden</translation>
+        <source>Discord: connected</source>
+        <translation>Discord: verbunden</translation>
     </message>
 </context>
 <context>