v0.1.0-alpha.6

Docker Installation

docker pull ghcr.io/seethroughlab/familiar:v0.1.0-alpha.6

See the installation guide for detailed setup instructions.

Full Changelog: v0.1.0-alpha.5...v0.1.0-alpha.6

v0.1.0-alpha.5 - External Tracks & Offline

External Tracks & Offline (Jan 25)

Added

• Missing Track System - first-class support for tracks you want but don't have locally
  • External Tracks model for storing metadata
  • Mixed playlists (local + external tracks)
  • Visual distinction (75% opacity, "Not in library" label)
  • Preview playback (30-second previews from Spotify/Deezer)
  • Purchase links (Bandcamp, Spotify, Last.fm)
  • Auto-matching when adding tracks to library
  • Wishlist playlist for tracks you're interested in
• Spotify playlist import with automatic local/external track splitting
• External track matching service (ISRC, exact, partial, fuzzy matching)
• LLM tools for Spotify playlists (list, get tracks, import)
• Downloads view for browsing downloaded/offline tracks
• Downloaded-only filter for Library, Smart Playlists, and Regular Playlists
• useDownloadedTracks hook

Changed

• Playlist API responses include external track counts
• Unified PlaylistTrackItem type with type discriminator
• Discovery components support "Add to Wishlist" action

v0.1.0-alpha.4 - Playback & Mobile

Playback & Mobile (Jan 15-23)

Added

• Non-Places visualizer enhancements (glowing objects, shadows, swaying plants)
• Rain Window visualizer for ambient music
• Import quality comparison for duplicate detection
• AcoustID result caching in database
• Shuffle All for large libraries with lazy queue system
• get_similar_artists_in_library LLM tool
• README tools reference section
• Audio Effects Panel (EQ, Compressor, Reverb, Delay, Filters)
• Debug Settings panel in Developer section

Changed

• Comprehensive mobile layout audit (26 components fixed)
• Unified shuffle via global toggle
• Unified Discovery Section across all views
• Improved album artwork fallbacks
• Filtered Last.fm placeholder images
• URL state persistence (playlists, visualizer, tabs)
• Non-Places object distribution weighted toward glowing objects

Fixed

• Visualizer stability (useEffect dependency bug)
• Plant frond rotation direction
• Playlist detail overflow on mobile
• Track skipping race condition during queue changes
• iOS background playback with hybrid audio mode

v0.1.0-alpha.3 - Discovery & Metadata Intelligence

Discovery & Metadata Intelligence (Jan 11-14)

Added

• Ego-centric Music Map with redesigned artist similarity visualization
• 3D Explorer audio previews with crossfade transitions
• Proactive album art downloading in background
• Background jobs status indicator in header
• "Explore Similar Artists" context menu item
• Proposed Changes system for metadata corrections
• Proposed Changes indicator in header bar
• Album/artist name normalization for consistent matching
• Duplicate artist detection LLM tools
• Proposed Changes as main view (accessible from Library browser)
• Semantic search for natural language music queries via CLAP

Changed

• Music Map uses ego-centric layout instead of UMAP projection
• Artwork fetch order - Last.fm checked first
• Background Jobs indicator shows queue count
• Bulk change display shows unique values instead of raw JSON

Fixed

• Broken image placeholders in Music Map and 3D Explorer
• Header popover z-index stacking
• Settings page crash from API responses
• Proposed Changes API endpoint trailing slash

v0.1.0-alpha.2 - Infrastructure & Library UX

Infrastructure & Library UX (Jan 4-9)

Added

• Memory tracking in analysis subprocess for debugging OOM issues
• Split analysis into separate phases for better memory efficiency (peak reduced from ~5GB to ~3GB)
• Updated sync UI to show 4 phases: Discover → Read → Features → Embeddings
• Artist images in library browser with fallback chain (Last.fm → Spotify → album artwork)
• Infinite scroll for all library views (Artists, Albums, Tracks)
• View persistence - app remembers your selected library view
• Track metadata editing with tabbed modal (Basic, Extended, Sort, Lyrics, Analysis)
• Context menu everywhere (player bar, full player, artist detail, favorites, playlists, library browser)
• Auto-enrich metadata when viewing artist detail page

Changed

• Default library view changed from Tracks to Artists
• Artists view redesigned as visual grid with artwork
• Skip tracks shorter than 30s or longer than 30min during analysis
• Extended Track database model with new metadata fields
• Improved MusicBrainz release selection

Fixed

• Rate-limited ProcessPoolExecutor recreation
• Increased file descriptor limit for bulk analysis
• Stale sync lock detection
• Compilation album duplication
• Process pool stability during analysis
• URL persistence for tabs and artist detail

v0.1.0-alpha.1

Docker Installation

docker pull ghcr.io/seethroughlab/familliar:v0.1.0-alpha.1

See the installation guide for detailed setup instructions.

Full Changelog: https://github.com/seethroughlab/familliar/commits/v0.1.0-alpha.1