nuclear

Streams music from multiple free sources (YouTube, Jamendo, SoundCloud, Audius) through a pluggable provider architecture that abstracts source-specific APIs behind a unified interface. The plugin system allows providers to implement streaming, metadata fetching, and search independently, with the core player handling stream selection, quality negotiation, and playback state management across providers.

Indexes local music files on disk using a file-system scanner that detects audio formats (MP3, FLAC, OGG, etc.) and extracts embedded metadata (ID3 tags, Vorbis comments). The system enriches local metadata by querying external metadata providers (likely Last.fm, MusicBrainz) to fill gaps, normalize artist/album names, and fetch cover art, storing results in a local database for fast subsequent lookups.

Manages user preferences (playback settings, UI preferences, provider configuration) in a persistent local store, likely using JSON or SQLite. The settings system provides a typed interface for reading/writing preferences, with change notifications that trigger UI updates when settings are modified. Settings are organized hierarchically (player settings, provider settings, theme settings) and can be exported/imported for backup or migration.

Manages user-created playlists and collections stored in a local database with support for importing/exporting standard formats (M3U, PLS, JSON). The system maintains playlist state (track order, metadata, creation date) and provides hooks for import/export operations that transform between internal playlist schema and external formats, enabling interoperability with other music players.

Executes search queries against both local library and remote streaming providers, aggregating results from multiple sources and ranking them by relevance using heuristics (match quality, provider priority, popularity). The search system queries the local database for indexed tracks and simultaneously invokes provider search methods, then merges and deduplicates results before presenting to the UI.

Manages playback state (play, pause, seek, volume) and a dynamic queue of tracks from mixed sources (local + streamed). The playback engine handles stream selection from multiple providers, bitrate/quality negotiation, and queue manipulation (add, remove, reorder, shuffle, repeat modes). Built on Tauri's audio backend with Rust bindings for low-latency control and state synchronization between main and renderer processes.

Provides a TypeScript-based plugin SDK that allows developers to extend Nuclear with custom providers, themes, and features. Plugins are loaded dynamically at runtime via a plugin registry, with standardized interfaces for provider implementation (search, metadata, streaming), theme definition, and settings management. The plugin system includes a plugin store for discovering and installing community plugins.

Builds a lightweight desktop application using Tauri (Rust + React) that compiles to native binaries for Windows, macOS, and Linux. The architecture separates the Rust backend (audio handling, file I/O, system integration) from the React frontend (UI rendering), communicating via Tauri's IPC bridge. This approach reduces binary size and memory footprint compared to Electron while maintaining cross-platform compatibility.

Provides a translation system that allows the UI to be rendered in multiple languages. The i18n system loads language files (likely JSON or YAML) that map UI strings to translated text, with support for language switching at runtime without restarting the application. The architecture is abstracted into a separate @nuclearplayer/i18n package, enabling translations to be updated independently of core releases.

Allows users and developers to create custom themes that override the default UI styling. Themes are defined as CSS or JSON configuration files that specify colors, fonts, spacing, and component styles. The theme system is pluggable — themes can be installed via the plugin system and applied at runtime, with theme preferences persisted in user settings.

Exposes Nuclear's functionality as a Model Context Protocol (MCP) server, allowing AI agents and LLM-based tools to control playback, search, and manage playlists programmatically. The MCP server implements standard music player operations (play, pause, skip, search, queue management) as callable functions that agents can invoke, with structured input/output for reliable automation.