BlackMusic v2.0.0

The first public release of BlackMusic.

BlackMusic is a desktop music player built around your own music library, with support for bringing selected streaming services alongside your local collection. This release marks the first public version of the rebuilt BlackMusic application, now running on Tauri 2 + React + TypeScript.

Highlights

Local Music Library

• Add and manage watched music folders.
• Delta-based folder scanning to avoid unnecessary rescans.
• Cached track metadata for faster startup.
• Streamed scanning results instead of waiting for an entire library scan.
• Organize music by albums, artists, playlists, and favorites.
• Sort and filter local tracks.

Playback

• Unified playback experience across supported sources.
• Persistent global now-playing bar.
• Full-screen Playground theater view.
• Album artwork and playback information.
• Playback seeking, volume, speed, and looping controls.
• Loop sections for practicing specific parts of a song.
• Mixed local/online playback queue handling.

Streaming Services

• Spotify integration with OAuth.
• Audius integration.
• Service switching directly from the application.
• Spotify playback through Spotify's Web Playback SDK.
• Last.fm integration for optional album-art enrichment.

Spotify playback requires a Spotify Premium account because of Spotify's Web Playback SDK requirements.

Application Architecture

BlackMusic 2.0.0 has been rebuilt from the previous Electron/plain-HTML architecture into:

• Tauri 2 for the desktop application shell.
• Rust for native application functionality.
• React 18 for the interface.
• React Router 6 with hash-based routing.
• TypeScript throughout the application.
• Plain CSS with a centralized design-token system.
• pnpm for dependency management.

Reliability Improvements

This release also includes several important fixes discovered during development:

• Fixed preferences not persisting between application launches.
• Fixed playback state problems when switching between local and online sources.
• Fixed Windows folder path handling by using platform-aware path joining.
• Improved Last.fm enrichment performance through batching.
• Improved folder scanning with cached and delta-based scanning.
• Improved UI responsiveness by streaming scan results in batches.

Current Limitations

This release is intentionally focused on the core desktop music-player experience.

The following features are not yet implemented:

• YouTube Video Mode.
• YouTube video downloading.
• Genius lyrics integration.
• GitHub, Google, Facebook, Tidal, Jamendo, TikTok, VK, MusicBrainz, and Amazon integrations.
• Spotify's native multi-track queue.
• Several of the original Folder view styles.

Some integrations require a server-side OAuth/token-exchange component to safely handle client secrets and are therefore not included in this release.

Security & Privacy

BlackMusic is designed around explicit service connections.

Third-party services are not contacted simply because the application is installed. Integrations such as Spotify, Audius, and Last.fm are used when enabled or connected by the user.

OAuth client secrets must not be placed in the client application's VITE_ environment variables because those values become recoverable from the distributed application.

For development and deployment, see:

• README.md
• DEVELOPMENT.md
• Security.md

Installation

Pre-built installers are provided with this release when available.

For developers or users building from source, see DEVELOPMENT.md for platform-specific requirements and build instructions.

Auto-Updater

The Tauri updater infrastructure is included in the application, but release signing and updater configuration must be completed with the project's production signing keys and GitHub Release workflow before automatic updates are enabled for production use.

Platform Support

This release is focused on desktop platforms:

• Windows
• macOS
• Linux

Tauri 2 also provides a path toward Android and iOS, but the mobile targets have not been fully tested with this codebase and are not considered supported targets for this release.

Known Development Notes

BlackMusic 2.0.0 represents a rebuilt application architecture rather than a fully completed implementation of every feature from the earlier application.

The goal of this release is to establish a stable foundation for the local music library, playback system, service integrations, and future development.

License

See the repository license and accompanying project documentation for licensing information.

---

BlackMusic 2.0.0 — First Public Release

Full Changelog: https://github.com/BlackBlazent/BlackMusic/commits/v2.0.0