Changelog

1.1.0 — May 25, 2026

Flacify.Console — Terminal.Glue Framework

Replaced Spectre.Console with Terminal.Glue framework — all interactive elements now use Terminal.Glue.Controls.* controls
First-run setup wizard with drive path and output directory configuration
Landing screen (no CD detected) with R/S/E/Q keyboard shortcuts
Dashboard metadata editor with per-track editing, multi-disc support
Settings screen (output directory, FLAC level, drive path, toggles)
Genre manager (add/rename/delete custom genres)
Rip progress bars (real-time animation via callback)

Flacify.Console — Multi-Disc Improvements

Multi-disc manual entry: prompts for total discs and disc 2 track count
Placeholder tracks created for disc 2, editable in dashboard
Duration auto-updated from physical CD when disc 2 is detected
Track editing uses DTT format (101, 201) for multi-disc albums
Disc switch prompt converted to Terminal.Glue Modal with disc/total display

Flacify.Console — Metadata & Display Fixes

Genre no longer missing in dashboard display before rip
Real CD durations preserved in manual entry (no more --:--)
Text input cursor now visible in modal dialogs
Manual entry fallback for albums not found on MusicBrainz

Flacify.Server — PWA / Offline Support

Offline playback support with audio caching via Cache API
Service worker (sw.js) for offline fallback and asset caching
Song preloading for stalled playback recovery
Offline status indicator in the custom web player
PWA manifest at /manifest.json for installable web app

Tests

All 38 tests passing (37 pass + 1 intentionally skipped StartScan)

1.0.2 — May 24, 2026

Flacify.Server — Subsonic API Refactor

Replaced manual XElement building + fragile InferJsonValue with typed DTOs and proper System.Text.Json serialization — no more album titles like "21" being serialized as numbers
All numeric fields (duration, songCount, year, bitRate, etc.) now proper integers in JSON responses
XML responses now include <?xml?> declaration
Content-Type changed from application/xml to text/xml

Flacify.Server — Missing Endpoints

Added getAlbumInfo2 (alias for getAlbumInfo)
Added getTranscodeDecision (OpenSubsonic transcoding extension, returns canDirectPlay: true)
Added createBookmark / deleteBookmark stubs
Added [HttpGet("stream.view")], getCoverArt.view, download.view route attributes

Flacify.Server — Bug Fixes

Fixed .view suffix middleware — added explicit app.UseRouting() so routing sees the stripped path
getBookmarks JSON format fixed: "bookmarks":{"bookmark":[]} (was incorrectly wrapped in "error")
Artist coverArt attribute now included in getArtist and search3 responses
Playlist responses now include public attribute (both JSON and XML)
Genre element emits both name and value attributes for backward compatibility
Safe handling of empty artist names in getIndexes/getArtists

Flacify.Server — Performance

Song search with empty query (%% matching all songs) now uses projection query — ~4.3s → ~0.23s (18x faster)
SearchSongsLightAsync added with .Select(projection) to avoid loading full navigation graph

Flacify.Server — OpenSubsonic

Removed blanket openSubsonic="true" from all responses (was causing premature OpenSubsonic detection)
getOpenSubsonicExtensions endpoint still advertises subsonic-compat and transcoding extensions correctly

Tests

All 37 Subsonic API tests passing (36 pass + 1 intentionally skipped)

1.0.1 — May 23, 2026

Flacify.Server — Album Pagination

Albums page (/albums) now paginated server-side — no longer loads all 2000+ albums into memory
Page size selector (20/50/100), prev/next + page number navigation with ellipsis
Sort (Title/Artist/Year/Recently Added) and genre filter applied in SQL, not client-side
Current page button visually highlighted with primary class

Flacify.Server — No Startup Scan

Removed await RunScan() from FileWatcherService.ExecuteAsync — server starts instantly without scanning
Scans only trigger on file changes (watcher) or manual startScan endpoint
Scans and enrichment disabled in Testing environment — tests no longer contaminated with real music data

Flacify.Server — Admin Gate

IsAdminAsync helper on SubsonicController — reusable for admin-only endpoints
startScan now returns Subsonic error 50 ("User is not authorized") for non-admin users

Flacify.Server — Subsonic Fixes

offset parameter in getAlbumList/getAlbumList2 wired up for all list types
getSimilarSongs2 now returns <similarSongs2> element (was incorrectly returning <similarSongs>)
getArtist now returns <album> children (was returning <child>)

Fixes

EF Core LINQ translation errors in all album list queries — replaced entity projection (.Select(a => new Album { Artist = a.Artist })) with anonymous type + manual mapping; no CoverArt loaded in list queries, no translation failures
GetAlbumByReleaseGroupIdAsync, GetTopPlayedAlbumsAsync, GetHomeStatsAsync — same projection fix
GetArtistByIdAsync — added .Include(a => a.Albums)
UpdateArtistAsync and UpdateAlbumAsync no longer use DbSet.Update() (which writes all columns, potentially overwriting enriched data with nulls). Now only writes fields that actually changed — enrichment data (Biography, CoverArt, ReleaseType, etc.) can never be overwritten by a rescan
All 36 Subsonic API tests passing (35 pass, 1 intentionally skipped)

1.0.0 — May 21, 2026

Flacify.Console

Ripper now writes DISCNUMBER Vorbis comment tag during rip
Ripper now writes MUSICBRAINZ_ARTISTID tag (artist MBID in addition to album MBID)

Flacify.Server — Audio Analysis & Tagging

