mirror of https://github.com/Psychotoxical/psysonic.git synced 2026-07-21 23:05:46 +00:00

Files

T

Psychotoxical 9b239892ef chore: bump version to 1.34.6, add changelog

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-08 22:36:59 +02:00

141 KiB

Raw Blame History

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.34.6] - 2026-04-08

I'm sorry this is already the third release today — every time we shipped a critical fix, another critical issue surfaced. Hopefully this one holds. 🤞

🚨 Critical Fix

ZIP downloads no longer freeze the UI: All ZIP downloads (Album Detail, Playlist Detail, Albums, New Releases, Random Albums) previously buffered the entire file in the JS heap via fetch + blob + arrayBuffer, which caused the app to become completely unresponsive for large downloads (e.g. a 600-song, 7 GB playlist). Downloads now stream directly to disk via the Rust backend (invoke('download_zip')), matching the existing single-album download behavior. Progress is shown in the download overlay (bottom right).
Offline cache downloads no longer freeze the UI: Caching a large playlist (600+ songs) triggered up to ~1,200 synchronous localStorage.setItem calls as Zustand's persist middleware wrote on every state update. Transient download job state has been moved to a new non-persisted store (offlineJobStore), reducing localStorage writes for an entire download to 2 regardless of playlist size.

Added

Playlist offline toggle: When a playlist is already cached offline, clicking the cache button now removes it from the offline cache (shown with a red trash icon) instead of re-downloading it.

Fixed

Home page — "Recently Added" section title now links to /new-releases instead of /albums.

[1.34.5] - 2026-04-08

🚨 Critical Fix

