▶ ytm-player

Changelog

36 releases. Latest: v1.9.5 (2026-06-28). RSS.

  1. New features

    • Unified Tab / Shift+Tab section navigation — Tab and Shift+Tab now move focus between sections (track tables, result panels, Browse tab labels, and any visible sidebar) consistently on every page, with j/k/arrows moving within the focused section and Enter activating it. Previously only the Search page worked this way; other pages ignored Tab or repurposed it. On Browse, Tab highlights a tab label and Enter opens it.
    • Vim-style pane focus navigation — keyboard users can now move focus between the Playlists sidebar, main content, and visible lyrics pane with Ctrl+w h, Ctrl+w l, and Ctrl+w w. The Playlists shortcut auto-shows the sidebar if it is hidden. Thanks @860windtree (#107, #108).

    Changes

    • Queue track reorder moved off Tab — reordering the selected track now uses Shift+J / Shift+K (lowercase j/k move the cursor, as on every other page). It honours a count prefix, so 15 J moves the selected track down 15 positions in one step. This frees Tab / Shift+Tab on the Queue page for section navigation.
    • playerctl / media keys / now-playing work out of the box on Linux — the dbus-fast library that MPRIS needs now ships by default on Linux instead of behind an optional [mpris] extra, so a standard pip install ytm-player (or AUR / Nix install) exposes playerctl, hardware media keys, and desktop now-playing controls with no extra steps. ytm doctor reports MPRIS status and a one-time startup notice flags a broken or incomplete install, so the previous silent no-op can't recur. Thanks for the report @pironha2 (#110).

    Diagnostics

    • Crash files self-identify, and ytm doctor flags stale crashes — every crash log now records the app version, time, Python, and platform it was written under, and ytm doctor warns when the most recent crash predates the installed version (or predates version stamping). A stale, already-fixed crash from an older build no longer reads as a live bug.

  2. A broad release: community playlist and context-menu features, a batch of crash fixes across macOS, Windows, and Nix, and Discord Rich Presence working again.

    New features

    • Create playlist with metadata — the "New Playlist" flow now asks for name, description, and privacy (Private / Public / Unlisted) in a single modal, instead of defaulting to private with no description. New CreatePlaylistPopup replaces the minimal InputPopup. Thanks @Villoh (#79).
    • Edit playlist metadata — right-click any user playlist in the sidebar and choose "Edit Playlist" to rename it, update its description, or change privacy. The sidebar and the open library header update in place without reloading tracks. Thanks @Villoh (#79).
    • Enriched library playlist header — description, privacy status, and year now appear in the header alongside owner and track count. Thanks @Villoh (#79).
    • Sidebar count sync on add — adding tracks via the "Add to Playlist" picker bumps the target playlist's track count in the sidebar immediately, and duplicate adds prompt before re-adding. Thanks @Villoh (#79).
    • Auto-navigate on delete — deleting the currently open playlist from the sidebar returns you to the plain library view instead of leaving a ghost page. Thanks @Villoh (#79).
    • Remove a track from a playlist — the track action menu now offers "Remove from Playlist" when viewing one of your playlists, removing the track in place. Thanks @Villoh (#79).
    • Entity action consolidation — context menu actions (Play All, Shuffle Play, Add to Queue, Start Radio, Go to Artist, Subscribe) now work consistently for albums, playlists, and artists across all dispatch sites: sidebar, search results, track table column right-click, context page, library page, and browse page. "Shuffle Play" pre-shuffles for a one-time random order without enabling ongoing shuffle. "Play All" / "Shuffle Play" from sidebar and search start playback immediately and jump to the queue. Thanks @wgordon17 (#81).
    • Column-aware context menus — right-clicking the Artist column opens artist actions (Go to Artist, Play Top Songs, Start Radio, Subscribe); the Album column opens album actions (Play All, Shuffle Play, Add to Queue, Go to Artist). Multi-artist tracks show a picker first. Thanks @wgordon17 (#81).
    • Corporate SSL proxy support — set ca_bundle under [yt_dlp] to a custom CA certificate bundle so stream resolution works behind SSL-inspecting proxies (Zscaler, Netskope, etc.). A warning is logged if the path doesn't exist. Thanks @glywil (#98).
    • Richer Discord Rich Presence — the now-playing status shows the track's album art (falling back to the app icon), displays as Listening to YouTube Music, and includes elapsed time. Thanks @Wiibleyde (#103).

    Fixes

    • Discord Rich Presence connects again — the bundled application ID had been rejected by Discord, so presence never appeared. Registered a fresh app and made the ID configurable via [discord] client_id for anyone who wants to use their own. Reported by @Villoh (#88).
    • Crash setting ANSI themes — selecting ansi-dark / ansi-light (added in Textual 8.2.5) crashed the app because their colour tokens like ansi_cyan aren't parseable by Rich. They're now translated to the bare ANSI names. Thanks @dmnmsc (#89).
    • mpv not found with Homebrew installs — on macOS and Linuxbrew, libmpv lives outside the default library search path, so a non-brew Python (uv tool, pipx, distro) couldn't load it even though mpv was on PATH. ytm now searches the Homebrew prefixes, and ytm doctor reports libmpv loadability on its own line (#90, #101, #104).
    • Crash on Windows with the mpris extra — dbus-fast is Linux-only and raised an uncaught error at import; the extra is now marked Linux-only and the import is platform-gated, so uv sync --all-extras elsewhere degrades gracefully instead of crashing at startup. Thanks @Villoh (#106).
    • Spotify import builds on Nix again — the spotifyscraper derivation no longer fails on a sandboxed pip install during the build, so flake builds with the spotify extra work again. Thanks @peternaame-boop for both causing and fixing it (#93).
    • Nix flake: missing packaging dependency — the update checker crashed on flake builds because packaging wasn't declared. Now included, with an import check so it can't regress. Thanks @szx19970521 (#95, #105).

    Infrastructure

    • Faster Nix installs — the nixpkgs pin now points at a cached channel revision, so flake users download prebuilt dependencies instead of compiling them (notably Deno, pulled in by yt-dlp) from source.

    Docs

    • Install and troubleshooting docs now reference dbus-fast instead of the obsolete dbus-next (the code migrated in v1.9.3). Thanks @aaguilar-hub (#99).

  3. A small follow-up release: two crash fixes caught by manual smoke after v1.9.2, two CLI/utility fixes, plus three community PRs.

    New features

    • Configurable default theme — set theme under [ui] in config.toml to control which Textual theme loads on startup (default ytm-dark). Changing theme via Ctrl+P → Theme updates the current session only; the startup default is no longer overwritten by session state. To persist the active theme as the new default, use Ctrl+P → Theme: Set Current as Default. Thanks @Villoh (#85).
    • Theme: Set Current as Default command palette action — saves the currently active theme to config.toml so it becomes the startup default. Includes rollback on save failure (e.g. read-only filesystem) with an error toast.
    • Discovery round-robin — D now cycles deterministically through Charts → Trending → For You → Liked → Artist → Recently Played (was random source selection). Charts sub-rotates through its shelves between presses, and the Discovery label shows the active source (e.g. Discovery (US Daily Top 100)). Mood source dropped (the Moods & Genres tab was removed in v1.9.1 due to upstream crashes). Thanks @wgordon17 (#75).
    • Radio queues prepend their seed tracks — radio playback now starts with the seed before suggestions, matching YouTube Music's native behaviour. Append-mode background refill is unchanged. Thanks @wgordon17 (#75).
    • Persistent queue source header — Queue page shows Generated from: … beneath Now Playing for radio and discovery queues, with up to three seed titles inline and a tooltip for the full list. Toggle via [ui] show_queue_source (default on). Thanks @wgordon17 (#75).

    Fixes

    • Crash on Go to Artist / Album / Playlist — TrackTable and _ArtistAlbumList set up their columns in on_mount, but context._build_artist's nested-mount chain calls load_tracks / load_albums synchronously before on_mount fires, so add_row ran with 0 columns and raised ValueError: More values provided than there are columns. Both widgets now eager-init columns in __init__, eliminating the mount-order race.
    • Update check version comparison — _is_newer now uses packaging.version.Version for proper PEP 440 comparison. The hand-rolled tuple parser dropped non-numeric chunks and got post-releases (e.g. 1.6.0.post1) wrong.
    • ytm config with multi-arg $EDITOR — EDITOR="code -w" and similar now work; previously the whole string was passed as a single argv entry, so subprocess looked for an executable literally named code -w and failed. Malformed quoting (e.g. unbalanced quotes) now exits cleanly via the existing error path instead of crashing.
    • Search race conditions — fixed four interacting bugs that caused searches to require a second Enter, the suggestion overlay to re-appear on top of incoming results, and selecting a suggestion to cancel the in-flight search worker. Thanks @wgordon17 (#84).

    Changed

    • Theme persistence model — config.toml is now the authoritative source for the startup theme; session.json stores runtime state only and no longer restores the theme on launch. This separates user-authored configuration from app-managed session state.
    • Command palette provider architecture — app-specific commands moved from get_system_commands() to a dedicated YTMCommandProvider registered in App.COMMANDS. Isolates command definitions in src/ytm_player/app/_commands.py and keeps _app.py focused on app logic.

    Infrastructure

    • Pre-commit hooks + pyright in CI + dbus-fast migration — new .pre-commit-config.yaml runs ruff-format / ruff / pyright on commit and pytest on push (pre-commit install to activate). New CI job runs pyright at standard strictness. The Linux MPRIS service migrates from the unmaintained dbus-next to the maintained dbus-fast fork (identical API). Thanks @wgordon17 (#83).
    • Settings save Windows fallback — Settings.save() now falls back to a direct path.write_text() when os.replace() raises PermissionError (e.g. when config.toml is held open by an external editor on Windows).

  4. A focused fix release. The Charts page region selector was effectively non-functional — three structural bugs in how we read YouTube's chart response made a global event playlist appear regardless of region. Also includes a TrackTable migration that retires three hand-rolled DataTable pages and two related bug fixes.

    Charts — bug report thanks @dmnmsc (#73)

    • Events visually separated from country charts. YouTube injects a global event playlist (currently "Coachella 2026: Daily Top 100 Songs" — same playlist ID worldwide) at position 0 of every country's response. Previously the Charts page default-loaded that slot, so picking a country still showed the global Coachella playlist. The Charts page now renders two stacked pill rows: a Featured globally: strip for any shelves whose title carries a brand prefix (": " separator) and a country-charts row for the actual regional shelves. Country charts sort by priority — Top 100 Songs → Weekly Top Songs on Shorts → Trending 20 → rest — and the default-loaded pill is the first country chart, never an event. The event row hides automatically on narrow terminals (< 80 cols) to reclaim a row of vertical space.
    • Now reads daily + weekly + videos from the API. Previously only daily was consulted, which silently dropped Spain (returns its data under videos) and missed the Top 100 Songs / Top 100 Music Videos shelves under weekly for premium-supported regions. All three keys are now concatenated, then split into events vs charts.
    • Region picker expanded 17 → 68 entries. Global (ZZ) is the new default. The list now mirrors YouTube's full advertised set (62 codes from countries.options) plus six historically-supported codes outside that list (Hong Kong, Malaysia, Singapore, Taiwan, Thailand, Vietnam). Settings default flips region = "GB" → region = "ZZ".
    • Locale-style configs auto-normalise. New services/regions.normalise_region() helper strips locale tails — "ES-ES", "en-GB", "es_ES" now resolve to bare two-letter codes (ES, EN, ES) before hitting the API. YouTube's chart endpoint silently falls back to Global for any locale-shaped input; this prevents existing configs from being broken by that quirk.
    • _clean_shelf_title no longer strips brand prefixes. Coachella keeps its "Coachella 2026:" prefix on the pill so users can tell an event from a country chart at a glance.

    New

    • TrackTable migration on Queue, Liked Songs, Recently Played. Three pages migrated from raw DataTable to TrackTable. Gains right-click context menus, play indicators, column resize, filtering, and sorting — for free, on three pages that previously rolled those manually. Also retires the on_mouse_down right-click workaround we added to QueuePage in v1.9.0 (TrackTable already wires this up). Thanks @wgordon17 (#74).
    • [▶ Start Radio] button added to Liked Songs and Recently Played page headers — seeds a radio from 5 random tracks in the collection. Thanks @wgordon17 (#74).
    • Shuffle-lock integration on Liked Songs and Recently Played — selecting a track applies the per-collection shuffle preference. Thanks @wgordon17 (#74).
    • Discovery mix now cycles sources in fixed order (Charts → Trending → For You → Your Liked Songs → Artist → Recently Played) instead of random selection — guarantees variety across consecutive presses of D
    • Radio notifications now list all seed track names as a bulleted list instead of showing only the first seed or a generic label
    • Playlist radio notification now includes the playlist name (e.g. "Playing: Radio from My Playlist")

    Changed

    • Mood source removed from discovery mix — upstream removed Moods & Genres tab; the source was failing silently
    • clean_shelf_title and get_chart_shelf_tracks added as shared utilities for reuse in discovery mix

    Fixes

    • Radio track durations no longer show --:-- — ytmusicapi's get_watch_playlist returns duration under a length key (e.g. "3:07"), not duration. extract_duration() now checks duration_seconds → duration → length in priority order. Thanks @wgordon17 (#74).
    • Play history no longer stores duration as 0 — log_play was reading raw track.get("duration_seconds", 0), but normalized tracks store the value under duration. Switched to extract_duration() so the value is always correct regardless of source. Thanks @wgordon17 (#74).
    • TrackTable Duration column no longer cut off on first paint. The row-label column (which carries the ▶ playing indicator) reserves ~3 cells of width that the original column-fit pass didn't account for, so the rightmost column ("Duratio…") got pushed past the visible viewport on initial render. _fill_title_column now runs after load_tracks and append_tracks so the Title column shrinks to compensate as soon as rows exist.
    • Sidebar gains a bottom separator under the Playlists panel — the existing top separator (a Rule widget between the pinned-nav block and the LibraryPanel) is now mirrored below the LibraryPanel, so the Playlists panel sits between two matching $border-coloured horizontal rules instead of just one.

  5. This is the third and final wave of major updates in a rapid release cycle — quieter cadence ahead.

    A community-PR-driven feature release. Six PRs from @wgordon17 plus user-reported UX work, an AUR auto-publish pipeline, and a per-collection shuffle memory system. Distribution data milestone — crossed 10,000 lifetime PyPI downloads on the day this release was assembled.

    Supersedes the same-day v1.9.0 tag, which shipped two small regressions: the browser forward-stack got clobbered when clicking the current page's footer entry a second time, and the playback-bar Shuffle-lock dimming didn't refresh when starting a radio from the sidebar. Both are fixed in this release — install v1.9.1 directly.

    New features

    • "Start Radio" from playlist — context-menu entry in the sidebar plus a [▶ Start Radio] header button on the Library and Context pages. Backed by ytmusicapi's RDAMPL watch-playlist convention. New service method YTMusicService.get_playlist_radio(playlist_id). Six unit tests covering VL-prefix stripping, normal flow, exceptions, empty results, non-dict responses. Thanks @wgordon17 (#70).
    • Proactive radio refill — when ≤3 tracks remain in queue with autoplay on and repeat off, the app silently fetches more tracks in the background, seeded from up to 5 already-played items in the current queue. New methods _maybe_extend_queue / _extend_queue on PlaybackMixin. Thanks @wgordon17 (#71).
    • Multi-seed get_radio — service method now accepts a list of seeds, fetches in parallel via asyncio.gather, dedups by videoId, shuffles, and trims to limit. Backward-compatible at the signature level (single string still accepted). 8 dedicated tests. Thanks @wgordon17 (#71).
    • Single-seed shuffle guard — get_radio only shuffles the result pool when len(video_ids) > 1. Single-seed callers (the existing "Start Radio on track X" flow) keep their seed-first ordering. Two new tests covering single-seed-deterministic and multi-seed-shuffled behavior.
    • Discovery roulette — random mix from one of seven sources (trending, mood, charts, home, liked songs, library artist, recent history) with last-source-exclusion rotation to avoid repeats. New service method get_discovery_mix() -> tuple[list[dict], str]. 6 dedicated tests. Bound to the D keybinding (added by us alongside the merge — PR description had mentioned the binding but it didn't ship). Discovery is also reachable via the new "♫ Discovery Mix" item in the playlist sidebar's pinned-nav block. Help page lists the new action. Thanks @wgordon17 (#71).
    • Shuffle lock (per-playlist) — explicit toggle in the Library page playlist header (Shuffle lock: ON / Shuffle lock: off). When ON: opening that playlist forces shuffle, and the playback-bar shuffle button is dimmed and rejects clicks (with a toast pointing the user back to the lock toggle). When OFF: normal global shuffle behaviour. Persists per-playlist-ID to ~/.config/ytm-player/shuffle_prefs.json (LRU-capped at 1000 entries; thread-safe atomic JSON writes). Replaces the originally-planned implicit "remember last shuffle state" behaviour, which was un-discoverable and didn't actually persist via the playback-bar click path. New QueueManager.current_context_id + set_context() underpin the lookup. Session restore preserves queue_context_id so the lock identity survives a restart.
    • Configurable home shelf count — set home_shelves under [ui] in config.toml to control how many recommendation shelves are fetched on the Browse > For You tab (default 3, range 1–25). Shelves now scroll as a single section instead of independently, with subtle separators ($border) and theme-primary section titles for readability. Thanks @wgordon17 (#69).
    • Sidebar overflow config ([ui] sidebar_overflow) — "truncate" (default) guarantees exactly 1 row per playlist with a … ellipsis on overflow, or "wrap" to let names span multiple lines naturally. Implementation via a truncate-items CSS class on LibraryPanel plus a _render_text helper that picks the right strategy per mode.
    • Selection info bar — a 1-row strip mounted between the page body and the playback bar, displays the full name of the currently-focused item (sidebar playlist or TrackTable row). Toggleable via [ui] show_selection_info: bool = True. Replaces the old marquee/bouncing-text animation in playlist sidebars. The bar is gated on widget focus so it shows only what the user is actively navigating, not whatever auto-highlighted in a freshly-mounted panel.
    • Now-playing row indicator — every TrackTable now uses Textual's row-label feature to show a ▶ glyph in a dedicated 1-char column to the left of the index, marking the playing row independently of cursor state. Bold (no color) on data cells of the playing row provides a secondary at-a-glance signal. The glyph survives navigation away and back via cursor_foreground_priority="renderable" and an on_mount lookup of the app's current playing track. This pattern follows the canonical approach used by spotify-tui, ncmpcpp, and cmus.
    • Charts country support — get_charts(country=) now defaults to "GB" instead of YouTube's empty-data "ZZ" placeholder. New [ui] region config field (ISO 3166-1 alpha-2) lets users pin Charts to their preferred country without code changes. The Charts page now resolves the top daily chart playlist into a track table (ytmusicapi's get_charts no longer returns a flat songs list — daily/weekly/genres/artists chart playlists is the new shape).

    Fixes

    • macOS built-in keyboard media keys (prev/next) — built-in MacBook keyboards send key codes 19/20 (FAST/REWIND) instead of 17/18 (NEXT/PREVIOUS) that external keyboards use. The Quartz event tap now maps both sets. Verified against Apple's IOKit constants and Rogue Amoeba's canonical reference. Thanks @wgordon17 (#67).
    • Browse tab bar visibility — was rendering at height: 1 with border-bottom: solid on the active tab clipping its label. Now uses height: 4, border-bottom: tall, width: auto for content-sized tabs, hover state, $surface background, $border separator, plus 1-row top padding for breathing room from the page edge. Thanks @wgordon17 (#68).
    • yt-dlp android client fallback — madeForKids content (e.g., children's music tracks) was failing with "Video unavailable" on the default web client. yt-dlp now also tries the android client which falls through to a non-PoT legacy format that succeeds. Empirically validated: Baby Shark goes from broken to playing format-18 m4a audio. Normal songs unaffected. The line carries a # WHY: comment explaining the rationale so a future audit doesn't strip it as cargo-cult config. Thanks @wgordon17 (#72).
    • Moods & Genres sub-tab removed entirely — clicking a mood was producing a silent process-exit traceable past every Python-level handler in the audit (see docs/superpowers/specs/2026-04-30-mood-crash-findings.md). The remaining suspects are sub-Python (libmpv segfault, finaliser raise, etc.) and require runtime data we don't have. Pulled the tab rather than ship a feature that crashes the app on click. Tab order is now (For You, Charts, New Releases). The unused YTMusicService.get_mood_categories / get_mood_playlists wrappers were dropped at the same time — Discovery Mix calls the underlying ytmusicapi client directly, so the wrappers had no remaining callers.
    • KeyError from ytmusicapi parsers no longer counted as "unexpected" — added KeyError to _EXPECTED_API_EXCEPTIONS so _call treats parser drift as a recoverable API-side failure instead of letting it propagate as a "programming error." This was masking real upstream issues and surfacing crash files for routine YouTube response-shape changes.
    • Sidebar playlist track count now updates immediately after add — was reading the cached count field from the library payload and never bumping it after add_playlist_items succeeded, so the (N tracks) suffix stayed stale until the next library reload. New LibraryPanel.update_item_count(playlist_id, delta) primitive optimistically updates the cached count and rebuilds the affected row's label text. Wired into both _do_add and _do_create_and_add in playlist_picker. Tolerates VL-prefix mismatches in either direction. Leaves count = None (unknown) untouched rather than fabricating.
    • Queue right-click now opens the actions popup — previously did nothing because the Queue page uses a raw DataTable (not TrackTable), so the TrackRightClicked handler never fired. Added on_mouse_down on QueuePage that forwards button-3 clicks to _open_actions_for_track using the cursor row.
    • Track actions popup conditionally swaps "Add to Queue" ↔ "Remove from Queue" — when the track being right-clicked is currently in the playback queue, the menu shows "Remove from Queue" (action_id remove_from_queue) instead of "Add to Queue". Same menu slot, different label and action based on queue state. Detection happens at popup-open time by scanning queue.tracks for the track's video_id.
    • Forward stack no longer clobbered by same-page footer clicks (post-v1.9.0) — clicking the current page's footer entry a second time intentionally pops the previous page off the back stack, but the navigation path was treating it as a fresh forward navigation and clearing the forward stack along with it. Added a same_page_back flag so the forward stack survives the round-trip.
    • Sidebar Start Radio refreshes the Shuffle-lock visual state (post-v1.9.0) — starting a radio from the sidebar correctly applied the Shuffle-lock force-shuffle behaviour, but the playback-bar shuffle button's dim/non-dim state wasn't repainted to match. Added an explicit refresh_shuffle_lock_state() call on the playback bar from the sidebar Start-Radio path.

    Diagnostic infrastructure

    • faulthandler.enable(all_threads=True) — fatal-signal capture wired in cli.py after setup_logging. SIGSEGV/SIGBUS/SIGFPE/SIGILL/SIGABRT now leave a Python traceback for every thread in ~/.config/ytm-player/crashes/faulthandler.log before the kernel delivers the signal. Critical for catching libmpv/python-mpv C-side crashes that bypass sys.excepthook entirely.
    • asyncio loop exception handler — App.on_mount installs _asyncio_exception_handler via loop.set_exception_handler. Funnels "Task exception was never retrieved" warnings and any orphan-task errors into crashes/ytm-crash-*.log instead of the invisible-stderr default that Textual's alt-screen swallows.
    • sys.unraisablehook — install_excepthooks now also captures __del__ / weakref-callback / generator-close errors, labels them Unraisable in <obj>, and writes a crash file before chaining to sys.__unraisablehook__. Fixes a class of silent finaliser failures that were previously lost.
    • mpv log_handler + loglevel="warn" — Player constructs mpv.MPV(log_handler=...) so libmpv's internal warnings/errors hit the Python logger as mpv[<area>]: <message>. ytm doctor greps these out of ytm.log so libmpv issues are surface-level visible.
    • ytm doctor v2 — eight sections — version, paths, process status, recent ERROR/WARNING (filtered, last 20), recent mpv warnings, latest faulthandler trace, latest crash file, active-hooks summary. All output passes through a redaction layer that scrubs Authorization, Cookie, Bearer, token, x-goog-pageid, SAPISID so issue pastes never leak auth.
    • App-level _handle_exception override — the YTMPlayerApp overrides Textual's App._handle_exception (documented "Always results in the app exiting") to write a crash file via write_crash_file(), surface a toast, and not call super(). Keeps the TUI alive on otherwise-fatal worker / render / event errors so the user doesn't lose their queue position to a transient failure.
    • write_crash_file self-bootstraps — falls back to paths.CRASH_DIR when install_excepthooks was never called, and logs OSError instead of silently returning None. Fixes the "crashes dir empty after a real crash" diagnostic black hole.

    Charts

    • Country picker (c) — press c on Browse → Charts to open a filterable region modal. Type to filter on ISO code or country name; Enter to select; Esc to cancel. Selection persists to [ui] region in config.toml and triggers a chart refetch. New Action.PICK_COUNTRY enum entry, default binding c.
    • Region list trimmed to 17 empirically-verified working countries (Australia, Brazil, Canada, France, Germany, Hong Kong, Japan, Malaysia, Mexico, Singapore, South Korea, Taiwan, Thailand, UAE, UK, US, Vietnam). YouTube's countries.options advertises 62 but most return no daily-chart data even with auth; trimmed to the subset that actually displays tracks.
    • Daily-shelf pills — clickable pill row above the track table shows all available daily chart shelves for the selected country (typically Daily Top 100 / Trending 20 / Daily Top Videos / Daily Top Songs (Shorts) — labels stripped of brand prefixes like Coachella 2026: and country suffixes). Click a pill to swap the table to that shelf's playlist. HorizontalScroll container keeps pills usable on narrow terminals.
    • OLAK5 playlist fallback — Trending shelves use OLAK5-prefixed auto-generated playlist IDs that ytmusicapi's get_playlist chokes on (tracks[0]['album'] is None → TypeError). ChartsSection._load_active_daily detects the prefix and uses get_watch_playlist instead, which calls a different endpoint and parses correctly. Service-layer YTMusicService.get_watch_playlist extended to accept a playlist_id-only call shape (was video-only before).
    • Empty-region UX — a region picked with no chart data now shows "No chart data available for <country>. YouTube Music coverage varies by region — press 'c' to pick a different one." instead of the previous catch-all "Failed to load charts.".

    Navigation

    • Browser-style back / forward — ← Back and Forward → buttons in the header bar (next to ☰ Playlists). Auto-hide on root pages and at the front of history. Keys: Backspace (back), Shift+Backspace (forward). Forward stack invalidates on any non-back/forward navigation, matching every browser/file-explorer.
    • Click bubbling fix — Action.PICK_COUNTRY was missing from app/_keys.py:_handle_action's page-delegation allowlist, so c silently no-op'd when first shipped. Added the entry; same _app-header ID-based HeaderBar lookup as the rest of the codebase.

    UI / theming

    • Marquee removed from sidebars — _BouncingLabel (the bouncing-text animation that fired on highlighted playlist names that overflowed) deleted entirely (~60 lines). Replaced with static truncate-with-ellipsis. Long names show Some long playlist nam…; the full name surfaces in the new selection info bar when the item is highlighted.
    • Bottom-stack layout reflow — SelectionInfoBar, PlaybackBar, and FooterBar are now wrapped in a single Vertical(id="bottom-stack") docked to the bottom. Order top-to-bottom: info bar (1 row) → playback bar (4 rows) → footer (1 row). Replaces the previous three-sibling-dock-bottom approach which produced inconsistent stacking.
    • truncate() uses Unicode … instead of three ASCII dots. Frees 2 chars of visible content space; matches every modern UI's truncation idiom.
    • CONTRIBUTING.md "Theming & UI" section — documents the rule that all widget colors flow through theme.py variables ($primary, $text, $surface, $border, $accent, $secondary, $text-muted) and that hardcoded hex colors in widget CSS are forbidden because they break custom theme.toml files. Closes a contributor-docs gap surfaced during PR #69 review.

    Refactors / internal

    • type: ignore[attr-defined] removed in PR #70's _start_playlist_radio call sites in context.py and library.py. Replaced with the project-standard cast("YTMHostBase", self.app)._start_playlist_radio(...) pattern. Added stub method to _base.py:YTMHostBase (CLEANUP-1).
    • _fetch_and_play_radio, _start_discovery_mix, _start_playlist_radio, shuffle_prefs, home_shelves, region, show_selection_info, sidebar_overflow — all added as TYPE_CHECKING stubs / config fields with the project's existing patterns.
    • _BouncingLabel and timing constants (_BOUNCE_INTERVAL, _BOUNCE_PAUSE) removed.

    Infrastructure / release engineering

    • AUR auto-publish workflow — new .github/workflows/aur-publish.yml triggered after the Publish workflow succeeds. Clones the AUR ytm-player-git repository via SSH key (stored in secrets.AUR_SSH_PRIVATE_KEY), copies aur/PKGBUILD, regenerates .SRCINFO via the new scripts/regenerate_srcinfo.py helper, commits, and pushes. Gated on event.workflow_run.event == 'push' so TestPyPI dry-runs don't trigger a real AUR push.
    • scripts/regenerate_srcinfo.py — pure-Python .SRCINFO generator that parses aur/PKGBUILD (handles scalar fields, array fields, multi-line arrays, single/double quotes, shell-variable expansion via _expand_vars, and emits the canonical key-value format consumed by AUR). Runs on Ubuntu CI runners without requiring Arch Linux base-devel. 6 unit tests covering parser primitives, repo-PKGBUILD round-trip, and emit format.
    • RELEASING.md — repo-root release procedure. Documents the tag-driven flow (bump __version__ → tag vX.Y.Z → push), what each automated workflow does (publish.yml, aur-publish.yml), the manual fallback for the AUR push if the action fails, the one-time setup for AUR SSH keys + GitHub secrets + PyPI trusted publishing, the dry-run path via TestPyPI, and the distribution-channel matrix (PyPI/AUR/GitHub Release automated; NixOS flake manual; Gentoo GURU community-maintained by @dsafxP).
    • AUR_SSH_PRIVATE_KEY and AUR_KNOWN_HOSTS repo secrets configured (one-time setup).

    Coming next

    • UX polish (4-8 from the in-session UX review) — Library track-count subtitle, Search panel border deduplication + mode-toggle markup cleanup, Browse active-tab visual weight, Queue "Now Playing" header hierarchy.

    Session note — release engineering

    This release was assembled across one long session that pushed 50+ commits to public master, including ~14 UI-iteration commits that should have lived on a feature branch. Going forward: UI-iteration sagas land on dev, get squash-merged into master as one clean commit per saga.