Scanner reads MUSICBRAINZ_ARTISTID from FLAC file tags; sets Artist.MusicBrainzId directly without API lookup
Scanner treats missing DISCNUMBER tag (0) as null, allowing directory-based disc number fallback
Album enrichment now also stores MusicBrainzReleaseGroupId for matching
Album enrichment skips already-enriched albums (MusicBrainzLastQueried guard)
Artist enrichment only runs for artists still missing bio or cover art (not every scan)

Flacify.Server — Play Tracking

Song PlayCount incremented on each Subsonic stream call
Listening history table records (SongId, UserId, PlayedAt) per play
Recently played page (/history) — last 50 plays
Most played page (/popular) — top 50 songs by play count
Album detail: Plays column per track, top 3 most-played songs get gold 1/2/3 badges
Frequent albums sorted by sum of song play counts (not song count)
playCount attribute in Subsonic XML

Flacify.Server — Radio Stations

Savable stations with dynamic filter parameters (genre, decade, artist, popular, unplayed, recently added, starred)
Subsonic integration: stations appear as playlists (rs- prefix), return 50 dynamically-generated songs
Web UI at /radio: create/edit/delete stations with multi-select filter builder
Continuous playback with auto-advancing queue, skip and stop controls
Per-user scoping: stations owned by the logged-in user; global stations visible to all

Flacify.Server — Starring / Favorites

UserFavorite table: starrable songs, albums, and artists per user
Subsonic star / unstar / getStarred / getStarred2 endpoints wired
Star toggles on album detail (per track + album header) and artist detail
Star indicators shown on Albums list and Artists list pages
Radio filter starred: true — filter to user's favorite songs

Flacify.Server — Artist Discography

ArtistReleases table stores MusicBrainz release groups per artist with cover art
Auto-sync from MusicBrainz on artist page load (cached 30 days)
Cover art fetched from Cover Art Archive in parallel
Discography table on /artist/{id} grouped by type (Albums, EPs, Singles, Compilations, Live)
Owned releases show local cover art; missing releases show CAA-fetched covers
Smart filtering: shows owned albums, missing studio albums, and missing live albums
Background sync: page loads instantly, discography appears after API response

Flacify.Web

Changelog page at /changelog
Footer text fixed (removed stale GitHub link, now reads "Source available locally")

Flacify.Server — Stats Dashboard

New homepage at / with library overview: albums, artists, songs, plays, hours of music, disk usage
Recently played (global), most played songs, most played albums
Latest additions with cover art thumbnails
Albums page moved to /albums
Scan button moved to Settings page
Repository aggregate methods for all stats queries

Flacify.Server — Genre Normalization

Replaced JSON-in-textfield genres with proper AlbumGenre table and navigation collection
Genre matching in radio filters, album lists, and Subsonic responses uses direct SQL joins — no more ILike on JSON strings
Fixed "Rap" matching "Rap Metal" bug permanently

Flacify.Server — Playlist & Queue System

"Queue" is now a persistent playlist backed by the database, shared across devices
CurrentIndex column on Playlist tracks playback position cross-session
Playlist selector dropdown in Player — switch between Queue and any other playlist
Queue modes: Don't loop / Loop / Remove after play
Queue capped at 200 items to prevent performance issues
Add to Queue (+ Queue) and Add to Playlist (+ Playlist) buttons throughout the UI
Playlist picker modal with dropdown select
Remove songs from playlists on the new /playlist/{id} detail page

Flacify.Server — Custom Web Player

Replaced native <audio controls> with hidden audio + custom controls
Previous/Play-Pause/Skip buttons, draggable seek bar with visible thumb, draggable volume bar
Time sync stays purely in JavaScript — no Blazor calls during playback
Expanded queue view shows first 20 items with "...and X more"
Click any queue item to jump to and play that song

Flacify.Server — Subsonic Endpoints

New: getLicense, scrobble, download, startScan
New: getAlbumList2, getArtists, getSongsByGenre, getSimilarSongs/getSimilarSongs2, getTopSongs
Filled stubs: getArtistInfo (biography, similar artists), getAlbumInfo (MusicBrainz ID, release date)
Legacy search (v1) added as wrapper around search2/search3
search2/search3 refactored into shared DoSearchAsync helper
cache-control headers on cover art, artist images, and release images (24h browser cache)

Flacify.Web

Changelog page at /changelog
Footer text fixed (removed stale GitHub link, now reads "Source available locally")

Flacify.Console

Auto-detects non-audio disc formats (DVD, Blu-ray) from MusicBrainz — pre-excludes those tracks before rip with [DVD] tag in tracklist
EscapeTag no longer escapes apostrophes (fixed It\'s → It's)
Track exclusion: press X in dashboard to toggle, excluded tracks are filtered out on rip

Fixes

Albums nav link no longer stays highlighted on every page (NavLinkMatch.All)
Discography cover art now shows local album art for owned releases instead of CAA thumbnail
Release group matching uses title-only fallback when year differs
Concurrent DbContext access fixed: OnAfterRenderAsync uses factory-created fresh context
Artist enrichment no longer fires API calls for every artist on every scan
EF Core cartesian explosion warning fixed — AsSplitQuery() on queries with multiple collection includes
GetAllAlbumsAsync no longer loads all Song rows (uses SongCount column instead)
Subsonic JavaScriptStringEncode removed from URL passing — was mangling & in stream URLs
Player setupPlayer now polls for DOM element existence instead of relying on firstRender