Changelog

Track ChordMini's evolution with detailed release notes and feature updates.

v0.2.6

UI Revamp & Model Selection Improvements

Released
July 9, 2025

Major UI improvements with HeroUI component migration, streamlined model selection workflow, and enhanced user experience

Features

  • •UI: Migrated to HeroUI component library for better consistency and maintainability
  • •UI: Streamlined model selection workflow by removing redundant standalone model selection page
  • •UI: Enhanced embedded model selectors with improved accessibility (aria-labels and textValue props)
  • •UI: Fixed upload audio button styling with proper contrast and blue accent theme (#1e40af)
  • •UI: Improved API key management instructions with more concise Music.AI workflow setup guidance
  • •BACKEND: Fixed model selection API endpoint routing from direct backend calls to Next.js API routes
  • •BACKEND: Resolved status page localhost endpoint configuration issues

Core Changes

  • ⚠Removed /model-selection route - model selection is now embedded in analyze pages only

v0.2.5

Search UI Enhancements & Backend Port Update

Released
July 8, 2025

Enhanced search functionality with improved dropdown width, simplified result display, and backend port configuration update for macOS compatibility

Features

  • •UI: Expanded sticky search bar dropdown width to span full width of search input and upload button combined
  • •UI: Simplified search results display by removing view count and duration metadata
  • •UI: Fixed search results clearing bug when search input is emptied
  • •UI: Enhanced beat timeline visualization with improved proportional downbeat bars
  • •UI: Improved mini search box functionality in navigation bar with dropdown results and state synchronization
  • •BACKEND: Updated localhost backend URL from port 5000 to 5001 to avoid conflict with macOS AirDrop/AirTunes
  • •BACKEND: Centralized backend URL configuration through environment variables for better maintainability

Core Changes

  • ⚠Backend port changed from 5000 to 5001 - update local development environment accordingly

v0.2.4

Critical Stability & UI Fixes

Released
July 7, 2025

Essential fixes for React infinite loops, layout spacing issues, and production build optimizations

Features

  • •STABILITY: Fixed React "Maximum update depth exceeded" infinite loop errors in Lyrics & Chords tab
  • •STABILITY: Resolved circular dependencies in useScrollAndAnimation and LeadSheetDisplay components
  • •STABILITY: Eliminated duplicate beat tracking that caused state conflicts and crashes
  • •UI: Fixed excessive white space above "Analysis Results" title for better visual layout
  • •UI: Improved guitar chord diagram animation smoothness with reduced scale differences
  • •UI: Fixed musicAI.png image aspect ratio warning for proper rendering
  • •CLEANUP: Removed all console logging statements from guitar chord diagram functionality
  • •CLEANUP: Eliminated debug logs from chord parsing and pattern suffix mapping
  • •BUILD: Fixed TypeScript compilation errors and unused variable warnings

Core Changes

    v0.2.3

    Music.AI Caching & UI Polish

    Released
    July 7, 2025

    Critical fixes for Music.AI lyrics caching, React performance optimizations, and enhanced user interface with globe icon for translations

    Features

    • •CACHING: Fixed Music.AI lyrics caching to Firestore - no more expensive repeated API calls
    • •CACHING: Implemented unauthenticated public caching for ML model outputs (lyrics transcriptions)
    • •CACHING: Updated Firestore security rules to support safe public caching of transcription results
    • •PERFORMANCE: Fixed React "Maximum update depth exceeded" errors in lyrics & chord tab
    • •PERFORMANCE: Added proper memoization with useMemo and useCallback to prevent infinite re-renders
    • •PERFORMANCE: Optimized useEffect dependency arrays to eliminate unnecessary component updates
    • •UI: Added professional globe icon (🌐) to translate lyrics button with light/dark mode support
    • •UI: Enhanced visual consistency with custom SVG icon integration
    • •CLEANUP: Removed all remaining console logs with emoji prefixes for production-ready code
    • •CLEANUP: Eliminated debug logs from AnalyzePage, AudioProcessing, Metronome, and Auth services
    • •STABILITY: Fixed build issues with dynamic imports and improved error handling in cache routes

    Core Changes

      v0.2.2

      Performance Revolution & Metronome Redesign

      Released
      July 6, 2025

      Major performance optimizations with 90%+ improvements and complete metronome system redesign for professional-grade functionality

      Features

      • •PERFORMANCE: Beat-chord grid alignment optimization with two-pointer replacing brute force (90%+ improvement)
      • •PERFORMANCE: React component memoization reducing re-renders by 80-90%
      • •METRONOME: Complete redesign using pre-generated audio tracks for perfect synchronization
      • •METRONOME: 300% volume boost with 360% downbeat emphasis for clear audibility
      • •METRONOME: Perfect sync - starts from current playback position instead of restarting
      • •METRONOME: Continuous playback throughout entire song duration
      • •ANIMATION: Fixed critical regression where clicking chord cells froze beat tracking
      • •OPTIMIZATION: Binary search O(log n) beat tracking replacing O(n) algorithms
      • •OPTIMIZATION: Bundle size maintained at 438kB while adding significant functionality
      • •CLEANUP: Removed excessive console logging for cleaner development experience

      Core Changes

      • ⚠Metronome now uses pre-generated tracks instead of real-time scheduling
      • ⚠Legacy metronome scheduling methods deprecated but maintained for compatibility

      v0.2.0

      Guitar Chords Tab & Enhanced Music Analysis

      Released
      July 5, 2025

      Major feature release introducing interactive guitar chord diagrams with professional music notation

      Features

      • •NEW: Guitar Chords tab with interactive chord diagram visualization
      • •Animated chord progression view that adapts to your screen size
      • •Professional musical notation with proper sharp (♯) and flat (♭) symbols
      • •Enhanced chord recognition with support for complex chord types
      • •Smoother animations and improved visual experience
      • •Comprehensive credits section acknowledging open-source contributions

      Core Changes

      • ⚠Guitar Chords and Lyrics & Chords tabs marked as [beta] - features may evolve based on feedback

      v0.1.2

      Improved YouTube Audio Processing

      Released
      July 4, 2025

      Enhanced reliability and performance for YouTube audio extraction with better Unicode support

      Features

      • •Improved YouTube audio extraction with better reliability
      • •Enhanced support for international song titles and artist names
      • •Streamlined setup process for local development
      • •Better error handling and user feedback during audio processing
      • •Improved performance and stability for production deployments

      Core Changes

      • ⚠Local development now requires Python backend running on localhost:5001 (avoiding macOS AirTunes port 5000 conflict)

      v0.1.1

      Critical Bug Fixes & Performance Improvements

      Released
      July 2, 2025

      Resolved critical production issues affecting chord synchronization and performance warnings

      Features

      • •Fixed chord synchronization API failure (HTTP 400 errors) for direct file uploads
      • •Resolved 413 "Payload Too Large" errors for files >4MB in blob upload workflow
      • •Created new /api/synchronize-chords endpoint for direct chord-beat synchronization
      • •Enhanced service worker error handling to prevent console warnings
      • •Optimized resource preloading to eliminate unused preload warnings
      • •Achieved functional equivalence between YouTube and direct upload workflows
      • •Improved production console output with cleaner error handling
      • •Enhanced blob upload workflow with proper API contract matching
      • •Zero build warnings and clean compilation for production deployment

      v0.1.0

      Production Ready Release

      Released
      June 30, 2025

      Complete chord recognition and music analysis platform with AI assistance

      Features

      • •YouTube integration with audio extraction using yt-dlp
      • •Advanced chord recognition with multiple models (Chord-CNN-LSTM, BTC SL/PL)
      • •Beat detection using Beat-Transformer and madmom models
      • •Lyrics transcription and translation with Music.ai and Gemini APIs
      • •AI chatbot assistant with contextual music analysis
      • •Synchronized metronome with Web Audio API
      • •Dark/light mode theme support
      • •API key management with client-side encryption
      • •Firebase caching for analysis results and translations
      • •Karaoke-style lyrics with letter-by-letter synchronization
      • •Enharmonic chord correction with toggle functionality
      • •Lead sheet layout with professional music notation
      • •Dynamic chord grid visualization with beat alignment
      • •Multi-language lyrics translation support

      For technical details and API documentation, visit the API Documentation page.