Repository navigation
Releases: synced7x7/SyncedX-Music-Player
Release list
Simple Music Player v1.0.0
SMP v1.0.0
Date: Nov 5, 2025
This marks the finalstable and fully polished release of Simple Music Player (SMP).
Focused on design refinement, UI consistency, and smoother performance across all modules.
Supports mp3, flac, m4a, wav
New Features
- Custom window buttons replacing default system controls
- Curved progress bar with modern, minimal design
- Notification system for exception and progress handling
- Force reload field for handling permanent song deletions
- Smooth volume fade-in during every song change
- Main album cover fade transition
- Local database integration for persistent data
- Persistent silhouette toggle for aesthetic customization
- Easter eggs added
UI Improvements
- Fully repolished Library, Now Playing, and Playlist screens
- Updated context menus and dropdowns for consistency
- Refined loading directory UI and smoother scroll animations
- Redesigned lyrics field with better layout and readability
- Playlist menu made more convenient and responsive
- Song details card and other interface elements visually enhanced
Fixes and Enhancements
- Multiple selection in list view fixed and improved
- Favorites icon and library selection bugs resolved
- Sorting and filtering reliability improved
- UI glitches and spacing inconsistencies removed
- General performance and stability improvements
How to Run
⚠️ Requires Java 25 or later (not bundled with the installer).
-
Install Java 25 or later (Recommended: Azul Zulu OpenJDK 25 (LTS)).
-
Make sure Java is installed and added to your PATH.
-
You can verify by running this command in Command Prompt:
java --version
It should show something like:
openjdk 25 2025-09-16 LTS OpenJDK Runtime Environment Zulu25.28+85-CA (build 25+36-LTS) OpenJDK 64-Bit Server VM Zulu25.28+85-CA (build 25+36-LTS, mixed mode, sharing)
-
-
Install all the fonts given in the zip file to get the desired and original UI.
-
Download and extract the latest release
.zip. -
Run
Simple_Music_Player_0.2.0.exe. -
Select your music directory and enjoy synced lyrics in real time! 🎶
Screenshots
Developed with care, precision, and obsession for performance.
— SyncedX
Simple Music Player v0.5.5
🎧 Simple Music Player v0.5.5 — “Synced X Mode & Real-Time Spectrum”
Release Date: October 30, 2025
This update brings real-time audio visualization, improved lyrics support, and smoother file handling. It also introduces multiple selection, command-line integration, and the new Synced X Mode for advanced lyric synchronization.
✨ New Features & Enhancements
🔊 Real-Time Audio Spectrum
- Added Real-Time Audio Spectrum Visualizer with live frequency bars.
- Optimized placement and rendering for accurate visual response.
- Visualizer can now be toggled ON/OFF anytime during playback.
🧩 Synced X Mode
- Introduced Synced X Mode, lyric Syncing mode with audio spectrum and line by line lyrics
- Fixed WAV lyric handling — full lyric support now available for both MP3 and WAV formats.
🖱️ Multiple Selection
- Added Multiple Selection Mode in the Library for batch operations.
- Enables removing, queuing, or managing multiple tracks simultaneously.
💻 Command-Line Integration
-
Added Command-Line Argument Support:
- Double-click any compatible audio file (e.g.,
.mp3,.wav,.flac,.m4a) to open it directly with SMP.
- Double-click any compatible audio file (e.g.,
🔄 Library Refresh & Stability
- Added Force Refresh Library option to rebuild or update metadata fields.
- Adjusted internal logic for directory switching and refresh consistency.
- General bug fixes related to refresh state management (no major structural changes).
🐞 Bug Fixes
- Fixed WAV lyrics loading issue and mismatched lyric timing.
- Corrected audio spectrum positioning on various screen sizes.
- Minor directory refresh and field update inconsistencies resolved.
⚙️ How to Run
⚠️ Requires Java 25 or later (not bundled with the installer).
-
Install Java 25 or later (Recommended: Azul Zulu OpenJDK 25 (LTS)).
-
Make sure Java is installed and added to your PATH.
-
You can verify by running this command in Command Prompt:
java --version
It should show something like:
openjdk 25 2025-09-16 LTS OpenJDK Runtime Environment Zulu25.28+85-CA (build 25+36-LTS) OpenJDK 64-Bit Server VM Zulu25.28+85-CA (build 25+36-LTS, mixed mode, sharing)
-
-
Download and extract the latest release
.zip. -
Run
Simple_Music_Player_0.2.0.exe. -
Select your music directory and enjoy synced lyrics in real time! 🎶
📷 Screenshots
Developed with care, precision, and obsession for performance.
— SyncedX
Simple Music Player v0.3.0
🎧 Simple Music Player v0.3.0 — File Management Focus
Release Date: October 28, 2025
This release focuses on enhanced file and library management, allowing users to manage songs more safely and efficiently.
✨ New Features & Improvements
🗂️ Song Info
-
View detailed song information:
- Song Name (clickable to open folder location)
- Title, Artist, Album, Genre, Year, Format, Duration, Quality, Size, Date Added, Play Count
-
File size now displayed in song details
📂 File & Library Management
-
Open File Location for songs directly from the interface
-
Remove Song Options:
- Remove from library/database
- Remove from playlist (all copies or specific playlist)
- Physically delete the file
-
Safe Delete Mechanism: Automatically removes corrupted or missing songs without breaking library consistency
-
Unicode & Language Handling: Automatically renames songs with unrecognized characters using a timestamp-based safe name and updates the database to prevent inconsistencies
🔄 Library Refresh & Updates
- Refresh library to detect updated or new songs
- Update songs in song table, playlist table, and currently playing track
- Update play count after playback
- Remove duplicates in playlists
- Hide library columns in menu if needed
🎵 Queue Enhancements
- Queue label in song list view shows the number of times a song is queued
- Duplicate detection and removal in queue supported
🛠️ UI & Stability Improvements
- Loading directories now shows a progress bar
- Focus and filtering bugs in song list view fixed
- Compact mode available: hide library and album cover FXML for a minimal player view
- Sorting rows now stable when changing directories
⚙️ How to Run
⚠️ Requires Java 25 or later (not bundled with the installer).
-
Install Java 25 or later (Recommended: Azul Zulu OpenJDK 25 (LTS)).
-
Make sure Java is installed and added to your PATH.
-
You can verify by running this command in Command Prompt:
java --version
It should show something like:
openjdk 25 2025-09-16 LTS OpenJDK Runtime Environment Zulu25.28+85-CA (build 25+36-LTS) OpenJDK 64-Bit Server VM Zulu25.28+85-CA (build 25+36-LTS, mixed mode, sharing)
-
-
Download and extract the latest release
.zip. -
Run
Simple_Music_Player_0.2.0.exe. -
Select your music directory and enjoy synced lyrics in real time! 🎶
📷 Screenshots
Developed with care, precision, and obsession for performance.
— SyncedX
Simple Music Player v0.2.0
🎧 Simple Music Player v0.2.0
Release Date: October 27, 2025
The second major release of Simple Music Player brings a leap forward in functionality, stability, and polish.
Version 0.2.0 introduces Synced Lyrics, expanded format support, persistent personalization features, and major database-level optimizations — making the player faster, smarter, and more musical than ever.
✨ Highlights
🎤 Synced Lyrics System
- Added time-synced lyrics integrated directly with the music visualizer.
- Supports both synchronized and unsynchronized (USLT tag) lyrics.
- Smooth lyric highlighting synced with playback position.
- Optimized lyric parsing pipeline for real-time updates with minimal CPU load.
🎧 Expanded Audio Format Support
- Added support for M4A, AAC, and FLAC file formats.
- Full compatibility with existing visualizer and metadata systems.
- Improved backend transcoding and error handling for new formats.
🎼 Queue & Playlist System
- Introduced Queue Mechanism for managing upcoming tracks.
- Added Persistent Playlists with add/edit/delete functionality.
- Favorites Playlist ❤️ — quickly favorite any song via right-click or the context menu.
- Each playlist now retains its own sorting, reverse, and shuffle preferences across sessions.
🔁 Persistent Preferences Everywhere
- Shuffle, Reverse, Sort Order, and Repeat Mode now persist between app launches.
- Player resumes from last played track and position when reopened.
- User preferences and playback state stored safely in SQLite.
📊 Performance & Optimization
- Massive memory reduction through database-backed virtualization.
- Switched from grid rendering to virtualized ListView, handling 100,000+ songs smoothly.
- Compressed thumbnails and WeakCacheMemory for ultra-efficient image loading.
- Optimized waveform visualization with buffered sample skipping and undersampling.
🖥️ UI & Experience Enhancements
- Added background covers in Now Playing and Library screens.
- Polished visualizer and volume control design.
- Context menus on song cards for quick actions.
- Improved search performance with SQL-based queries and playlist-specific results.
🧱 Architectural Improvements
- Fully migrated to SQLite-based architecture (replacing RAM-based data handling).
- Centralized DAO design for modular database interaction.
- Enhanced cross-controller communication between Library, Playback, and NowPlaying.
- Refined lyrics–music synchronization engine for consistent performance across formats.
🧩 Known Issues
⚠️ Requires Java 25 or later (not bundled with the installer). Please install it manually. See more details in the Installation section
- Limited UI customization options (planned for next update).
- Limited File Management
🛣️ Next Steps (v0.3.x Roadmap)
- 🎶 Custom Playlist Creation & Management UI
- 📝 Editable Metadata & Tag Editor
- 🌈 UI Improvement
- 🧠 Improved Error Handling for Missing Metadata
- ✨ Lightweight Lyrics Editor
⚙️ How to Run
-
Install Java 25 or later (Recommended: Azul Zulu OpenJDK 25 (LTS)).
-
Make sure Java is installed and added to your PATH.
-
You can verify by running this command in Command Prompt:
java --version
It should show something like:
openjdk 25 2025-09-16 LTS OpenJDK Runtime Environment Zulu25.28+85-CA (build 25+36-LTS) OpenJDK 64-Bit Server VM Zulu25.28+85-CA (build 25+36-LTS, mixed mode, sharing)
-
-
Download and extract the latest release
.zip. -
Run
Simple_Music_Player_0.2.0.exe. -
Select your music directory and enjoy synced lyrics in real time! 🎶
##📸Snapshot
Developed with care, precision, and obsession for performance.
— SyncedX
Simple Music Player v0.1.0
Simple Music Player v0.1.0 — Initial Public Release
This is the first public release of Simple Music Player — a lightweight, fast, and memory-optimized desktop music player built with JavaFX and SQLite.
Features
-
Local Library Management
-
Automatically scans and imports songs from a selected directory.
-
Displays songs in a scrollable, virtualized list with lazy loading to minimize memory usage.
-
Supports sorting by:
- Title
- Artist
- Album
- Length
- Date Added
-
Persistent sorting preferences across app restarts.
-
-
Playback System
-
Core playback powered by JavaFX MediaPlayer.
-
Next / Previous track navigation using internal playlist indexing.
-
Supports Shuffle Mode:
- Generates a shuffled playlist without duplicating data in memory.
- Shuffle state and playlist persist between app sessions.
-
Repeat Mode to automatically replay the current track when enabled.
-
-
Volume Control
- Integrated volume slider to control playback volume in real time.
-
Visualizer Service
- Audio visualizer service integrated with the playback engine (Optimized Version).
-
Memory Optimization
- Uses a WeakHashMap to cache compressed thumbnails and titles only.
- FXML cards are virtualized using ListView, significantly reducing RAM usage.
- Large libraries (100000+) songs supported smoothly.
Improvements & Architectural Decisions
- Shifted from static UI rendering to lazy loading through ListView for better performance.
- Added persistent shuffle mechanism by storing the shuffled playlist in the database.
- Introduced controller cross-access design (Library ↔ Playback ↔ NowPlaying).
- Centralized DAO structure for database operations.
- Refactored sorting to be handled via database queries rather than in-memory sorting.
- PCM is undersampled and optimized for efficient memory usage.
Known Issues
⚠️ Requires Java 25 or later (not bundled with the installer). Please install it manually. See more details in the Installation section
- Only support mp3 and wav file format
Next Steps (Planned for v0.2.x)
-
Playlist creation and management.
-
Better error handling for corrupted media files.
-
Lyrics features
-
Editable Tags
-
UI improvement
-
Support more audio file formats
How to Run
-
Install Java 25 or later (Recommended: Azul Zulu OpenJDK 25 (LTS)).
-
Make sure Java is installed and added to your PATH.
-
You can verify by running this command in Command Prompt:
java --version
It should show something like:
openjdk 25 2025-09-16 LTS OpenJDK Runtime Environment Zulu25.28+85-CA (build 25+36-LTS) OpenJDK 64-Bit Server VM Zulu25.28+85-CA (build 25+36-LTS, mixed mode, sharing)
-
-
Download and extract the latest release
.zip. -
Run
Simple_Music_Player_0.2.0.exe. -
Select your music directory and enjoy!
Snapshot
Developed with care and obsession for performance.
Simple_Music_Player_v0.00
v0.00 – Initial Release
Release Date: 2025-10-02
Overview
This is the initial release of Simple Music Player, a JavaFX-based desktop music player. The application supports playing MP3 and WAV files, displays song metadata including album art, and provides a visual waveform for the currently playing track.
Features
- Play, pause, next, and previous track controls.
- Visual waveform display of the currently playing song.
- Library view that automatically loads songs from a selected directory.
- Search library by title, artist, or album.
- Sort library by title, artist, album, duration, date added, or shuffle tracks.
- Clickable song cards to start playback.
- Directory chooser for selecting custom music folders.
Known Issues
⚠️ Requires Java 25 or later (not bundled with the installer). Please install it manually. See more details in the Installation section
- Performance: The app is unoptimized; may lag with large songs or large libraries (>100 songs).
- Memory Usage: Loading many songs with album art may consume significant memory.
- No playlists or persistent library: Library resets on restart.
- Limited formats: Only MP3 and WAV files supported.
Installation (WIN only)
-
Install Java 25 or later (Recommended: Azul Zulu OpenJDK 25 (LTS)).
-
Make sure Java is installed and added to your PATH.
-
You can verify by running this command in Command Prompt:
java --version
It should show something like:
openjdk 25 2025-09-16 LTS OpenJDK Runtime Environment Zulu25.28+85-CA (build 25+36-LTS) OpenJDK 64-Bit Server VM Zulu25.28+85-CA (build 25+36-LTS, mixed mode, sharing)
-
-
Download and extract the latest release
.zip. -
Run
Simple_Music_Player_0.2.0.exe. -
Select your music directory and enjoy!
Notes
- This is a pre-alpha release.
- Future updates will include performance improvements, playlist management, and support for additional audio formats.
##Snapshot