Massive API request flood fixed (closes #133): Psysonic was generating 15,000+ background requests per day, filling reverse-proxy access logs (Traefik, nginx) and in some cases crashing the proxy entirely. Four root causes identified and resolved:
- Now Playing polling: Was firing every 10 seconds unconditionally — even when minimized or the dropdown was closed. Now only polls while the dropdown is open, and respects the Page Visibility API to pause immediately when the window is hidden.
- Connection check interval: Reduced from every 30 seconds to every 120 seconds (4× reduction).
- Queue sync debounce: Increased from 1.5 s to 5 s, preventing request bursts when skipping rapidly through tracks.
- Rating prefetch cache: Artist and album ratings are now cached in memory for 7 minutes. Repeated page loads (Random Albums, Random Mix) no longer re-fetch ratings that were just retrieved.

Added

Theme Scheduler (Settings → Appearance): Automatically switches the active theme at configurable times of day. Two time slots (e.g. a light theme during the day, a dark one at night). English locale displays hours in 12-hour AM/PM format; all other languages use 24-hour format.
Theme Scheduler hint: When the scheduler is active, a notice appears at the top of the Theme Picker explaining why manually selecting a theme has no immediate effect.
UI Scale (Settings → Appearance): Adjust the global interface scale (80 % – 125 %) without changing the system font size.
Folder Browser: New sidebar section with Miller-columns directory navigation. Browse the server's music folder tree and play or queue folders directly.
Seekbar — Waveform fade edges: The Waveform seekbar style now fades out at both ends, giving it a cleaner, less abrupt look.
Cover art fallback logo: When a cover art image fails to load (broken URL, server error), the Psysonic logo is shown as a placeholder instead of a broken image icon.
Tiling WM support (PR #134): On tiling window managers (Hyprland, Sway, i3, bspwm, AwesomeWM, etc.) the custom title bar is automatically hidden — the WM manages window decorations. The title bar toggle in Settings is also hidden on tiling WMs. Detection is based on environment variables (HYPRLAND_INSTANCE_SIGNATURE, SWAYSOCK, I3SOCK, XDG_CURRENT_DESKTOP).

Changed

Custom title bar disabled by default: New installations start with the native OS title bar. Existing users keep their saved preference.

Fixed

Custom title bar (Linux) — drag & resize: Window dragging via the title bar now works correctly (missing Tauri core:window:allow-start-dragging capability was silently blocking it). CSS resize grips are now shown at the bottom corners to compensate for the removed native GTK grips. The title bar no longer misplaces itself when the window is resized to a small width (mobile-grid layout now includes the title bar row).
Fullscreen Player — accent color delay: The dynamic accent color extracted from album artwork now appears in ~200–300 ms instead of up to 18 seconds. The previous implementation queued the cover fetch behind up to 5 concurrent image loads via the app-wide image cache. It now fetches the cover directly and independently. The extracted color is also cached per cover ID, so switching between tracks on the same album is instant.
Artist Detail page — slow initial render (closes #132): Artist info and biography are now fetched independently of the main artist data, so the page renders immediately and the bio fades in once available. Previously, a slow getArtistInfo response blocked the entire page from rendering.
Seekbar — Pulse Wave & Retro Tape styles: Pulse Wave no longer leaves a stray connecting line at the playhead position. Retro Tape's rolling wheel is now anchored at the playhead instead of the center of the bar.
Statistics — Top Rated Songs/Artists sections removed: These sections were incorrectly added in v1.34.4 and have been removed. All other rating features from that release remain fully intact.

[1.34.4] - 2026-04-08

Added

Entity ratings (PR #130): Full star-rating support (1–5 ★) for songs, albums, and artists via the OpenSubsonic setRating API. Ratings are shown and editable in the album track list, artist detail page, and the Favorites song list. A new shared StarRating component is used consistently across all surfaces. Requires an OpenSubsonic-compatible server (e.g. Navidrome ≥ 0.53).
Song ratings — context menu & player bar: Songs can additionally be rated directly from the right-click context menu and from the player bar (below the artist name), with optimistic updates reflected immediately across all views.
Skip-to-1★ (PR #130): Automatically assigns a 1-star rating to a song after it has been manually skipped a configurable number of consecutive times. This skip count threshold can be enabled and adjusted in Settings → Ratings.
Mix minimum rating filter (PR #130): Random Mix and Home Quick Mix can now be filtered by minimum rating per entity type (song / album / artist). Configure thresholds in Settings → Ratings.
Statistics — Top Rated Songs & Artists: New "Top Rated Songs" and "Top Rated Artists" sections on the Statistics page, derived from starred items with a userRating > 0. Lists update live as ratings are changed without a page reload.
Seekbar styles — 5 new styles: Added Neon Glow, Pulse Wave, Particle Trail, Liquid Fill, and Retro Tape. Animated styles run a dedicated requestAnimationFrame loop. The style picker in Settings shows an animated live preview for each style.
Custom title bar (Linux): Optional custom title bar with now-playing display (song title + artist, live-updating). Replaces the native GTK decoration when enabled. Automatically hides in native fullscreen (F11). Can be toggled in Settings → Appearance.
Album multi-select: Albums, New Releases, and Random Albums pages now support multi-select mode. Selected albums can be batch-queued or enqueued.
Most Played — compilation filter: New toggle on the Most Played page to hide compilation artists from the Top Artists list.
Scroll reset on navigation: The content area now scrolls back to the top automatically on every route change.

Fixed

Backup: The psysonic_home key is now included in the settings backup export.

i18n

New keys for seekbar styles, entity ratings, rating sections (Settings + Statistics), and entity rating support added to all 7 languages (EN, DE, FR, NL, ZH, NB, RU).

[1.34.3] - 2026-04-07

Added

Most Played page (closes #86): New dedicated page accessible via the sidebar (TrendingUp icon, /most-played). Shows Top Artists (ranked by total play count, derived by aggregating album play counts per artist) and a paginated Top Albums list with cover art, play count, sort toggle (most/fewest first), and a Load More button.
Playlist ZIP download (closes #127): Download (ZIP) button in the playlist hero header — same UX as album download. Uses the Subsonic /rest/download.view endpoint with the playlist ID, shows a progress bar during transfer, and remembers the last used folder.
Fullscreen Player — adaptive accent color: Extracts the most vibrant pixel from the current album cover (8×8 Canvas downscale, max-HSL-saturation) and applies a WCAG 4.5:1-compliant accent as --dynamic-fs-accent. Song title, play button, seekbar, active states, background mesh blobs, and cover art glow all transition smoothly to the extracted color. Resets to the theme accent when the player closes.
Dracula theme: Added to the Open Source Classics group.
Discord Rich Presence — Apple Music cover opt-in: iTunes artwork lookup is now disabled by default. A new toggle in Settings → Integrations ("Fetch covers from Apple Music for Discord") must be explicitly enabled — it sends artist and album name to Apple's search API to find cover art for the Discord profile.
Discord Rich Presence — Paused state: When playback is paused, the Discord presence now shows "Paused" as the status text.

Fixed

M4A playback — older iTunes-purchased files: Files with an embedded MJPEG cover-art stream and an iTunSMPB gapless tag now play correctly. The Symphonia isomp4 patch skips malformed trak atoms gracefully; parse_gapless_info now searches for the " 00000000 " sentinel to skip the 16-byte binary data-atom header, correctly extracting encoder delay and total sample count.

i18n

New keys for the Most Played page, playlist download, and Discord Apple Music opt-in added to all 7 languages (EN, DE, FR, NL, ZH, NB, RU).

[1.34.2] - 2026-04-07

Added

M4A / ALAC / AAC-LC support (closes #51): Apple Lossless (ALAC) and AAC-LC files in M4A containers are now decoded natively by the Rust audio engine (Symphonia) without requiring server-side transcoding.
Per-server music folder filter (PR #125 by @cucadmuh): Users with multiple music libraries on their Navidrome server can now scope browsing to a single folder. A dropdown in the sidebar (visible only when more than one library exists) lets you pick a folder or switch back to "All Libraries". The selection is persisted per server and automatically resets to "All" if the selected folder is no longer available.
Hi-Res / Bit-Perfect Playback (Alpha): New opt-in toggle in Settings → Playback. When enabled, the audio output stream is re-opened at the file's native sample rate (e.g. 88.2 kHz, 96 kHz) — bypassing rodio's internal resampler for a bit-perfect signal path. Disabled by default (safe 44.1 kHz mode). Includes ALSA/PipeWire underrun hardening: scaled quantum size, 500 ms sink pre-fill at high rates, and scheduler priority escalation only when needed.
Hot Playback Cache (Alpha, PR #123 by @cucadmuh): Configurable on-disk prefetch cache for the next track in the queue. Reduces playback latency on slow or metered connections. Toggle and directory can be configured in Settings → Storage.

Changed

Fullscreen Player — info block reworked: The track title is now the dominant element (large, bold, accent color) and sits above the artist name (small, muted). Matches community feedback on visual hierarchy.
Fullscreen lyrics — line wrapping: Long lyric lines now wrap onto a second line instead of being truncated. Slot height increased from 3.6 vh to 6 vh to accommodate two-line entries without breaking rail positioning.
Update notifications: Removed the Tauri auto-updater (in-app download and install). The app now shows a simple dismissible toast when a newer version is detected on GitHub, with direct links to the GitHub Releases page and the Psysonic website. No signing keys, no update manifests.

Fixed

Standard mode CPU usage: Playing a 44.1 kHz MP3 with Hi-Res disabled no longer triggers an unnecessary audio device re-open on every track start. MSS read-ahead buffer reduced from 4 MB to 512 KB for standard-rate files. Background prefetch is now throttled by 8 s to avoid competing with playback startup. Combined, these changes reduce idle CPU from ~6–10 % to ~2–3 % on a modern machine.
Hi-Res toggle — stream rate not restored: Toggling Hi-Res off while a track was playing at 88.2 or 96 kHz left the output stream at the high rate for subsequent tracks. The device's default rate is now restored on the next play.
Fullscreen lyrics — CPU spikes on line transitions: Animating font-weight in CSS triggered a full layout reflow on every animation frame. Removed font-weight from the transition list; active-line emphasis now uses transform: scaleX(1.015) (compositor-only). Added contain: layout style to the overlay to isolate reflows from the rest of the page.

i18n

New keys for Hi-Res playback settings and music folder filter added to all 7 languages (EN, DE, FR, NL, ZH, NB, RU).

[1.34.1] - 2026-04-06

Added

Fullscreen Player — Synced Lyrics Overlay: Synced lyrics are now displayed directly in the Fullscreen Player as an animated 5-line rail with a soft fade mask at the top and bottom edges. Click any visible line to seek to that position. Toggle the overlay on/off with the new microphone icon button next to the heart — preference is persisted.

Note: The overlay currently requires synced (timestamped) lyrics. Support for unsynced lyrics in the Fullscreen Player is planned for a future release.
Embedded Lyrics & LRC support: The app now fetches lyrics from two sources using the shared useLyrics hook (used by both the Lyrics Pane and the Fullscreen overlay):
- Server-embedded lyrics via the OpenSubsonic getLyricsBySongId endpoint — reads timestamped or plain lyrics baked directly into the audio file's tags (Navidrome 0.53+).
- LRCLIB — external LRC lookup as fallback (or primary, configurable in Settings → Playback). Both sources share a module-level cache so switching between the Lyrics Pane and the Fullscreen Player never triggers a second network request.
Artist Image Upload: A camera overlay now appears when hovering the artist portrait on the Artist page. Clicking it opens a file picker and uploads the image directly to your server.

Requires EnableArtworkUpload = true in your Navidrome configuration (new option in Navidrome #5110 / #5198 — default: true). The same requirement applies to the existing Radio Station cover upload.
Discord Rich Presence — Album Cover Art: Album artwork is now displayed in Discord's Rich Presence card. Because Subsonic cover URLs require authentication (and can't be accessed by Discord directly), artwork is fetched from the iTunes Search API using a 3-strategy search (exact → relaxed → track-title fallback), cached for 1 hour, and passed as a direct URL to Discord. Falls back to the static Psysonic asset when no match is found.
Nightfox themes (PR #112 by @nisrael): Six themes from the nightfox.nvim palette have been added to the Open Source Classics group — Dawnfox, Dayfox, Nightfox, Nordfox, Carbonfox, and Terafox.
Auto-install script (PR #121 by @kilyabin): install.sh now supports Debian/Ubuntu (.deb) and RHEL/Fedora (.rpm) — automatically detects the distro, downloads the correct package from the latest release, and installs it.

Changed

Fullscreen Player — performance overhaul:
- FsArt (cover art) and FsLyrics are now isolated memo components — unrelated state changes no longer trigger their re-renders.
- Cover crossfade uses an onLoad DOM event instead of new Image() preloading. This avoids a React batching edge case where both state updates were flushed together and the browser never saw the opacity: 0 starting state, preventing the CSS transition from firing.
- useCachedUrl(..., true) passes the raw URL as an immediate fallback — the image starts fetching from the network instantly while IndexedDB resolves the blob in the background.
- Lyrics slot height is stored in a useRef and updated only on resize — eliminates repeated window.innerHeight layout reads on every render.
- Mouse-move handler is throttled to 200 ms.
Artist page — biography: The bio text is now collapsed by default with a Read more / Show less toggle button, keeping the page layout clean for artists with long bios.
Settings — Logout button: Moved from the System tab to the bottom of the Server tab, styled as a danger button (red outline → red fill on hover).

Fixed

Gapless playback — manual skip (PR #119 by @cucadmuh): When the next track had already been gapless-pre-chained into the Sink, a manual skip would not interrupt it — the pre-chained track continued playing at full volume from the old Sink after the fade-out. The chain is now matched by stream identity so user-initiated playback always takes precedence.
Radio / Artist cover cache: invalidateCoverArt is now called after every cover upload and delete, so the old image is evicted from the local cache immediately.
Queue auto-scroll: The active track now scrolls reliably into view; eliminated unnecessary component re-renders caused by unstable selector references.
macOS TLS (PR #114 by @nisrael): Switched reqwest from native-tls (macOS Security framework) to rustls-tls (statically linked). The native backend was returning bad protocol version when connecting to HTTPS music servers, silently preventing playback.

i18n

Russian translation improvements (PR #120 by @kilyabin): Extensive phrasing refinements across the entire Russian locale.
New keys (fsLyricsToggle, embedded lyrics settings) added to all 7 languages (EN, DE, FR, NL, ZH, NB, RU).

[1.34.0] - 2026-04-06

Added

Mobile UI — Early Preview ⚠️ — After multiple requests from the community, an initial mobile layout is shipping in this release. This is a very early work-in-progress — expect rough edges, missing features, and layouts that still need a lot of polish. Feedback is very welcome! Join the Discord to share your thoughts.
- Sidebar and queue panel are hidden on mobile; a sticky Bottom Navigation Bar replaces them with quick access to Mainstage, Albums, Now Playing, and Search.
- Mobile Player View (/now-playing) — Full-screen ambient player with dynamic album-art-based background color, large cover art, track metadata line, and playback controls.
- Mobile Search Overlay — Full-screen search with recent search history, category chips (Albums, Artists, Genres), and grouped results.
- Mobile Album Header — Compact two-row icon button layout (Play + Queue primary, Favorite + Bio + Download + Offline secondary).
- Mobile Tracklist — Simplified track rows; disc headers preserved for multi-disc albums.
- Mobile Hero / Carousel — Blurred-background-only layout with circular Play + Queue buttons.
Russian 2 translation (PR #107 by @kilyabin): A second Russian translation alongside the existing one from @cucadmuh (PR #106). Both are selectable in Settings → Appearance as Russian and Russian 2. Since the maintainer neither speaks nor reads Russian, community feedback is essential here — please vote on the Discord or via GitHub which translation feels more natural so we can retire the weaker one in a future release.
Clickable Mainstage section headers — "Zuletzt hinzugefügt", "Entdecken", "Künstler entdecken", and "Persönliche Favoriten" now navigate to their respective pages on click, with a ChevronRight indicator and accent-color hover effect.

Fixed

macOS network playback (Issue #108): Added com.apple.security.network.client to Entitlements.plist and disabled the app sandbox for unsigned/ad-hoc builds. Without this, macOS silently blocked outbound TCP connections from the Rust audio engine, causing the player to skip through every track without playing anything.
Auto-updater (under observation): Fixed an incorrect signature in the auto-generated latest.json — the CI was writing the public key as the signature value. The updater now receives a correctly signed manifest. Note: Due to OS-level restrictions on macOS (Gatekeeper) and Windows (SmartScreen) for unsigned apps, it is not yet certain whether the in-app updater will reliably work on these platforms. Manual installation from the Releases page remains the safe fallback.

Changed

All new i18n keys added to all 8 languages (EN, DE, FR, NL, ZH, NB, RU, RU2).

[1.33.0] - 2026-04-06

Added

Norwegian (Bokmål) translation (PR #101 by @zz5zz): Psysonic is now fully translated into Norwegian Bokmål — selectable in Settings → Appearance.
Configurable next-track preload (Issue #102): A new setting in Settings → Playback controls when Psysonic starts buffering the next track. Three modes available:
- Balanced (default) — begins buffering 30 s before the end of the current track (previous behaviour).
- Early — begins buffering after just 5 s of playback, maximising reliability on slow connections.
- Custom — set the exact threshold (5 – 120 s before the end) via a slider.
Tray icon visibility toggle: A new toggle in Settings → App Behavior lets you show or hide the system tray icon. When disabled, the icon is fully removed from the notification area / menu bar.

Changed

Fullscreen Player — complete redesign: The Ambient Stage has been rebuilt from the ground up.
- Animated mesh background: A GPU-only animated dark gradient mesh replaces the static blurred cover art background — smooth, performant, no layout repaints.
- Artist portrait: The right half of the screen now shows the artist's image (loaded from the server), crossfading smoothly on every track change. Falls back to the album cover if no artist image is available.
- Bottom seekbar: The seekbar is now pinned to the very bottom edge, spanning the full width, with elapsed and remaining timestamps above it.
- Heart button: You can now star/unstar the currently playing track directly from the Fullscreen Player without leaving the view.
- Removed the marquee-scrolling title in favour of a large, wrapping typographic layout.
Star buttons — all star/favourite buttons across the app (Player Bar, Album Header, Album Tracklist, Queue Panel) now use the CSS class .is-starred instead of inline color overrides, making them trivially themeable.

Fixed

macOS — HTTP audio streams: Added NSAppTransportSecurity / NSAllowsArbitraryLoads to Info.plist. Without this, App Transport Security silently blocked HTTP radio streams and non-HTTPS Navidrome servers from loading audio in WKWebView on macOS.

[1.32.0] - 2026-04-05 — The Big Easter Update 🐣

Added

Custom Offline Storage Directory (#95): You can now specify a custom directory for the offline library in Settings → Storage & Downloads. This is perfect for offloading your internal drive to an SD card or external HDD.
Robust Volume Handling: The app now automatically detects if a configured external storage medium is missing and provides a clear "Volume not found" notification instead of failing silently or attempting to download to a non-existent path.
Internet Radio — full release: The Radio page is now accessible from the sidebar. Complete UI rewrite to a card-based layout (cover art, name, edit/homepage buttons) consistent with the Playlists look. Covers can be uploaded or removed via a hover menu directly on the card.
Internet Radio — Edit Modal: A dedicated modal lets you change station name, stream URL, and homepage URL, and upload or remove cover art.
Internet Radio — Radio Browser directory (via radio-browser.info): Discover new stations directly inside Psysonic. Top stations by vote are shown as suggestions; a debounced search finds stations by name. Favicon images can be imported as cover art in one click.
Settings — Backup & Restore: Export all your settings (servers, theme, font, keybindings, EQ preset, sidebar order) to a single JSON file and import them on another machine or after a reinstall. Available in Settings → Storage.
Albums — Year Range Filter: A From/To year input now appears in the Albums toolbar alongside the existing genre filter. Filtering by year and by genre can be combined; clearing both inputs returns to the default view.
Statistics — Library Insights (requested via #88):
- Total Playtime card: computed in the background by paginating your full album list (up to 5 000 albums). Shows ≥ Xh Ym if the library is larger.
- Genre Insights: Top 10 genres ranked by song count with proportional progress bars.
- Format Distribution: Codec breakdown from a random 500-track sample — shows format name and percentage.
Playlist Detail — Cover Upload: Change or remove a playlist's cover image via the hover menu that appears on the hero artwork — no external tool needed.
Tracklist columns — Playlists & Favorites (work in progress): PlaylistDetail and Favorites now support the same resizable, configurable column system introduced in v1.31.0 for Album tracklists. Column widths and visibility are persisted independently per page. The feature is still being refined.

Changed

Crossfade — fine-grained control: The crossfade duration slider now ranges from 0.1 s to 10 s in 0.1 s steps (previously 1 s minimum, 0.5 s steps). The current value is shown with one decimal place.
Settings — Storage tab redesign: The "Offline Library" section now has a short description and includes Cache settings. The "Downloads" section is now labelled "ZIP Export & Archiving". Both sections have been visually consolidated.
Artists page — Load More button (reported via #90): The button is now styled as btn-primary with a ChevronDown icon and proper spacing. Previously it was an unstyled ghost button with no visual affordance.
Tracklist layout consistency: The Play-button column is now uniformly 60 px and the title column uses minmax(150px, 1fr) across all list views — Search Results, Artist Detail, Random Mix, and Advanced Search now match the Album tracklist layout.
Internet Radio — HTML5 playback: Radio now streams via the browser's native <audio> element instead of a custom Rust pipeline. This improves compatibility with AAC/MP3/HLS streams.
AppUpdater — error visibility (experimental, still in progress): Update failures are now shown inside the update card rather than silently logged. Auto-update remains experimental — a direct GitHub Releases link is always shown as a fallback.
Queue panel — radio drag: Dragging a radio station card onto the queue is now silently rejected instead of causing an error.

Fixed

PlayerBar stuck on Radio info: Switching from an Internet Radio station to a regular track no longer leaves the station name and cover in the player bar. playTrack now clears currentRadio state and stops the audio element immediately.
Radio favourite icon: The heart icon is now correctly used for favourite radio stations on both the Internet Radio page and the Favourites page. It was incorrectly showing a star.
Offline track deletion — orphaned directories: Deleting a cached track now removes empty parent directories up to the configured base directory. Uses std::fs::remove_dir (safe — only removes empty directories) to avoid accidental data loss.

[1.31.0] - 2026-04-04

Note: This is likely the last update for the coming week — taking a short break. See you on the other side. ☀️

Added

AutoEQ — 10-Band Parametric Equalizer: Full parametric EQ with 10 adjustable bands, bypass toggle, and pre-gain control. AutoEQ presets are loaded directly from the AutoEQ GitHub repository — search for your headphone model and apply a community-measured correction curve with one click.
Internet Radio — infrastructure (work in progress, not yet released): The full backend for Internet Radio playback is in place — a dedicated Rust RadioBuffer streaming pipeline in the audio engine, Subsonic API integration (getInternetRadioStations, create/update/delete), and a playRadio action in the player store. The UI page exists but the feature is not yet accessible from the sidebar — it will be enabled once the experience is polished.
Tracklist columns — resizable & configurable (experimental): Album tracklist columns can now be resized by dragging the dividers between header cells, similar to a spreadsheet. A column visibility picker (chevron button at the top right) lets you show or hide individual columns. The # column is fixed-width. Column widths and visibility are persisted in localStorage. The feature works but is still being refined.
Genre column in album tracklist: Albums that have genre tags per track now show a Genre column in the tracklist.
Sidebar auto-migration: New sidebar items (e.g. Internet Radio) are automatically appended to existing persisted sidebar configurations on first launch — no more missing entries after updates.

Changed

Discord Rich Presence: Activity type is now Listening instead of the default Playing. The artist field no longer has the "by " prefix — Discord's layout makes the context clear without it. Album name is shown as a tooltip on the cover icon.
Clickable artist names everywhere: Artist names in Album Cards, Favorites, Random Mix, Playlist Detail, and Artist Detail tracklists are now clickable links that navigate to the artist page.
Duration format supports hours: Tracks and albums longer than 60 minutes are now displayed as H:MM:SS instead of overflowing minutes (e.g. 75:03 → 1:15:03).
Format column: Codec label no longer includes the "kbps" suffix or the · separator — cleaner and fits the narrower column better (e.g. FLAC 1411 instead of FLAC · 1411 kbps).
Now Playing sidebar link: No longer permanently styled as an active menu item. It now only shows the accent background when you are actually on the Now Playing page; at all other times it is distinguished only by its accent text colour.
Paused-state indicator in tracklist: When the currently active track is paused, a dimmed play icon is shown in the # column instead of a blank space — making it clear which track is loaded even when playback is stopped.
Text selection disabled: Text can no longer be accidentally selected anywhere in the player by click-dragging or pressing Ctrl+A. Standard input fields are unaffected.
Settings — button styles: "Test connection", "Add server", and "Pick download folder" buttons are now btn-surface (with a subtle border) instead of the borderless btn-ghost — clearer affordance.
Settings — Behavior section icon: Replaced the generic Sliders icon with AppWindow for the Behavior section header.
btn-surface border: The surface button variant now has a 1 px border that brightens on hover — consistent with the card and input visual language.
Queue panel minimum width: Increased from 250 px to 310 px to prevent layout overflow when the codec/bitrate overlay is visible.
Server compatibility hint: A short note below the Servers section header in Settings clarifies which Subsonic-compatible servers are supported.

Fixed

Tracklist # column header alignment: The "Select all" checkbox and the # symbol in the header now use the same internal layout as the row cells — ensuring alignment with individual checkboxes and track numbers at all window sizes.
Column resize dividers: The visible 2 px divider line is now placed in the gap between columns rather than inside the cell, so header labels appear visually centred between their dividers.
Internet Radio sidebar link hidden: The navigation entry is temporarily removed until the feature is ready for release. The underlying code remains in place and will be re-enabled without any migration required.

[1.30.0] - 2026-04-03

Added

Bulk offline download — Playlists & Artist discographies (requested by @Apollosport, #54): Download an entire playlist or a full artist discography for offline use in one click. Progress is tracked per album on the Artist page ("Caching… 2/5 albums").
Offline Library filter tabs: The Offline Library now has four filter tabs — All, Albums, Playlists, and Discographies. The Discographies tab groups albums under their respective artist with section headings.
Discord Rich Presence (requested by @Bewenben, #49) (opt-in): Psysonic can now update your Discord status with the currently playing track, artist, and a live elapsed timer. Toggle in Settings → General → "Discord Rich Presence".
Artist images on Artists page (reported by @Apollosport, #53) (opt-in): Artist avatars on the Artists overview can now show the actual artist image from the server instead of the coloured initial. Toggle in Settings → General → "Show artist images". Off by default to preserve performance on large libraries.
Image lazy loading: Cover art and artist images across all pages now load lazily via IntersectionObserver (300 px pre-fetch margin), significantly reducing initial page render time on large libraries.

Fixed

Crossfade triggers on manual track skip (reported by @netherguy4, #35): Manually clicking Next/Prev or selecting a track from the queue no longer triggers the crossfade transition. Crossfade now only fires on natural track end.
Playlist offline cache showing individual album cards: Caching a playlist offline previously created one card per album group in the Offline Library. The playlist is now stored as a single cohesive entry.
Image cache abort handling: Aborted image fetches no longer prevented the cached result from being written to IndexedDB, causing covers to reload on every page visit.

Changed

Queue tech strip: Removed genre from the codec/bitrate overlay strip in the Queue panel — genre strings frequently caused layout overflow.
"Save discography offline" label: The Artist page offline button now reads "Save discography offline" instead of "Download discography" to avoid confusion with a ZIP export.
Update toast (Win/Mac): The update notification now includes a disclaimer that auto-update is still in development, and always shows a direct GitHub Releases download link alongside the install button as a fallback.
Facebook theme overhaul: Improved grey text contrast, opaque album chip and back button, readable Queue/Lyrics tab labels.

[1.29.0] - 2026-04-02

Added

Radio: instant start + background enrichment (requested by @netherguy4): Artist Radio now starts immediately from fast local getTopSongs results. getSimilarSongs2 (Last.fm-dependent, slow) continues in the background and silently enriches the queue once it resolves — no waiting before the first song.
OGG/Vorbis playback (contributed by @JulianNymark, PR #42): Added symphonia-format-ogg — .ogg files now play natively without server-side transcoding.
Click-to-seek in synced lyrics (contributed by @nisarg-78, PR #38): Clicking any line in the synced lyrics pane seeks directly to that timestamp.
Volume scroll wheel (contributed by @nisarg-78, PR #38): Scrolling the mouse wheel over the volume slider adjusts volume in ±5 % steps.
Lyrics visual states (contributed by @nisarg-78, PR #38): Synced lyrics lines now show three distinct visual states — active (highlighted), completed (muted), upcoming (neutral).
Themed audio error toasts (contributed by @JulianNymark, PR #43 / PR #44): Unsupported formats and decode failures are now surfaced as themed in-app toast notifications with human-readable messages instead of silent failures.

Fixed

Auto-updater endless loop on macOS / Windows: The single-instance plugin was killing the relaunching process before it could start. Hopefully fixed by exiting the old process first (releasing the lock) and spawning the new process via a shell-based delayed restart.
Radio queue stacking: Clicking "Start Radio" multiple times no longer appends unlimited duplicate batches — each click replaces the pending Radio section cleanly.
Start Radio keeps current song playing: Triggering Radio while a song is playing no longer stops and restarts the current track.
Radio proactive loading with songs missing artistId: getSimilarSongs2 results frequently lack artistId. A currentRadioArtistId module variable now persists the original artist ID as fallback, so proactive loading always fires correctly.
Seek audio glitch after lyrics click: Any seek ≥ 100 ms into a track no longer causes a brief fade-from-zero. EqualPowerFadeIn now only resets to zero-gain for seeks to the track start.

Changed

Infinite Queue: 5 tracks at a time (was 25): Proactive loading fetches 5 tracks when ≤ 2 remain, keeping the queue lean without interruption.
Queue section order is now explicit: Manual tracks → Radio (with — Radio — separator) → Infinite Queue auto-added tracks (with — Auto — separator). Manually enqueued songs always appear before auto-managed sections.

Contributors

Thanks to @nisarg-78 and @JulianNymark for their first contributions in this release. Special thanks to @netherguy4 for continued feature ideas and feedback.

[1.28.0] - 2026-04-02

Added

Infinite Queue (requested by @netherguy4): When the queue runs out with Repeat off, Psysonic automatically appends 25 random tracks (optionally filtered by the last-played track's genre) so playback never stops. Toggle in Settings → Audio → "Infinite Queue". Auto-added tracks appear below a divider in the Queue panel.
Start Radio plays immediately (requested by @netherguy4): "Start Radio" from the song/queue context menu now starts the seed track instantly while similar and top tracks load in the background — no waiting for the fetch to complete before music plays.

Fixed

Single-click to play everywhere (reported by @netherguy4): Song rows in Album Detail, Playlist Detail, Artist Detail (Top Tracks), Favorites, and Random Mix previously required a double-click. All rows now play on a single click. The track-number cell and the full row are both click targets; buttons and links inside the row still work independently.
Artist page Play All / Shuffle used Top Tracks only (reported by @smirnoffjr): "Play All" and "Shuffle" on the Artist detail page only sent the loaded top songs to the queue, not the full discography. Now fetches all albums in parallel and plays songs in chronological album order with correct track-number ordering within each album. Buttons show a spinner while albums are loading.
Last.fm icon clipped in player bar: The Last.fm logo button in the player bar was cut off on the right side. Fixed by correcting the SVG viewBox from 0 0 24 24 to 0 0 26 22 to match the actual path extents.
Playlist empty state UX (reported by @netherguy4): Empty playlists (on creation, or after deleting all tracks) now show an "Add your first song" CTA button that opens the search panel directly, rather than a plain text message with no action.
Playlist search rows required "+" button click (reported by @netherguy4): Search result rows in the song search panel now add the song on a full-row click — the separate "+" button was redundant and easy to miss.
Large playlist performance: Playlists with hundreds of songs would freeze during mouse movement. Root cause: hoveredSongId state triggered a full React re-render of every row on every mouseenter/mouseleave event. Fixed by removing the JS hover state and replacing it with a CSS .track-row:hover .bulk-check rule. Also memoized songs.map(songToTrack) and the existingIds set to avoid recomputation per render. Same fix applied to AlbumTrackList.

[1.27.4] - 2026-04-02

Added

In-App Auto-Update (requested by @netherguy4): Psysonic now checks for new releases automatically on startup (3 s delay). On macOS and Windows a native install-and-relaunch flow is available directly in the app — no browser needed. On Linux, a download link to the GitHub release page is shown instead (AppImage is not built due to WebKitGTK incompatibility with Arch/Fedora). The updater uses Tauri's signed updater plugin with minisign signatures verified against a bundled public key.
Configurable Home Page: Users can now choose which sections appear on the home page. A new "Home Page" block in Settings → Library lets you toggle each section individually (Featured, Recently Added, Discover, Discover Artists, Recently Played, Personal Favorites, Most Played) with a reset-to-default button. Hidden sections are skipped entirely.
Consistent icon language (requested by @netherguy4): Favorites (local star/heart) now use a filled Heart icon everywhere — Player Bar, Album Detail, Artist Detail, Tracklist, Context Menu. Last.fm love always uses the Last.fm logo. Previously the two were mixed up in several places.

Fixed

Radio broken from context menu (reported by @netherguy4): "Start Radio" in the track and queue-item context menus had no effect. The handler was passing the artist name as the artist ID to getSimilarSongs2, which returned an empty result — so no tracks were queued and no error was shown. Now correctly passes song.artistId.
Album Detail hero background not loading: The blurred album art background in Album Detail only appeared after a track change, never on first visit. Root cause: buildCoverArtUrl was called without useMemo, generating a new salt on every re-render — causing useCachedUrl to cancel and restart its fetch endlessly. Fixed by memoising both the URL and cache key on album.coverArt. Same fix applied to Hero and Playlist Detail backgrounds.
CI: auto-update signing pipeline: Signing keys were not being passed correctly during the build, and macOS .sig files were uploaded with a generic name the manifest generator couldn't match. Fixed the post-build signing step to upload arch-specific names (Psysonic_aarch64.app.tar.gz.sig, Psysonic_x64.app.tar.gz.sig). First release where the in-app updater is fully functional on macOS and Windows.
CI: Windows NSIS upload: The release workflow was not correctly uploading Windows artifacts. Resolved by letting tauri-action handle NSIS bundle detection and upload directly — it only searches for what was actually built, so there is no MSI conflict with --bundles nsis builds.
CI: npm + Cargo caching (contributed by @netherguy4): Added actions/cache for npm and Swatinem/rust-cache for Cargo across all build jobs. Warm-cache builds will be significantly faster on subsequent releases.
Linux/AUR build: ring linker error: Builds on Arch/CachyOS failed with rust-lld: undefined symbol: ring_core_* after the Tauri updater was added. Arch's rust package bakes -fuse-ld=lld into the default rustflags; ring's C/asm objects are incompatible with lld. Fixed via .cargo/config.toml — forces cc as linker driver with -fuse-ld=bfd to override the hardcoded lld flag. Added clang to the AUR makedepends (required by ring's bindgen step).

[1.26.1] - 2026-04-01

Fixed

Background flickering in Hero, Album Detail and Playlist Detail: Blurred hero backgrounds were flickering for up to 20 seconds on first visit. Root cause: useCachedUrl with the default fallbackToFetch = true immediately returned the raw server URL, causing the background to render twice — once with the HTTP URL (triggering a server fetch) and again when the IndexedDB blob was ready. Fixed by passing fallbackToFetch = false in all three locations so the background only renders once the blob is cached.

[1.26.0] - 2026-04-01

Added

Favorite button in Player Bar (requested by @halfkey): A star icon button now sits next to the Last.fm heart in the player bar. Clicking it toggles the favorite/unfavorite state for the currently playing track with an optimistic UI update — no page reload needed. Uses the same starredOverrides mechanism as the album tracklist for instant feedback.
Bulk Select for song lists: Multi-select support in Album tracklist and Playlist detail. A checkbox fades in to the left of the track number on hover. Selecting one or more tracks activates the bulk action bar at the top with two actions: Add to Playlist (opens the playlist picker submenu) and Remove from Playlist (Playlist detail only). Shift-click selects a range; the header checkbox selects / deselects all. CSS uses color-mix for the selection highlight, compatible with all 60 themes.
Song Info modal: Right-clicking any song and choosing "Song Info" opens a metadata panel fetched live via getSong. Displays: title, artist, album, album artist, year, genre, duration, track number; format, bitrate, sample rate, bit depth, channels (Mono / Stereo), file size; file path; and Replay Gain values (track / album gain + peak) when present. Closes with Escape or a click on the backdrop.
Recently Played section on Home page: A new "Recently Played" album row appears on the Home page between the hero carousel and the Discover section, powered by the getAlbumList('recent') endpoint.
"Now Playing" visibility toggle in Settings: New opt-in toggle in Settings → Behavior ("Show activity in Now Playing"). When disabled (default), reportNowPlaying is not called, so no activity is reported to the Navidrome "Now Playing" feed. Useful for users who share a server.

Fixed

Queue cover art not updating: After a track change the queue panel cover art often stayed on the previous album or took a long time to update. Root cause: useCachedUrl and CachedImage were not resetting their resolved URL when the cacheKey changed. Fixed by resetting resolved to '' before each async cache fetch and basing CachedImage's loaded state on useEffect([cacheKey]) instead of a render-time comparison.
Fullscreen Player background flickering: The blurred background briefly showed a blank frame when switching tracks because the new image div was added to the DOM before the blob URL was ready. Fixed in FsBg by preloading the image via new Image() before inserting the layer, and using useCachedUrl(..., false) for the crossfade background so the raw URL is never used as a fallback during transitions.
Playlist card delete confirmation not visible: The confirm state only changed the icon colour, which was barely noticeable over the red button. Replaced with a size expansion (24 px → 30 px), an inset white ring, and a pulsing delete-confirm-pulse animation that alternates between two shades of red.
Gruvbox Light Soft — back button and badge: The album detail back-arrow and album badge were invisible against the warm light background. Added explicit colour overrides for .album-detail-back and .album-detail-badge in the gruvbox-light-soft theme.

Changed

buildStreamUrl signature: Removed the unused suffix parameter. Opus transcoding (format=flac) is now handled in playerStore.playTrack via track.suffix check, keeping the URL builder stateless.

[1.25.1] - 2026-04-01

Fixed

Single-instance enforcement (reported by @netherguy4): Re-launching the app while it was already running (including minimized to tray) would spawn a new independent process, leading to playback conflicts and state divergence. Integrated tauri-plugin-single-instance — subsequent launches are intercepted, the existing window is shown, unminimized, and focused instead.

[1.25.0] - 2026-04-01

Added

System Tray (requested by @jackbot and @thecyanide): Functional tray icon with context menu — Play / Pause, Previous Track, Next Track, Show / Hide, and Exit Psysonic. Left-clicking the tray icon toggles window visibility. The tray icon is built via TrayIconBuilder in Rust so menu events are properly wired.
Minimize to Tray (requested by @jackbot and @thecyanide): New toggle in Settings → Behavior. When enabled, closing the window hides it to the tray instead of exiting. The close button behaviour is intercepted in Rust (prevent_close + window:close-requested event) and the JS side decides hide vs. exit based on the user setting.
Sidebar Customization (requested by @lighthous3d): New section in Settings → Appearance. All library and system nav items can be shown/hidden via a toggle switch and reordered by dragging the grip handle. Order and visibility are persisted across sessions (psysonic_sidebar in localStorage). Fixed items (Now Playing, Settings) are listed as non-configurable below the list.
Playlist cover art: Playlist cards on the Playlists overview page now display the server-generated cover image (Navidrome's coverArt field on the playlist object) via the IndexedDB image cache. Falls back to the ListMusic icon when no cover is available.

Fixed

Cover image flickering: buildCoverArtUrl() generates a new random auth salt on every call, causing useCachedUrl to re-trigger on every render and produce a rapid re-fetch loop. Fixed by wrapping all buildCoverArtUrl / coverArtCacheKey calls in useMemo with the cover ID as dependency in ArtistCardLocal, QueuePanel, FullscreenPlayer, Hero, and PlaylistDetail.
DnD text selection: Dragging a grip handle in the Sidebar Customizer (and any future useDragSource consumer) would select all text on the page during the threshold detection phase. Fixed by calling e.preventDefault() in useDragSource's onMouseDown handler before the drag threshold is reached.
Sidebar Customization DnD on Linux: The initial implementation used the HTML5 Drag & Drop API, which always shows a forbidden cursor on WebKitGTK and does not fire drop events reliably. Rewritten to use the existing psy-drag mouse-event system (useDragSource / psy-drop custom event), consistent with the Queue panel.

[1.24.0] - 2026-03-31

Added

Playlist Management (requested by @adirav02): Full playlist management feature:
- Playlists overview page (/playlists): card grid showing all server playlists with cover collage, song count and duration. Inline "New Playlist" creation (Enter to confirm, Escape to cancel). Two-click delete confirmation directly on the card.
- Playlist detail page (/playlists/:id): hero area with 2×2 album cover collage and blurred background (matching Album Detail style), full tracklist with drag-and-drop reordering, star ratings, codec labels, per-row delete button, and context menu.
- Song search: "Add Songs" button opens an inline search panel with debounced server search, thumbnail, artist · album info, and a round add button (accent on hover). Duplicate songs already in the playlist are filtered from results.
- Suggestions: "Suggested Songs" section below the tracklist loads similar songs via getSimilarSongs2 based on the first artist in the playlist. Refresh button to load a new batch. Same tracklist layout as search results.
- Context menu — Add to Playlist: "Add to Playlist" submenu available on all song/album/queue-item context menus. Playlists sorted by most recently used. "New Playlist" inline create at the top of the submenu. Submenu flips left when near the right viewport edge.
- Sidebar: Playlists navigation entry added between Favorites and Statistics.
- Recently used playlist tracking: playlistStore (persisted) tracks the last 50 used playlist IDs for the context menu sort order.

Fixed

Resampling — first track played at native sample rate (reported by @sorensiimSalling): current_sample_rate was initialized to 44100, causing every track to be resampled down to 44.1 kHz on playback start. Initializing to 0 disables resampling until the actual track rate is known.
Resampling — no application-level resampling for any track: target_rate in audio_play and audio_chain_next is now always 0. Previously, tracks after the first were resampled to match the first track's sample rate. Rodio handles conversion to the output device rate internally; every track now plays at its native sample rate.
Playlist hero background flickering: The blurred hero background in Playlist Detail flickered on every render because buildCoverArtUrl() generates a new random salt on every call, causing useCachedUrl to re-trigger in a loop. The fetch URL and cache key are now useMemo-stabilised.
Input focus double border: The playlist name and song search inputs used a search-input class that had no CSS definition, falling back to browser defaults. The global :focus-visible rule then added a second outline on top of the browser's own focus ring. Switched to the .input class which sets outline: none and uses border-color + glow on focus.

Changed

Playlist search panel: Redesigned with surface-2 background, radius-lg, slide-down open animation, 36 px thumbnails, artist · album subtitle line, and a round icon add-button (accent colour on hover) replacing the generic btn-surface button.

[1.23.0] - 2026-03-30

Added

Advanced Search: New dedicated page (/search/advanced) reachable via the filter icon in the search bar. Supports free-text search combined with genre filter (dropdown from server), year range (from/to), and result-type toggle (All / Artists / Albums / Songs). Search logic: text query uses search3 with client-side genre/year filtering; genre-only uses getAlbumsByGenre + random songs from that genre; year-only uses getAlbumList(byYear). Results show in the standard ArtistRow / AlbumRow / tracklist layout with drag-to-queue and context menu support.
Genre Mix — Server-native genres: The Genre Mix panel in Random Mix now shows the top 20 genres from the server sorted by song count, instead of hardcoded keyword-based "Super Genre" groups. Only genres with at least one song and no audiobook keywords are shown. Clicking a badge fetches up to 50 random songs from exactly that genre.
Genre Mix — Shuffle button: A ↺ button appears when the server has more than 20 genres. Clicking it picks a fresh random selection of 20 from all available genres, replacing the current badges without triggering a search.
Favorites — Play All: "Play All" button (primary style) added next to "Add all to queue" in the Favorites → Songs section. Starts playback immediately from the first favorited song.
Playlist Load — Append mode: The playlist load modal now has two action buttons per playlist: ▶ replaces the queue and starts playback (previous behavior), ≡+ appends all tracks to the existing queue without interrupting playback.

Fixed

Replay Gain (contributed by @trbn1): Replay Gain metadata (track gain, album gain, peaks) is now correctly propagated to the audio engine across all track-construction sites via the new songToTrack() helper. Previously tracks built inline missed the replayGain field, causing the engine to apply 0 dB gain regardless of tags.

Changed

Genre Mix description: Panel subtitle updated to explain that badges represent the top 20 genres by song count and that clicking loads a random mix from that genre.
Random Mix — Filter panel: Added a short descriptive hint below the "Filters" heading explaining that genre tags and artist names in the tracklist are clickable to add them to the blacklist.
Playlist Load modal: Width increased from 400 px to 560 px (90 vw cap) so long playlist names are readable without truncation.
Settings — Contributors: Contributors section is now a collapsible table. Each entry shows the contributor's GitHub avatar, @username (linked to their profile), a version badge, and a bullet list of their specific contributions. @trbn1 added for Replay Gain fix (PR #9).

Theme Fixes

Powerslave: Album card play button no longer flickers between gradient and flat accent color on hover — explicit :hover gradient override added. Sidebar stripe pattern replaced with soft radial-gradient cloud wisps.

[1.22.0] - 2026-03-30

Added

Queue — Active Playlist Tracking (Beta) ⚠️: The queue now remembers which playlist was last loaded or saved. The playlist name appears as a subtitle below the queue title. The save button smart-saves: if an active playlist is set, it updates that playlist directly without opening a modal. If no playlist is active, the save modal opens as before.
Queue — Themed Delete Confirmation (Beta) ⚠️: Deleting a playlist now shows a styled in-app confirmation dialog matching the current theme, replacing the unstyled native browser confirm() dialog.
Queue — Load Modal Live Filter (Beta) ⚠️: The playlist load modal now has a live filter input at the top — typing narrows the playlist list in real time.
Drag & Drop — Precise Insertion (Beta) ⚠️: Songs and albums dragged into the queue can now be dropped at any position between existing items. A blue insertion line shows exactly where the track will land. Previously all drops appended to the end of the queue.
Drag & Drop — Slim Ghost (Beta) ⚠️: The drag ghost is now a compact single-line chip (cover thumbnail + title) instead of the full album card or track row. Consistent for both song and album drags.

Fixed

Seek flash after debounce (contributed by @nullobject): After a seek the waveform briefly flashed back to the pre-seek position when the Rust audio:progress event arrived before the seek completed. A seekTarget guard now blocks stale progress ticks until the engine catches up.
Waveform seekbar jitter (contributed by @nullobject): The seekbar width changed on every progress tick because player time updates caused the waveform canvas container to reflow. The canvas now has an explicit stable width so time label changes no longer affect its layout.
Drag & Drop — text selection and grid auto-scroll during drag: Dragging album cards or track rows caused the browser to begin a text selection and auto-scroll grid rows horizontally. All drag onMouseDown handlers now call preventDefault() and the DragDropContext uses { passive: false } to suppress selection during mouse moves.
Drag & Drop — forbidden cursor on KDE Plasma: Replaced the HTML5 dragstart/dragend system with a pure mouse-event DnD pipeline (DragDropContext). The WebKitGTK forbidden-cursor artefact on KDE Plasma no longer appears during drags.

Changed

Settings — Contributors: @nullobject added for seek & waveform fixes.

Theme Fixes

Powerslave: Connection indicators (Last.fm / Server name) dimmed to match sidebar tone. Back button in album details now white on dark overlay. Tech strip (codec/bitrate) in queue uses dark Nile-blue background instead of sandstone. Artist name in album hero changed to Nile-blue #050E19.
North Park: Back button in album details now visible (was dark brown on dark overlay).
Dark Side of the Moon: Album detail year/genre/info brightened from #555555 to #888888. Connection indicators brightened for legibility on near-black sidebar.

[1.21.0] - 2026-03-29

Added

What's New modal: On first launch after an update, a changelog popup appears showing the current version's release notes. Can be permanently dismissed via checkbox, or re-enabled in Settings → About.
New theme category — Famous Albums: A dedicated group for album-art-inspired themes.
Theme — Dark Side of the Moon (inspired) (Famous Albums) ⚠️ Beta: Void-black everywhere, the iconic prism spectrum rainbow as a 2 px top border on the player bar, spectrum-violet accent #9B30FF, white track name (the input light beam).
Theme — Powerslave (inspired) (Famous Albums) ⚠️ Beta: Sun-bleached sandstone main area, deep Nile-sky blue sidebar and player bar, pharaoh gold accent #C8960C. Blue–gold duality mirrors the album artwork's vivid azure sky against the Egyptian temple gold.
Theme — North Park (Series) ⚠️ Beta: South Park-inspired. Construction-paper cream main area, Colorado mountain-blue #1B3D6E sidebar, Kenny orange #FF8C00 accent, flat no-gradient buttons.

Changed

AlbumTrackList — artist column always visible: The artist column is now shown on all albums, not only Various Artists compilations. Useful for albums with guest artists or featuring credits where track-level artist differs from the album artist.
Tracklist column widths — more flexible: Title and artist columns now use minmax fr units (1.5fr / 1fr) instead of fixed sizes, so the artist column moves naturally closer to the title on wide viewports and never clips on narrow ones.

Fixed

Settings — changelog toggle alignment: The "Show What's New on update" toggle was rendering below its label instead of beside it.

[1.20.0] - 2026-03-29

Added

Chinese language (zh): Full UI translation contributed by @jiezhuo. Language can be selected in Settings → General.
Genres page (requested by @grillonbleu): New page (sidebar: Tags icon) showing all server genres as coloured cards — icon watermark, genre name, album count. Cards are sorted by album count descending and deterministically colour-coded from the Catppuccin palette. Clicking a card opens the album list for that genre. Navigating back restores the previous scroll position.
Genre filter on Albums, New Releases, Random Albums (requested by @grillonbleu): A multi-select genre combobox in the page header lets you filter any of these views to one or more genres. Chips show selected genres; backspace removes the last one; clicking outside collapses the filter automatically when nothing is selected. In filter mode, results are fetched in parallel across all selected genres and deduped client-side.
Settings — Contributors: A new "Contributors" row in the About section credits community translators.

Changed

Theme — W10 (Operating Systems): New Windows 10 Fluent Design light theme. Clean white content area, flat light-grey #F3F3F3 navigation pane, near-black #1C1C1C taskbar player bar with a Windows-blue #0078D4 accent stripe, flat buttons without gradients (4 px radius). Sharp, unmistakably W10 — distinct from the glass-era W7/Vista and the rounded-corner W11.
ThemePicker — Windows themes sorted by release year: W3.1 → W98 → WXP → Wista → W7 → W10 → W11.
Playlists page — removed: The dedicated Playlists page has been removed. Playlists remain fully accessible via the Queue panel (Save / Load buttons in the toolbar).

Fixed

FLAC seeking (Rust audio engine): rodio's internal ReadSeekSource hardcodes byte_len() → None, which caused the symphonia FLAC demuxer to reject all seek attempts (it validates seek byte offsets against the total stream length). Replaced rodio::Decoder with a direct symphonia pipeline (SizedDecoder) that wraps the audio bytes in a SizedCursorSource providing the correct byte_len(). FLAC seeking now works regardless of whether the file has an embedded SEEKTABLE.
Genre missing in Queue meta box when playing from album card: playAlbum() (used by the play button on all album cards) mapped song-level genre only — which Navidrome does not always return per song. Now falls back to the album-level genre from getAlbum. Same fallback applied to all three play/enqueue handlers in AlbumDetail.
Logo gradient CSS variables: Sidebar logo gradient now uses --logo-color-start / --logo-color-end with fallbacks, allowing themes with dark sidebars to override the gradient colours.

[1.19.0] - 2026-03-27

Added

Offline storage full warning: When caching an album would exceed the configured storage limit, a dismissible warning banner appears directly on the album page with quick links to the Offline Library and Settings.
Offline Mode — Help section: New section in the Help page covering cache setup, playback, and troubleshooting for offline use.

Changed

Windows installer — NSIS: Switched from WiX/MSI to NSIS (currentUser install mode). Upgrades install in-place without requiring an uninstall first.
Tray icon — removed: The system tray icon and its menu have been removed. Media keys and OS media controls (added in v1.17.0) make the tray redundant. The "Minimize to tray" setting has been removed accordingly. The app now always exits cleanly on window close.
Settings — cache label: "Max. Image Cache Size" renamed to "Max. Storage Size" to reflect that the limit now covers both image cache and offline tracks.
Cover art — fade-in on load: CachedImage now fades album art in (150 ms) instead of popping in abruptly. The image starts transparent and becomes visible once fully loaded, preventing layout flicker on slow connections.
Scrollbar auto-hide: Scrollbar thumbs are hidden when content is not being scrolled and fade in on hover or while actively scrolling. System-style themes (W98, Muma Jukebox, Luna Teal, W3.1, DOS) retain always-visible scrollbars.
Help page — two-column layout: Sections now flow in CSS columns (masonry layout) instead of a rigid two-column grid, making better use of available space.
Theme picker — preview corrections: Updated colour swatches for T-800 (red accent, was cyan), WnAmp (yellow accent, was green), TetraStack (darker navy background), NightCity 2077 (darker blue-tinted background).
Theme overhaul — Grand Theft Audio, NightCity 2077: Detailed per-element styling added — active queue item, hover states, track rows, artist/playlist rows, settings tabs, connection indicators, and more. Both themes are now fully consistent across all UI sections.
Theme refinements — Lambda 17, T-800, TetraStack, Muma Jukebox: Targeted fixes for connection indicators, hover colours, active states, and contrast throughout.

Fixed

AlbumDetail — hero background flicker on hover: Moving the mouse over songs in the track list caused the blurred hero background to reload on every hover. Moving hoveredSongId state into AlbumTrackList prevents the parent from re-rendering.
AlbumDetail — context menu loses row highlight: Right-clicking a song caused the hover highlight to disappear. The row now stays highlighted while its context menu is open (.context-active pattern — consistent with Queue and Random Mix).
Muma Jukebox — hero readability: The "Album" chip and meta info text below the artist name had insufficient contrast. Both are now legible.
Muma Jukebox — waveform colours: Waveform now uses orange (played) and cyan (buffered) to match the theme's colour scheme.

[1.18.0] - 2026-03-27

Added

Offline Mode (Beta — tested on CachyOS only): Albums can now be cached for offline playback via the new "Cache Offline" button in the album header. Cached albums are accessible in the new Offline Library page. On launch without internet, the app automatically navigates there if cached content is available — no blocking overlay. A slim non-blocking banner shows while in offline mode. Offline tracks are removed when clearing the cache.
Settings — Cache section improvements: Live usage display (image cache + offline tracks). Adjustable limit now goes up to 5 GB. When the limit is reached, the oldest image cache entries are evicted automatically (offline albums are not auto-removed). "Clear Cache" button with confirmation removes both image cache and all offline albums.
MPRIS — Seek support: The Plasma (and other MPRIS2-compatible) seekbar now works correctly. Seek and SetPosition events from the OS are forwarded to the audio engine. Position is synced every 500 ms while playing so the OS overlay stays accurate.
Lyrics caching: Fetched lyrics are cached in memory for the session. Switching between Queue and Lyrics tabs no longer re-fetches from lrclib.net.
2 New Themes (Movies):
- Barb & Ken — Barbie dreamhouse universe. Deep magenta dark, polka-dot sidebar, glitter shimmer animation on track name, Ken powder blue for artist name and volume slider.
- Toy Tale — Toy Story. Dark warm toy-chest brown main, Andy's iconic cloud-wallpaper sky-blue sidebar, Woody sheriff-star gold track name, Buzz Lightyear purple for active queue item and volume slider.

Changed

Hero carousel — background crossfade: The blurred background no longer flickers when switching albums. The last resolved URL is held until the new one is ready, so the old background stays visible until the new one loads.
AlbumDetail — Download hint: Removed the inline hint text from the album header. The explanation (server zips first — may take a moment) is now in the Help FAQ.

Fixed

Performance — Home page scroll: AlbumCard subscribed to two large Zustand record objects (tracks, albums) per card — 96+ selector calls across a typical home page. Replaced with a single boolean selector per card. Added React.memo to prevent re-renders when parent rows reload.
Middle Earth theme — active queue item contrast: Track title was invisible (dark text on dark background). Fixed to bright gold. Tech info bar text also corrected.

[1.17.2] - 2026-03-26

Fixed

Player bar disappears when window is resized small: On Linux (and some Windows configurations), the window manager ignores the minHeight constraint, allowing the window to be dragged smaller than intended. The CSS grid's 1fr row has an implicit min-height: auto, meaning it refuses to shrink below the min-content height of the sidebar/main/queue children — this pushed the total grid height beyond 100vh and scrolled the player bar out of view. Fixed by adding min-height: 0 to .sidebar, .main-content, and .queue-panel, and overflow: hidden to .app-shell as a safety net.
Media keys on Windows (SMTC): souvlaki's Windows backend requires a valid Win32 HWND to hook into the existing message loop rather than spinning up its own. Passing hwnd: None caused a crash on startup (v1.17.0). Now retrieves the main window's HWND via app.get_webview_window("main").hwnd() and passes it to PlatformConfig. Falls back to disabled gracefully if the HWND cannot be obtained.

[1.17.1] - 2026-03-25

Fixed

Windows crash on startup: souvlaki SMTC init in setup() requires a valid HWND and a running COM message loop, neither of which exists at that point. Media controls are disabled on Windows until init can be properly deferred post-window. All other functionality unaffected.

[1.17.0] - 2026-03-25

Added

Media Keys & OS Media Controls (experimental): Initial integration via souvlaki — MPRIS2 on Linux, Now Playing on macOS, SMTC on Windows. Track metadata (title, artist, album, cover art) and playback state are pushed to the OS media overlay in real time. On Linux, init is skipped gracefully if no D-Bus session is present. This feature is still under active development and observation — behaviour may vary across desktop environments and OS versions.
Random Mix — Artist Blacklist: Artist names are now included in the keyword blacklist filter. Clickable artist chips in the tracklist let you add an artist to the blacklist with one click — same UX as the existing genre chips.
Favorites — Remove Song: Each song row in Favorites now has an inline X button to remove the track from favorites instantly (optimistic UI, server unstar happens in the background).
3 New Themes:
- Games: Horde — Durotar blood-red earth, iron-plate sidebar, forge-fire gold glow on track name.
- Games: Alliance — Stormwind deep navy, cathedral stone columns, paladin holy-light glow, gold sidebar trim and nav accent.
- Operating Systems: W11 — Windows 11 Fluent Design dark mode. Mica-style sidebar, clean neutral palette, taskbar-inspired player bar. No gradients — faithful to the minimal Fluent aesthetic.

Changed

Theme renames: Cobalt Media → WinMedPlayer, Onyx Cinema → P-DVD, Navy Jukebox → MuMa Jukebox.
NowPlayingDropdown: Username / player name row now uses --text-secondary for improved readability across all themes.

Fixed

Performance — App-wide interaction lag: Removed [data-theme='X'] * { font-family: ... !important } universal selectors from several themes (DOS, Unix, and others). The browser places universal selectors in the "universal bucket" and checks them against every DOM node on every style recalculation — measurably sluggish with 500–1000+ elements even when the affected theme is not active. font-family is now set on the theme root block (inherits to children) with a targeted button, input, textarea, select override for elements that don't inherit font.
Performance — Scroll jank: Removed repeating-linear-gradient / repeating-radial-gradient from .app-shell in DOS, Unix, GW1, Morpheus, Aqua Quartz, and others. WebKitGTK with WEBKIT_DISABLE_COMPOSITING_MODE=1 (always set by the AUR wrapper) has no GPU compositing — fine-pitch repeating patterns on the full-viewport background re-rasterize every scroll frame. Patterns are now applied only to .sidebar and .player-bar, which never scroll.
Contrast — 29 themes: Audited all themes against WCAG AA. Fixed --text-muted and --text-secondary values in 29 themes that had insufficient contrast ratios (< 3.5:1). Affects Catppuccin (all four variants), Gruvbox (all six), Nord variants, GW1, Heisenberg, Ice and Fire, Spider-Tech, Morpheus, Hill Valley 85, Dune, and others.

Removed

Theme: Azerothian Gold removed from the Games group.

[1.16.0] - 2026-03-24

Added

15 New Themes across multiple categories:
- Operating Systems: Aqua Quartz — Mac OS X Aqua (skeuomorphic jelly buttons, brushed aluminium player bar, pinstripe background, blue Source List sidebar, authentic #3876f7 accent)
- Movies: Spider-Tech (Spider-Man navy/red), T-800 (Terminator Skynet blue), B-Runner (Blade Runner 2049 amber), Hill Valley 85 (Back to the Future)
- Games: TetraStack (Tetris 8-bit, cyan, grid background, 0px radii)
- Series: Turtle Power (TMNT turtle green, brick tile sidebar)
- Social Media (new group): Insta (Instagram dark pink), ReadIt (Reddit dark orange-red), The Book (Facebook light, blue sidebar)
- Operating Systems: W3.1 (Windows 3.1, light silver/teal, 0px radii, inset bevels)
- Mediaplayer: Jayfin (Jellyfin-inspired — deep black, purple #AA5CC3 primary, cyan #00A4DC secondary, brand gradient on player bar and progress fill)
Aqua Quartz — Full Skeuomorphic Polish: All button variants (.btn-surface, .btn-ghost, .hero-play-btn, .album-card-details-btn, .queue-round-btn) now have the authentic Aqua jelly gradient. Sidebar sports the iconic blue Source List gradient with white icons and a white pill for the active nav link.

Changed

W98 Theme — Complete Overhaul: Rebuilt from scratch with authentic Windows 98 design language: correct #d4d0c8 warm-gray button face (not flat #c0c0c0), full 4-layer 3D bevel on all panels and buttons (raised default, sunken on press), song title displays in the iconic navy→light-blue title bar gradient, progress bar is a sunken white trough with navy fill, 16px styled scrollbar, all hover/active states consistently navy #000080 + white text.
Theme Picker — Alphabetical Order: All theme groups and themes within groups are now sorted alphabetically.
Theme Picker — Group Rename: "Psysonic Themes — Mediaplayer" renamed to "Mediaplayer".
Sidebar + Queue Toggle Buttons: Queue toggle button now uses the theme accent color (icon + hover).

Fixed

AlbumDetail — Genre not propagating: Playing via the album detail Play All / Enqueue All buttons now correctly includes the track genre in the constructed Track objects, making it show up in the Queue strip.
W98 — Theme Accordion active state: Open category headers are now navy with white text instead of black-on-navy.
Aqua Quartz — Sidebar section labels: "Library" / "System" labels now render in white on the blue sidebar.
W98 — Connection indicators: Server name and Last.fm username in the header are now black (#000000) on the warm-gray background for full readability.

Removed

Themes: Removed Pandora, Order of the Phoenix, and Imperial Sith — too similar to other better-executed themes in their respective groups.

[1.15.0] - 2026-03-23

Added

Queue — Genre · Format · Bitrate Strip: The meta box above the queue now shows a full-width frosted strip with Genre, audio format, and bitrate (e.g. Electronic · FLAC · 1411 kbps). Genre is sourced directly from track metadata and is now propagated through all 11 track construction sites across the codebase.
Lyrics — Accent Color Highlight: The active synced lyrics line is now highlighted in the theme accent color instead of bold+larger text. Eliminates layout jumps caused by the font-weight change pushing lines to wrap.

Fixed

Sidebar — Collapse Button: The collapse button now correctly sits on the right border of the sidebar, straddling the dividing line between sidebar and main content, and is always visible.

Changed

Queue — Tech Info: Codec/bitrate badge replaced by the new full-width Genre · Format · Bitrate strip at the top of the meta box.

[1.14.0] - 2026-03-22

Critical Fixes

Prebuffer Flood — 300 simultaneous downloads eliminated: The audio engine was spawning up to 300 concurrent HTTP download requests during prebuffering, causing network saturation of ~200 Mbit/s and significant CPU load. The root cause was unbounded parallel preload logic in the Rust engine. Fixed: the engine now buffers intelligently with a single controlled preload per track. Network usage dropped to under 100 kbit/s during normal playback.
Gapless Playback — fully stable: Gapless transitions now work correctly end-to-end. Previously, edge cases in the sample-accurate handoff between tracks caused audio glitches or silence between songs.
Crossfade — fully stable: The equal-power crossfade (sin/cos envelope) is now reliable across all track transitions. Previous instability was caused by race conditions in the fade-out trigger and Sink lifecycle management.
Now Playing Page — performance: The Now Playing page no longer causes sustained CPU spikes. Heavy re-renders triggered by frequent audio:progress events (previously every 500 ms with wall-clock drift) are resolved — progress is now driven by an atomic sample counter at 100 ms intervals with no layout thrashing.

Fixed

Volume — Clipping at 100%: Audible distortion at maximum volume eliminated. A MASTER_HEADROOM constant of −1 dB (0.891) is now applied to all volume calculations, preventing inter-sample peaks from 0 dBFS masters and EQ biquad ripple from clipping.
Seek — Display Desync: Seeking while paused could cause the time display to jump to the new position while audio continued from the old one. CountingSource::try_seek now only resets the sample counter after confirming the seek succeeded.
Gapless + Crossfade — Mutual Exclusion: Both modes can no longer be active simultaneously. Enabling one auto-disables the other (Queue toolbar + Settings). Running both simultaneously caused a glitch where Song 2, gapless-chained inside the Sink, would play at full volume after Song 1's crossfade completed.
Now Playing — About the Artist: The "About the Artist" card is now hidden when no biography is available. Artist images that fail to load are silently hidden instead of showing a broken image placeholder.

Added

Waveform — Hover Tooltip: Hovering over the waveform seekbar shows a floating time label above the cursor. Hidden when no track is loaded or the cursor leaves.
Hero & Album Detail — Format Badge: Audio format (FLAC, MP3, OGG, …) now shown alongside Year, Genre, and Track Count in the hero meta row on the Home page and in the Album Detail header.
Help — FLAC Seeking: New FAQ entry explaining that FLAC files without an embedded SEEKTABLE cannot be seeked, with instructions for adding one via flac or metaflac.

Changed

Queue — Tech Info: Codec/bitrate badge moved from the frosted-glass cover overlay into the top-right corner of the meta box. Album artwork is no longer obscured.

[1.13.0] - 2026-03-22

Added

SVG Logo: The Psysonic wordmark is now an inline SVG with a theme-adaptive gradient (--accent → --ctp-blue), matching the app's visual identity across all 47 themes. The collapsed sidebar shows a standalone P-icon with the same gradient.
Player Bar — Marquee: Song title and artist name scroll smoothly when the text overflows the fixed-width track info area, pause briefly, then jump back and repeat.
Player Bar — Volume Tooltip: A floating percentage label appears above the volume slider on hover and updates live while dragging.

Changed

Sidebar — Collapse button: Moved from the brand header to a small circular hover-tab on the right edge of the sidebar. Hidden until you hover over the sidebar, keeping the logo area uncluttered.
Player Bar — Layout: Track info area is now a fixed 320 px width. Waveform section has increased margins on both sides for better visual separation between controls, waveform, and volume.
Settings: Server tab is now the default when opening Settings.
Crossfade: Experimental badge removed — considered stable.
Help page: Added entries for Lyrics, Configurable Keybindings, and Font Picker. Theme count corrected to 47 themes across 7 groups.

Fixed

Global shortcuts — double-fire: Pressing a global shortcut (e.g. Ctrl+Alt+→) was triggering the action twice. Root cause: on_shortcut() in tauri_plugin_global_shortcut accumulates handlers per shortcut across JS HMR reloads. Fixed with a Rust-side ShortcutMap state that makes register_global_shortcut idempotent.
W98 theme: Comprehensive contrast fixes across all interactive elements — hover states, buttons, queue items, settings panels, and toggles now use silver-grey (#e0e0e0) text on navy (#000080) backgrounds.
Help page: Removed orphaned translation key that was rendering as raw text under the Playback section.

Beta

Global Shortcuts (Settings → Global Shortcuts): System-wide keyboard shortcuts that trigger playback actions while Psysonic is in the background. Functional on all platforms, but edge cases with certain key combinations or OS-level conflicts may still occur.

[1.12.0] - 2026-03-22

Added

Synchronized Lyrics: Lyrics pane integrated into the Queue sidebar, powered by LRCLIB — no API key required. Shows time-synced lyrics with auto-scroll and active-line highlighting; falls back to plain text when synced lyrics are unavailable. Access via the microphone icon in the player bar, fullscreen player, or Now Playing page.

15 New Themes

Games (new group — 6 themes):

Ascalon: Dark stone fantasy inspired by Guild Wars 1. Near-black base, gold accent (#d4af37).
Azerothian Gold: World of Warcraft inspired. Charcoal base, warm gold accent (#c19e67).
Grand Theft Audio: GTA-inspired night city aesthetic. Pure black base, green accent (#57b05a).
Lambda 17: Half-Life inspired. Deep blue-black base, amber accent (#ff9d00).
NightCity 2077: Cyberpunk 2077 inspired. Near-total black base, neon yellow accent (#FCEE0A).
V-Tactical: Battlefield inspired. Gunmetal base, burnt orange accent (#ff8a00).

Series (new group — 3 themes):

A Theme of Ice and Fire: Game of Thrones inspired. Cold dark navy base, ice blue accent (#70a1ff).
D'oh-matic: The Simpsons inspired. Cream/yellow light base, blue accent (#1F75FE).
Heisenberg: Breaking Bad inspired. Dark desaturated green base, crystal blue accent (#3fe0ff).

Movies (2 additions):

Imperial Sith: Star Wars dark side. Pure black base, red accent (#e60000).
Order of the Phoenix: Harry Potter inspired. Deep charcoal base, ember-orange accent (#e63900).

Operating Systems (1 addition):

W98: Windows 98 teal desktop aesthetic. Classic teal background, silver card, navy accent (#000080).

Changed

Last.fm integration: Promoted out of beta — scrobbling, Now Playing, love/unlove, Similar Artists, and top stats are considered stable.
Crossfade: No longer marked experimental. Stable on Windows and Linux; macOS under observation.
Gapless playback: Experimental badge removed — considered stable.
Theme picker — groups reorganised: Catppuccin, Nord, and Retro (Gruvbox) merged into a single Open Source Classics group. Streaming themes (Spotless, DZR, Cupertino Beats) moved into Psysonic Themes — Mediaplayer. The app now ships 47 themes across 7 groups.
Tokyo Night themes removed: tokyo-night, tokyo-night-storm, and tokyo-night-light retired to make room for the new groups.
Settings — tab order: Reordered to Server → Appearance → Playback → Library → Shortcuts → About.
Settings — Theme picker: "Betriebssysteme" group renamed to "Operating Systems".

Fixed

Text selection on double-click: Double-clicking song titles or anywhere in the UI no longer accidentally selects text. user-select: none applied globally; re-enabled for bio/description text areas.
Middle Earth theme — star buttons: Active favourite star in the album tracklist and album header was barely visible (gold on parchment, ~1.4:1 contrast). Both active and inactive states now use darker brown tones with proper contrast.
Middle Earth theme — play button hover: Hovering the primary play/pause button no longer makes the icon invisible (gold icon on gold background).

[1.11.0] - 2026-03-22

Added

Five New Themes — Movies

Middle Earth: Warm parchment light theme. Cream/beige background, dark ebony player and sidebar, gold accent (#d4af37). Georgia serif for track names, subtle noise texture.
Morpheus: Pure black terminal aesthetic inspired by The Matrix. Phosphor green accent (#00ff41), monospace font.
Pandora: Deep bioluminescent navy inspired by Avatar. Cyan accent (#00f2ff), large radii, glow effects.
Stark HUD: Near-black tactical HUD inspired by Iron Man. Cyan accent, JetBrains Mono, uppercase track name.
Blade: Deep black with blood-red accent (#b30000). Sharp radii, uppercase track name.
All five themes in a new Movies group in the theme picker.

Changed

Settings — tab order: Reordered to Server → Appearance → Playback → Library → Shortcuts → About.
Settings — Appearance: Language selector moved to the top of the tab, above Theme and Font.
Settings — Theme picker: "Betriebssysteme" group renamed to "Operating Systems".
Default font: Changed from Inter to Lexend for new installations.
Gapless playback: Experimental badge removed — gapless is now considered stable.
Now Playing — background: Ken Burns animation (40 s, subtle scale + translate). Background blur increased to eliminate JPEG block artefacts at high blur values.
Now Playing — Similar Artists: Tag cloud redesigned into 2 rows with varied font sizes and vertical offsets for a natural look.
Statistics: "Now Playing" indicator rendered as a styled badge matching the app's badge style.

[1.10.0] - 2026-03-22

Added

Three New Themes (Streaming Series)

Spotless: Flat dark theme inspired by modern music streaming. Pitch-black sidebar (#000000), dark-grey app background (#121212), Spotify-green accent (#1ED760). White play button, green hover on primary actions.
DZR: Flat light theme inspired by Deezer's modern redesign. White base, light-grey sidebar (#F5F5F7), purple accent (#A238FF). Crisp typography, large rounded radii.
Cupertino Beats: Apple Music-inspired dark theme. Near-black base (#1c1c1e), frosted-glass sidebar and player bar with heavy backdrop-filter, red accent (#fa243c). Active nav links styled with accent-dim background.
All three themes added to the Psysonic Themes — Mediaplayer group in the theme picker.

Fixed

Favourite/Unfavourite toggle: Right-clicking a song, album, or artist that is already starred now shows "Remove from Favourites" and calls unstar() correctly. Previously always showed "Add to Favourites" regardless of starred state.
- Track interface gained starred?: string — propagated via songToTrack() and all inline track-object construction sites.
- starredOverrides: Record<string, boolean> added to playerStore — updated immediately on star/unstar so the context menu and tracklist star icons reflect changes without a page reload.
Home page — Artist Discovery: Replaced card grid (which loaded artist images and caused performance issues) with lightweight pill-buttons — same artist-ext-link style as the "Similar Artists" section on artist pages. No image loading, instant render.
Now Playing page: Queue sidebar is no longer automatically hidden when entering the Now Playing page. It now behaves like all other pages and respects the user's current queue visibility setting.
Random Mix filter panel: Background now correctly uses --bg-card instead of the undefined --bg-elevated token, which caused the panel to render transparent in most themes.

Changed

Home page layout: Section order is now: Recently Added → Discover → Artist Discovery → Starred → Most Played.

[1.9.0] - 2026-03-21

Added

Three New Themes

Neon Drift: Deep midnight-blue background (#12132c) with electric cyan accent (#00f2ff) — subtle synthwave/cyberpunk aesthetic. Glowing player track name, cyan-glow nav active state, neon-lit primary buttons, glowing range slider thumb.
Cupertino Light: macOS Ventura-inspired light theme. Clean white base, Apple-grey sidebar (#f2f2f7), Apple blue accent (#0071e3). Frosted-glass sidebar and player bar with backdrop-filter: blur. Solid blue pill nav active (white text, no left border).
Cupertino Dark: macOS Ventura-inspired dark theme. Space Grey base (#1e1e1f), dark frosted sidebar, vibrant blue accent (#007aff). Same pill nav active as Cupertino Light. Solid blue Play/Pause button with glow.

New Theme Group: Betriebssysteme

OS-aesthetic themes are now consolidated into one group: Cupertino Light, Cupertino Dark, Aero Glass, Luna Teal.
Psysonic Themes and Psysonic Themes — Mediaplayer moved to the top of the theme picker.

Configurable Keybindings

New keybindingsStore with 10 bindable actions: Play/Pause, Next, Previous, Volume Up/Down, Seek ±10 s, Toggle Queue, Fullscreen Player, Native Fullscreen.
Rebind any action in Settings → Keybindings — click the key badge, press any key, saved immediately to localStorage.
Defaults: Space = Play/Pause, F11 = Native Fullscreen. All other actions unbound by default.

Font Picker

10 UI fonts selectable in Settings → Appearance: Inter, Outfit, DM Sans, Nunito, Rubik, Space Grotesk, Figtree, Manrope, Plus Jakarta Sans, Lexend.
Persisted in localStorage (psysonic_font), applied via data-font attribute on <html>.

Home Page — Instant Play

Album cards: "Details" button replaced with a Play button — clicking plays the album immediately with a smooth 700 ms fade-out of the current track.
Hero: "Play Album" button now starts playback directly (with fade-out) instead of navigating to the album detail page.
Fade-out implemented via playAlbum.ts utility: fades volume to 0 over 700 ms, restores volume in the store (no Rust side-effect) before handing off to playTrack.

Now Playing Page — Layout & Readability

3-column hero layout: album cover + info (left, flex: 1) — EQ bars (centre, fixed width) — tag cloud (right, flex: 1). EQ bars are now truly centred regardless of content length on either side.
Background: increased brightness from 0.25 to 0.55, reduced overlay opacity from 0.55 to 0.38 — background art is now visible instead of near-black.
Text contrast: track times, card links (artist/album), and section title opacity all increased for better readability on the blurred background.

Changed

Theme Renames — Trademark-Safe Names

All media-player and OS-themed theme IDs and labels have been renamed to avoid potential trademark conflicts:

Old Name	New Name
Classic Winamp	WnAmp
Musicmatch Jukebox	Navy Jukebox
WMP8 Classic	Cobalt Media
PowerDVD Classic	Onyx Cinema
Win7 Aero	Aero Glass
WinXP Luna	Luna Teal

Note

: If you had one of these themes selected, your preference will reset to Mocha on first launch. Re-select your preferred theme in Settings.

Fixed

Linux — ALSA underruns: PIPEWIRE_LATENCY (4096/48000 ≈ 85 ms) and PULSE_LATENCY_MSEC (85) are now set before audio stream creation, reducing the frequency of ALSA snd_pcm_recover underrun events on PipeWire systems. Existing user-set values are respected.

[1.8.0] - 2026-03-21

Added

Three New Themes

Poison: Dark charcoal background (#1a1a1a) with phosphor green (#1bd655) accent — high-contrast, industrial aesthetic. LCD glow text-shadow on the now-playing track name.
Nucleo: Warm brass/cream light theme inspired by vintage hi-fi equipment. Warm white cards, gold/amber accents, brushed-metal bevel buttons, and a warm LCD glow on the player track name. color-scheme: light.
Classic Winamp: Cool gray-blue dark theme (#2b2b3a) channelling the classic Winamp 2.x skin. Yellow primary accent (#d4cc46), orange volume slider override (--volume-accent: #de9b35), Courier New monospace font with bright-green LCD glow for the track name.

Psychowave Theme — Major Overhaul

Psychowave recoloured from loud neon pink/purple to a refined deep violet palette: background #161428, accent #a06ae0. All neon colours replaced with muted, tasteful variants. No longer marked as WIP.

ThemePicker Redesign

Themes reorganised into semantic groups: Catppuccin, Nord, Retro (formerly Gruvbox), Tokyo Night, and a new Psysonic Themes section (Classic Winamp, Poison, Nucleo, Psychowave). The separate Experimental group is removed.
"Gruvbox" renamed to Retro.

Clicking the album cover on an Album Detail page or the artist avatar on an Artist Detail page opens a full-screen lightbox showing the high-resolution image (up to 2000 px). Click outside or press Escape to close.
Both use a shared CoverLightbox component — consistent behaviour across the app.

The queue panel now has a centred icon toolbar with round buttons (border-radius 50%, solid accent fill when active):
- Shuffle — Fisher-Yates shuffle, keeps current track at position 0
- Save — save queue as playlist
- Load — load a playlist into the queue
- Clear — remove all tracks from the queue
- Gapless (∞ icon) — toggle gapless playback on/off
- Crossfade (≋ icon) — toggle crossfade on/off; when inactive, clicking enables crossfade and opens a popover slider
Crossfade popover: a small overlay below the Crossfade button with a range slider (1–10 s) to configure the fade duration. Clicking the active Crossfade button disables crossfade and closes the popover. Closes on outside click.
Queue header: title enlarged to 16 px/700, track count and total duration shown inline next to the title in accent colour. Close (×) button removed.
Tech info overlay: codec and bitrate displayed as a frosted glass badge (backdrop-filter: blur(4px)) overlaid on the bottom edge of the cover art image.

French & Dutch Translations

Full UI translation added for French (fr) and Dutch (nl) — all namespaces covered.
Language selector in Settings now lists all four languages sorted alphabetically (Dutch, English, French, German).

Help Page — Layout & Content Update

2-column grid layout for the accordion — makes better use of horizontal space on widescreen displays.
New Q&A entry: Crossfade & Gapless (Playback section) — explains what each feature does, how to enable them, and their experimental status.
Updated entries: Themes (reflects all 21 themes), Languages (4 languages), Scrobbling (direct Last.fm), System browser links, Linux distribution (no AppImage).

Settings — Experimental Labels

Crossfade and Gapless toggles in Settings → Playback now show an "Experimental" badge next to their label.

Fixed

Now Playing dropdown — refresh button: The refresh icon spin was applied to the entire button, blocking clicks during the animation. Spin state is now separate from the background poll loading state — the button is always clickable, and the icon spins for a minimum of 600 ms for clear visual feedback.
Crossfade popover positioning: Popover was overflowing the right edge of the viewport. Now right-aligned relative to the Crossfade button and positioned below it.

[1.7.2] - 2026-03-20

Fixed

Last.fm: Stability improvements for the authentication flow and session handling.
Settings: Minor display fixes in the Last.fm profile badge.

[1.7.1] - 2026-03-20

Fixed

Build: TypeScript errors in Settings.tsx and Statistics.tsx that broke the release build.

[1.7.0] - 2026-03-20

Added

Last.fm Integration (Beta)

Direct Last.fm scrobbling: Tracks are scrobbled directly via the Last.fm API at 50% playback — no longer routed through Navidrome. Configure in Settings → Server with your Last.fm username and password.
Now Playing updates: Last.fm receives the currently playing track in real time.
Love / Unlove: Heart button in the Now Playing page and player bar syncs the loved state with Last.fm instantly.
Last.fm profile badge in Settings → Server: shows your scrobble count and member since year once connected.
⚠️ This feature is in beta. Session management and edge cases are still being refined.

Similar Artists

Artist detail pages now show a Similar Artists section below Top Tracks, sourced from Last.fm and filtered to artists actually present in your library. Shown as chip buttons — click to navigate directly to that artist's page.
Requires Last.fm to be configured. Hidden when Last.fm is not connected or no library matches are found.

Statistics — Last.fm Stats

New Last.fm Stats section on the Statistics page (requires Last.fm): top artists, albums, and tracks with proportional play-count bars.
Period filter: switch between Last 7 Days, 1 Month, 3 Months, 6 Months, 12 Months, and Overall.
Recent Scrobbles: last 20 scrobbled tracks with relative timestamps and a "Now Playing" badge for the currently active entry.
Genre Distribution removed: replaced by the Last.fm stats sections.

Psychowave Theme (Work in Progress)

New Psychowave theme: a deep purple/violet dark theme inspired by synthwave and retrowave aesthetics.
⚠️ Still in active development — colors and details will continue to be refined in upcoming releases.

All tooltips now use a React portal rendered into document.body at z-index: 99999. Replaces the previous CSS ::after pseudo-element system.
Fixes tooltip clipping inside overflow: hidden containers (player bar, queue panel, EQ).
Fixes black OS-native tooltip boxes that appeared on native title= attributes — all converted to data-tooltip.
Smart edge detection: tooltip flips position automatically when it would overflow the viewport.

Custom Select Dropdowns

Theme, Language, and EQ preset selectors are now rendered as styled portal dropdowns — no more unstyled native <select> boxes.
Supports option groups (EQ: Built-in Presets / Custom Presets), keyboard navigation, and click-outside-to-close.

Changed

Fullscreen Player / Now Playing — Background

Ken Burns animation improved: background image now has significantly more movement (±8% translate, inset: -30%) with a 90-second cycle — more cinematic without being distracting.
Color orbs removed from both the Fullscreen Player and the Now Playing page. They caused noticeable GPU load especially on integrated graphics.

Fixed

Live dropdown (Now Playing): Own playback was no longer reported to Navidrome after the Last.fm implementation removed the reportNowPlaying call. Both are now called independently on track start.
Sidebar: Now Playing button position when collapsed: The button was appearing in the middle of the nav instead of just above the System section. Caused by a leftover margin-top: auto on the Statistics link that split the remaining flex space.

[1.6.0] - 2026-03-19

⚠️ Wichtiger Hinweis / Important Notice

DE: Der Bundle-Identifier der App wurde von dev.psysonic.app auf dev.psysonic.player geändert. Alle gespeicherten Einstellungen (Server-Profile, Theme, EQ, Sprache usw.) gehen beim Update auf diese Version einmalig verloren und müssen neu eingetragen werden. Zukünftige Updates sind davon nicht betroffen.

EN: The app's bundle identifier has changed from dev.psysonic.app to dev.psysonic.player. All saved settings (server profiles, theme, EQ, language, etc.) will be reset once when updating to this version and need to be re-entered. Future updates are not affected.

Added

Replay Gain

Replay Gain support in the Rust audio engine. Gain and peak values from the Subsonic API are applied per-track at playback time, keeping loudness consistent across your library.
Two modes selectable in Settings → Playback: Track (default) and Album gain.
Peak limiting applied to prevent clipping: effective gain is capped at 1 / peak.
Volume slider preserves the gain ratio — audio_set_volume multiplies base_volume × replay_gain_linear.

Crossfade

Crossfade between tracks (0.5 – 12 s, configurable in Settings → Playback).
Old sink is volume-ramped to zero in 30 steps while the new track starts playing; old sink stored in fading_out_sink so a subsequent skip cancels the fade-out immediately.
audio_set_crossfade Tauri command; synced to Rust on startup and on toggle.

Gapless Preloading (Experimental — Alpha)

Gapless playback: when ≤ 30 s remain in the current track, the next track's audio is preloaded via audio_preload in the background.
audio_play checks the preload cache first — if there is a URL match the download is skipped entirely, eliminating the gap between tracks.
The old Sink is kept alive during the new track's download and decode phase; the Sink swap happens atomically after decoding is complete, fixing a subtle start-of-track audio cut that occurred regardless of gapless state.
⚠️ This feature is experimental and still in active development. It may not work correctly in all scenarios. Enable it in Settings → Playback at your own discretion.

Settings reorganised into 5 horizontal tabs: Playback, Library, Appearance, Server, About.
Each tab groups related settings with a matching icon.

Artist Pages — "Also Featured On"

Artist detail pages now show an "Also Featured On" section listing albums where the artist appears as a guest or featured performer (but is not the primary album artist).
Implemented via search3 filtered by song.artistId, excluding the artist's own albums.

When no download folder is configured and the user initiates a download (album or track), a folder picker modal now appears asking where to save.
Includes a "Remember this folder" checkbox that writes the choice to Settings.
Clear button added in Settings → Server to reset the saved download folder.

Changelog in Settings

The full Changelog is now readable inside the app under Settings → About.
Rendered as collapsible version entries; the current version is expanded by default.
Inline Markdown (**bold**, *italic*, `code`) is rendered natively.

The Equalizer is now accessible directly from the player bar via a small EQ button, opening as a centred popup overlay — no need to navigate to Settings.

Fixed

Bundle identifier warning: changed identifier from dev.psysonic.app to dev.psysonic.player to avoid the macOS .app extension conflict warned by Tauri.
Version mismatch in releases: tauri.conf.json version was out of sync with package.json and Cargo.toml, causing GitHub Actions to build release artefacts with the wrong version number. All four version sources (package.json, Cargo.toml, tauri.conf.json, packages/aur/PKGBUILD) are now kept in sync.

Known Issues

FLAC seeking: jumping to a position in a FLAC file via the waveform seekbar currently does not work. Seeking in MP3, OGG, and other formats is unaffected.

[1.5.0] - 2026-03-18

Added

10-Band Graphic Equalizer

Full 10-band graphic EQ implemented entirely in the Rust audio engine using biquad peak filters (31 Hz – 16 kHz). Gains adjustable ±12 dB per band.
EQ is processed in the audio pipeline via EqSource<S> — a custom rodio::Source wrapper that applies cascaded biquad filters in real-time.
Filter coefficients update smoothly on every 1024-sample block without audio interruption.
Seek support: EqSource::try_seek() implemented — filter state is reset on seek to prevent clicks/artefacts. This also fixes waveform seek, which had silently broken when the EQ was introduced (rodio returned SeekError::NotSupported without the impl).
10 built-in presets: Flat, Bass Boost, Treble Boost, Rock, Pop, Jazz, Classical, Electronic, Vocal, Acoustic.
Custom presets: save, name, and delete your own presets.
EQ state persisted via psysonic-eq localStorage key (gains, enabled, active preset, custom presets).
New audio_set_eq Tauri command; settings synced to Rust on startup via eqStore.syncToRust().

Connection Indicator

LED indicator in the header bar (green = connected, red = disconnected, pulsing = checking). Sits between the search bar and the Now Playing dropdown.
Shows server name and LAN/WAN status next to the LED.
Offline overlay: when the server is unreachable, a full-content-area overlay appears with a retry button.
useConnectionStatus hook pings the active server periodically and exposes status, isRetrying, retry, isLan, and serverName.

Now Playing Page

New /now-playing route and NowPlayingPage component — accessible from the sidebar.

Fixed

Drag out of canvas no longer breaks seeking: mousemove and mouseup events are now registered on window (not the canvas element), so dragging fast across other elements still updates playback position correctly.
Stale closure fix: trackId and seek function are kept in refs so the window-level handlers always see the current values.

Changed

App Icon

New app icon (public/logo-psysonic.png) across all platforms — Login page, Sidebar, Settings About section, README header, and all generated Tauri platform icons (Windows ICO, macOS ICNS, Linux PNGs, Android, iOS).

[1.4.5] - 2026-03-17

Changed

Artist Pages — External Links

Last.fm and Wikipedia buttons now open in the system browser instead of an in-app window. The button label temporarily changes to "Opened in browser" / "Im Browser geöffnet" for 2.5 seconds as visual confirmation.

Queue Panel

Release year added to the now-playing meta box, shown below the album name (when available).
Cover art enlarged from 72 × 72 px to 90 × 90 px, aligned to the top of the meta block so it lines up with the song title.
Default width increased from 300 px to 340 px.

[1.4.4] - 2026-03-17

Added

AUR Package

Psysonic is now available on the Arch User Repository — Arch and CachyOS users can install via yay -S psysonic or paru -S psysonic. Builds from source using the system's own WebKitGTK, avoiding the EGL/Mesa compatibility issues that affected the AppImage on modern distros.

Changed

App Icon

New app icon across all platforms (Windows, macOS, Linux, Android, iOS).

Linux Distribution

AppImage removed: The AppImage was fundamentally incompatible with non-Ubuntu distros (Arch, Fedora) due to bundled WebKitGTK conflicting with the system's Mesa/EGL. Linux users should use the .deb (Ubuntu/Debian), .rpm (Fedora/RHEL), or the new AUR package (Arch/CachyOS).

[1.4.3] - 2026-03-16

Fixed

Random Mix — Genre Mix

Second "Play All" button removed: The genre mix section had a redundant play button below the super-genre selector. The top-right button is now context-aware — it plays the genre mix when one is active, otherwise the regular mix.
"Play All" disabled during genre mix loading: The button now stays grayed out with a live progress counter (n / 50) until all songs are fully loaded. Clicking while the list was still building sent only the songs loaded so far.
Over-fetching fixed: Genre mix previously fetched up to 100+ songs and sliced to 50 at the end. Now the matched genre list is capped at 50 (randomly sampled when more match) so the total fetch stays close to 50 with no wasted server I/O.
Regular mix cache-busting: getRandomSongs requests now include a timestamp parameter, preventing browser/axios from returning a cached response and showing the same list on every remix.
Display/state mismatch on remix: Clicking "Mischen" now clears the current list immediately, ensuring the spinner is shown and the displayed songs always match what "Play All" would send.

Queue Panel

Hover highlight lost on right-click: Queue items now retain their hover highlight while a context menu is open for them (.context-active CSS class).
Song count and total duration: The queue header now shows the number of tracks and total runtime below the title (e.g. 12 tracks · 47:32).

"Favorite" option added for queue items: Right-clicking a queue item now includes a "Favorite" option, consistent with the song context menu.

[1.4.2] - 2026-03-16

Fixed

Linux AppImage — Modern Distro Compatibility

Build upgraded to Ubuntu 24.04: The AppImage was previously built on Ubuntu 22.04 with WebKitGTK 2.36. On modern distros (CachyOS, Arch, etc.) with Mesa 25.x, eglGetDisplay(EGL_DEFAULT_DISPLAY) returns EGL_BAD_PARAMETER and aborts immediately because newer Mesa no longer accepts implicit platform detection. Building on Ubuntu 24.04 bundles WebKitGTK 2.44 which uses the correct eglGetPlatformDisplay API.
EGL_PLATFORM=x11 added to AppRun: Additional safeguard that explicitly tells Mesa's EGL loader to use the X11 platform when the app is running under XWayland.

Shell — Update Link

shell:allow-open capability now includes a URL scope (https://**), fixing the update toast link that silently did nothing in Tauri v2 without an explicit allow-list.

[1.4.1] - 2026-03-16

Fixed

Random Albums — Performance & Memory

Auto-refresh removed: The 30-second auto-cycle timer caused 10 React state updates/second (progress bar interval) and a burst of 30 concurrent image fetches on every tick, eventually making the whole app unresponsive. The page now loads once on mount; use the manual refresh button to get a new selection.
Concurrent fetch limit: Image fetches are now capped at 5 simultaneous network requests (was unlimited — 30 at once on every refresh).
Object URL memory leak: The in-memory image cache now caps at 150 entries and revokes old object URLs via URL.revokeObjectURL() when evicting. Previously, object URLs accumulated without bound across the entire session.
Dangling state updates: useCachedUrl now uses a cancellation flag — if a component unmounts while a fetch is in flight (e.g. during a grid refresh), the resolved URL is discarded instead of calling setState on an unmounted component.

i18n

Page title "Neueste" on the New Releases page was hardcoded German. Now uses t('sidebar.newReleases').

[1.4.0] - 2026-03-16

Added

Statistics Page — Upgraded

Library overview: Four stat cards at the top showing total Artists, Albums, Songs, and Genres — counts derived from the library in parallel.
Recently Played: Horizontal scroll row showing the last played albums with cover art.
Most Played: Ranked list of the most frequently played tracks.
Highest Rated: List of top-rated tracks by user star rating.
Genre Chart: Visual bar chart of the top genres by song and album count.

Playlists Page — Redesigned

Replaced the card grid with a clean list layout.
Sort buttons: Sort by Name, Tracks, or Duration — click again to toggle ascending/descending.
Filter input: Live search across playlist names.
Play and delete buttons appear on row hover.

Favorites — Songs Section Upgraded

Tracks now display in a full tracklist layout matching Album Detail: separate #, Title, Artist, and Duration columns with a header row.
Artist name is clickable and navigates to the artist page.
Right-click context menu on any track (Go to Album, Add to Queue, etc.).
"Add all to queue" button (btn btn-surface) next to the section title.

New Go to Album option (Disc3 icon) added for song and queue-item context menu types.
Only shown when the song has a known albumId.

Queue Panel — Meta Box

Now shows: Title (no link) → Artist (linked to artist page) → Album (linked to album page).
Removed year display and the old title→album link.

Random Mix — Hover Persistence

Track row stays highlighted while its context menu is open via .context-active CSS class.
Highlight is cleared automatically when the context menu closes.

Artist Cards — Redesigned

ArtistCardLocal now matches AlbumCard exactly: no padding, full-width square cover via aspect-ratio: 1, name and meta below.
Uses CachedImage with coverArtCacheKey for proper IndexedDB caching.
Same flex: 0 0 clamp(140px, 15vw, 180px) sizing as album cards — artist cards are no longer oversized.

Fixed

Random Albums — Cover Loading & Manual Refresh

Removed renderKey: The album grid was fully remounted on every refresh, restarting all 30 IndexedDB image lookups from scratch. Grid is now stable — only data changes, images stay cached.
loadingRef guard: Prevents concurrent fetch calls if the auto-cycle timer fires during a manual refresh.
Timer race condition: Manual refresh now calls clearTimers() before load(), eliminating the race where the auto-cycle timer fired mid-load.

Arrow nav buttons in the Artists section now use the same CSS classes as the Albums section (album-row-section, album-row-header, album-row-nav) — consistent styling across both rows.

Changed

AlbumDetail refactored into a thin orchestrator. Logic extracted into AlbumHeader (src/components/AlbumHeader.tsx) and AlbumTrackList (src/components/AlbumTrackList.tsx).
German i18n: "Queue" consistently translated as "Warteschlange" throughout — queue.shuffle, favorites.enqueueAll.

[1.3.0] - 2026-03-15

Added

Waveform seekbar: Replaces the classic thin slider. A canvas-based waveform with 500 deterministic bars (seeded by trackId) fills the full available width. Played portion renders as a blue → mauve gradient with a soft glow; buffered range is slightly brighter; unplayed bars are dimmed to 28% opacity. Click or drag anywhere to seek.
New layout: Single flex row — [Cover + Track Info] [Transport Controls] [Waveform + Times] [Volume]. More breathing room for the waveform; controls feel lighter and better proportioned.
Queue toggle relocated: Moved from the bottom player bar to the top-right of the content header — consistent with the sidebar collapse button pattern. Uses PanelRightClose / PanelRight icons (same family as PanelLeftClose / PanelLeft in the sidebar).

Ambient Stage — MilkDrop Visualizer

Butterchurn integration: Clicking the waveform icon (top-right of the fullscreen player) activates the MilkDrop visualizer powered by butterchurn + butterchurn-presets.
A hidden <audio> element is routed through the Web Audio API AnalyserNode (not connected to AudioDestinationNode — completely silent). The Rust/rodio engine continues to handle actual audio output.
Starts with a random preset; the shuffle button cycles through all available presets with a 2-second blend transition. Current preset name is shown in the top bar.
When the visualizer is active, the blurred background, orbs, and overlay are replaced by the canvas.

Tracklist — Animated Equalizer Indicator

The currently playing track shows three animated equalizer bars (CSS scaleY keyframe animation, staggered timing) instead of a static play icon.
When paused, the static play icon is shown.
Hovering any other track still shows a play icon.
Track row alignment fixed: align-items: center on the grid row + .track-num as flex center — icons and track numbers are now perfectly vertically aligned with the song title.

Artist Pages — In-App Browser

Last.fm and Wikipedia buttons now open a native Tauri WebviewWindow (1100 × 780, centered) instead of the system browser. Both sites load fully within the app and can be closed independently.
Required new capabilities: core:window:allow-create, core:webview:allow-create-webview-window.

Update Checker

Update check now runs every 10 minutes during runtime in addition to the initial check 1.5 s after launch.
Version label in the update toast no longer includes a v prefix (shows 1.3.0 instead of v1.3.0).

Help Page

New Random Mix section: explains the random mix, keyword filter, and super genre mix.
Updated Playback section: waveform seekbar, MilkDrop visualizer, queue shuffle.
Updated Library section: in-app browser for artist links.
Updated queue entry to reflect the new toggle location.
Accordion styling: open question and answer share a continuous 3 px accent stripe on the left; answer background uses --bg-app for clear contrast against the question's --bg-card.

Fixed

Version in Settings was hardcoded to 1.0.12. Now imported from package.json at build time — same source as the sidebar update checker.
Hero / Discover duplicate albums: Both sections previously fetched random independently, often showing the same albums. Now a single request fetches 20; slice(0, 8) goes to the Hero carousel and slice(8) to the Discover row.
Active track pulse too aggressive: Changed from a background: transparent flash to a gentle opacity: 0.6 fade over 3 s — significantly less distracting.

Changed

Blacklist → Keyword Filter: Renamed throughout UI and i18n (EN + DE) to better reflect that the filter matches genre, title, and album fields — not just genre tags.

[1.2.0] - 2026-03-15

Added

Rust Audio Engine (replaces Howler.js)

New native audio backend built in Rust using rodio. Audio is now decoded and played entirely in the Tauri backend — no more reliance on the WebView's <audio> element or GStreamer pipeline quirks.
Tauri commands: audio_play, audio_pause, audio_resume, audio_stop, audio_seek, audio_set_volume.
Frontend events: audio:playing (with duration), audio:progress (every 500 ms), audio:ended, audio:error.
Generation counter (AtomicU64) ensures stale downloads from skipped tracks are cancelled immediately and do not emit events.
Wall-clock position tracking (seek_offset + elapsed) instead of sink.empty() (unreliable in rodio 0.19 for VBR MP3). audio:ended fires after two consecutive ticks within 1 second of the track end — avoids false positives near the end without adding latency.
Seek via sink.try_seek() — no pause/play cycle, no spurious ended events.
Volume clamped to [0.0, 1.0] on every call.

Playback Persistence & Cold-Start Resume

currentTrack, queue, queueIndex, and currentTime are now persisted to localStorage via Zustand partialize.
On app restart with a previously loaded track, clicking Play resumes from the saved position without losing the queue.
Position priority: server play queue position (if > 0) takes precedence over the locally saved value, so cross-device resume works correctly.

Random Mix — Genre Filter & Blacklist

Exclude audiobooks & radio plays toggle: filters out songs whose genre, title, or album match a hardcoded list (Hörbuch, Hörspiel, Audiobook, Spoken Word, Podcast, Krimi, Thriller, Speech, Fantasy, Comedy, Literature, and more).
Custom genre blacklist: add any genre keyword via the collapsible chip panel on the Random Mix page or in Settings → Random Mix. Persisted across sessions.
Clickable genre chips in the tracklist: clicking an unblocked genre tag adds it to the blacklist instantly with 1.5 s visual feedback. Blocked genres are shown in red.
Blacklist filter checks song.genre, song.title, and song.album to catch mislabelled tracks.

Random Mix — Super Genre Mix

Nine pre-defined Super Genres (Metal, Rock, Pop, Electronic, Jazz, Classical, Hip-Hop, Country, World) appear as buttons, auto-generated from the server's genre list — only genres with at least one matching keyword are shown.
Selecting a Super Genre fetches up to 50 songs distributed across all matched sub-genres in parallel, then shuffles the result.
Progressive rendering: the tracklist appears as soon as the first genre request returns — users with large Metal/Rock libraries no longer stare at a spinner for the entire fetch. A small inline spinner next to the title indicates that more genres are still loading.
"Load 10 more" button: fetches 10 additional songs from the same matched genres and appends them to the play queue.
Random playlist is automatically hidden while a Genre Mix is active.
Fetch timeout raised to 45 seconds per genre request (was 15 s) and Promise.allSettled used so a single slow/failing genre does not abort the entire mix.

Queue Panel

Shuffle button in the queue header: Fisher-Yates shuffles all queued tracks while keeping the currently playing track at position 0. Button is disabled when the queue has fewer than 2 entries.

UI / UX

LiveSearch keyboard navigation: arrow keys navigate the dropdown, Enter selects the highlighted item or navigates to the full search results page, Escape closes the dropdown.
Multi-line tooltip support: add data-tooltip-wrap attribute to any element with data-tooltip to enable line-wrapping (uses white-space: pre-line + \n in the string). Respects a 220 px max-width.
Genre column info icon in Random Mix tracklist header: hover tooltip explains the clickable-genre-to-blacklist feature.
Update link in the sidebar now uses Tauri Shell plugin open() to launch the system browser correctly — <a target="_blank"> has no effect inside a Tauri WebView.

Fixed

Songs skipping immediately (root cause: Tauri v2 IPC maps Rust snake_case parameters to camelCase on the JS side — duration_hint must be durationHint). All invoke() calls updated.
Play button doing nothing after restart: currentTrack was null after restart (not persisted). Fixed by adding it to partialize.
Position not restored after restart: initializeFromServerQueue overwrote the local saved position with the server value even when the server reported 0. Now falls back to the localStorage value when the server position is 0.
Genre Mix blank on Metal/Rock: a single timed-out genre request caused Promise.all to reject the entire mix. Replaced with Promise.allSettled + 45 s timeout; partial results are shown immediately.
Tooltip z-index: tooltips in the main content area were rendered behind the queue panel. Fixed by giving .main-content z-index: 1, establishing a stacking context above the queue (which sits later in DOM order).
Sidebar title clipping: "Psysonic" brand text was truncated at narrow viewport widths. Minimum sidebar width raised from 180 px to 200 px.

Changed

Audio architecture: Howler.js removed. All audio state (isPlaying, isAudioPaused, currentTime, duration) is now driven by Tauri events from the Rust engine rather than Howler callbacks.
Random Mix layout: Filter/blacklist panel and Genre Mix buttons are now combined in a two-column card at the top of the page instead of being scattered across the page.
Hardcoded genre blacklist extended with: Fantasy, Comedy, Literature.
getRandomSongs now accepts an optional timeout parameter (default 15 s) so callers can pass a longer value for large-library scenarios.

[1.0.12] - 2026-03-14

Fixed

Seek Stop Bug: Clicking the progress bar a second time no longer stops playback. Root cause: WebKit and GStreamer fire spurious ended events immediately after a direct audioNode.currentTime seek. A guard now checks lastSeekAt + playhead position to silently discard these false alarms.
Play/Pause Hang: Rapidly double-clicking the play/pause button no longer freezes the audio pipeline. A 300 ms lock prevents a second toggle from issuing pause→play before GStreamer has finished the previous state transition.
Queue DnD (macOS / Windows): Drop target index is now calculated from the mouse clientY position at drop time instead of refs, eliminating the dragend-before-drop timing race on macOS WKWebView and Windows WebView2.

Added

Live Now Playing navigation: Clicking an entry in the Live dropdown now navigates to the corresponding album page.

Changed

Hero blur: Increased background blur in the Hero section for a more immersive look.

[1.0.11] - 2026-03-14

Added

Search Results Page: Pressing Enter in the search bar now navigates to a dedicated full search results page showing artists, albums, and songs with proper column layout and headers.

Fixed

Search Results Column Alignment: Artist and album columns in the search results song list are now correctly aligned with their column headers.
Search Results Header Alignment: Fixed column header labels not aligning with song row content (root cause: auto-width Format column was sized independently per grid row).

Changed

Gapless Playback removed: Removed the experimental gapless playback feature. It caused intermittent song skipping and beginning cutoffs and was not reliable enough to ship. Standard sequential playback is used instead.

Known Issues

Seeking: Seeking may occasionally be unreliable, particularly on Linux/GStreamer. Fixed in 1.0.12.
Queue drag & drop (macOS / Windows): Queue reordering via drag & drop may not always work correctly on macOS and Windows. Fixed in 1.0.12.

[1.0.10] - 2026-03-14

Added

Active Track Highlighting: The currently playing song is highlighted in album tracklists with a subtle pulsing accent background and a play icon — persists when navigating away and returning.
Marquee Title in Fullscreen Player: Long song titles now scroll smoothly as a marquee instead of being cut off.
Clickable Artist / Album in Player Bar: Clicking the artist name navigates to the artist page; clicking the song title navigates to the album page. Same behaviour in the Queue panel's now-playing strip.
Linux App Menu Category: Application now appears under Multimedia in desktop application menus (GNOME, KDE, etc.) instead of "Other".
Windows MSI Upgrade Support: Added stable upgradeCode GUID so the MSI installer recognises previous versions and upgrades in-place without requiring manual uninstallation first.

Fixed

Drag & Drop (macOS / Windows): Queue reordering now works correctly on macOS WKWebView and Windows WebView2. The previous fix cleared index refs synchronously in onDragEnd, which fires before drop on both platforms — refs are now cleared with a short delay so onDropQueue can read the correct source and destination indices.
Settings Dropdowns: Language and theme selects now have a clearly visible border (was invisible against the card background).
Tracklist Format Column: Removed file size and kHz from the format column — codec and bitrate only. Column moved to the far right, after duration. Width is now dynamic (auto).
tauri.conf.json: Fixed invalid placement of shortDescription/longDescription (were incorrectly nested under bundle.linux, now at bundle level). Removed invalid nsis.allowDowngrades field.

Changed

Favorites Icon: Replaced the incorrect fork icon with a star icon in the Random Mix page, consistent with all other pages.
Sidebar: Removed drag-to-resize handle. Width now adapts dynamically to the viewport via clamp(180px, 15vw, 220px).
About Section: Added "Developed with the support of Claude Code by Anthropic" credit. Fixed "weiterzugeben" wording in German MIT licence text.
Minimize to Tray: Now disabled by default.

[1.0.9] - 2026-03-13

Added

Gapless Playback: The next track's audio pipeline is silently pre-warmed before the current track ends, eliminating the gap between songs — especially noticeable on live albums and concept records.
Pre-caching: Prefetched Howl instances are now actually reused for playback, giving near-instant track transitions instead of a new HTTP connection each time.
Buffered Progress Indicator: The seek bar now shows a secondary fill indicating how much of the current track has been buffered by the browser — visible in both the Player Bar and Fullscreen Player.
Resume on Startup: Pressing Play after launching the app now resumes the last track at the saved playback position instead of doing nothing.
Album Track Hover Play Button: Hovering over a track number in Album Detail reveals a play button for quick single-click playback.
Ken Burns Background: The Fullscreen Player background now slowly drifts and zooms (Ken Burns effect) for a more cinematic feel.
F11 Fullscreen: Toggle native borderless fullscreen with F11.
Compact Queue Now-Playing: The current track block in the Queue Panel is now a slim horizontal strip (72 px thumbnail) instead of a full-width cover, freeing up significantly more space for the queue list on smaller screens.

Fixed

GStreamer Seek Stability: Implemented a three-layer recovery system for Linux/GStreamer seek hangs: (1) seek queuing to prevent overlapping GStreamer seeks, (2) a 2-second watchdog that triggers automatic recovery if a seek never completes, (3) an 8-second hang detector that silently recreates the audio pipeline and resumes from the last known position if playback freezes entirely.
Fullscreen Player: Removed drop shadow from cover art — looks cleaner on lighter artist backgrounds.

Changed

Hero Section: Increased height (300 → 360 px) and cover art size (180 → 220 px) to prevent long album titles from clipping.
Player Bar: Controls and progress bar moved closer together for a more balanced layout.

[1.0.8] - 2026-03-13

Added

Ambient Stage: Completely redesigned Fullscreen Player. Experience an immersive atmosphere with drifting color orbs, a "breathing" cover animation, and high-resolution artist backgrounds.
Improved Drag & Drop: Rewritten Play Queue reordering for rock-solid reliability on macOS (WKWebView) and Windows (WebView2).

Fixed

Linux Audio Stability: Resolved playback stuttering when seeking under GStreamer by implementing a robust pause-seek-play sequence.
Data Integration: Standardized artistId propagation across all track sources for better metadata consistency.

[1.0.7] - 2026-03-13

Added

Update Notifications: Integrated a native update check system in the sidebar that notifies you when a new version is available on GitHub.
Improved Settings: Refined layout and styling for a cleaner settings experience.

Fixed

UI/UX Refinements: Polished sidebar animations and layout for better visual consistency.
i18n: Added missing translations for update notifications and system status.

[1.0.6] - 2026-03-13

Added

Extended Themes: Selection expanded to 8 themes, including the complete Nord series (Nord, Snowstorm, Frost, Aurora).
Light Theme Support: Enhanced readability for Hero and Fullscreen Player components when using light themes (Latte, Snowstorm).

Fixed

Linux/Wayland Compatibility: Fixed immediate crash on Wayland environments by forcing X11 backend for the AppImage.
Playback Stability: Introduced seek debouncing to prevent audio stalls on Linux/GStreamer.
Windows Integration: Improved drag-and-drop compatibility for systems using WebView2.

[1.0.5] - 2026-03-12

Added

Image Caching: Integrated IndexedDB-based image caching for cover art and artist images, providing significantly faster loading times for frequently accessed items.
Improved Artist Discovery: Faster scrolling in the Artists list using color-coded initial-based avatars for quick visual identification.
Random Albums: New discovery page for exploring your library with random album selections.
Help & Documentation: Added a dedicated help page for better user onboarding.

Changed

Optimized UI: Instant "Now Playing" status updates via local state filtering for a more responsive experience.
Enhanced Data Flow: General performance improvements in server communication and state management.

[1.0.4] - 2026-03-12

Added

Album Downloads: Support for downloading entire albums with real-time progress tracking.

Fixed

Linux GPU Compatibility: Patched AppImage to disable DMABUF renderer, fixing EGL/GPU crashes on older hardware.
CI/CD Reliability: Optimized release workflow with split jobs for better stability across platforms.

[1.0.3] - 2026-03-12

Fixed

CI/CD Build: Resolved build conflicts on Ubuntu 22.04 by removing redundant dev packages (libunwind-dev, gstreamer dev).
Linux AppImage: Configured GStreamer bundling and verified runtime environment settings.

[1.0.2] - 2026-03-11

Fixed

Linux AppImage: Integrated GStreamer bundling fix in CI/CD workflow.
CI/CD Reliability: Set APPIMAGE_EXTRACT_AND_RUN=1 to prevent FUSE-related issues.

[1.0.1] - 2026-03-11

Fixed

Optimized Codebase: Integrated core fixes and performance improvements.
Improved Multi-Server Support: Fixed edge cases in server switching and credential management.
Enhanced Security: Switched to crypto.getRandomValues() for more robust auth salt generation.
Connection Reliability: Added pre-verification for server connections to prevent state synchronization issues.
Linux Compatibility: Applied workarounds for WebKitGTK compositing issues on Linux.

Changed

Repository maintenance and preparation for the 1.0.1 release.

[1.0.0] - 2026-03-09

Added

Initial Public Release: The first stable release of Psysonic.
Subsonic/Navidrome API: Full integration for browsing library, artists, albums, and playlists.
Audio Playback: Modern audio engine powered by Howler.js with support for various codecs.
Queue Management: Persistent play queue with drag-and-drop reordering and server-side synchronization.
Secured Credentials: Industry-standard security using Tauri's encrypted store for authentication tokens.
Design System: Premium aesthetics based on the Catppuccin palette (Mocha & Latte themes).
Multi-Language: Full localization support for English and German.
Fullscreen Mode: Dedicated immersive player view with high-res album art.
Last.fm Scrobbling: Built-in support for track scrobbling to Last.fm via Navidrome.
System Integration: Native tray icon support, minimize-to-tray, and global media key handling.
Intelligent Networking: Automatic or manual switching between LAN (Local) and External (Internet) addresses.
Live Now Playing: Real-time view of what other users or players are streaming on your server.
Search: Fast, real-time search for songs, albums, and artists.

Security

Hardened Sandbox: Restricted filesystem permissions to only necessary download/cache directories.
API Lockdown: Disabled global Tauri objects to mitigate XSS risks.
Credential Storage: Replaced insecure localStorage with a native encrypted store.

Fixed

Fixed a memory leak in the track prefetching engine.
Improved Error handling for unstable Subsonic server responses.

141 KiB Raw Blame History Unescape Escape

Changelog

[1.34.6] - 2026-04-08

🚨 Critical Fix

Added

Fixed

[1.34.5] - 2026-04-08

🚨 Critical Fix

Added

Changed

Fixed

[1.34.4] - 2026-04-08

Added

Fixed

i18n

[1.34.3] - 2026-04-07

Added

Fixed

i18n

[1.34.2] - 2026-04-07

Added

Changed

Fixed

i18n

[1.34.1] - 2026-04-06

Added

Changed

Fixed

i18n

[1.34.0] - 2026-04-06

Added

Fixed

Changed

[1.33.0] - 2026-04-06

Added

Changed

Fixed

[1.32.0] - 2026-04-05 — The Big Easter Update 🐣

Added

Changed

Fixed

[1.31.0] - 2026-04-04

Added

Changed

Fixed

[1.30.0] - 2026-04-03

Added

Fixed

Changed

[1.29.0] - 2026-04-02

Added

Fixed

Changed

Contributors

[1.28.0] - 2026-04-02

Added

Fixed

[1.27.4] - 2026-04-02

Added

Fixed

[1.26.1] - 2026-04-01

Fixed

[1.26.0] - 2026-04-01

Added

Fixed

Changed

[1.25.1] - 2026-04-01

Fixed

[1.25.0] - 2026-04-01

Added

Fixed

[1.24.0] - 2026-03-31

Added

Fixed

Changed

[1.23.0] - 2026-03-30

Added

Fixed

Changed

Theme Fixes

141 KiB

Raw Blame History