This project is a customized, modified fork of Nuclear. I originally built these custom features (like the Pomodoro timer, listening statistics recap, and artist/genre blocks) for my own personal use, and decided to make the repository public under the original AGPL-3.0 license so others can use and enjoy them too.
Based on Nuclear, originally licensed under the GNU Affero General Public License v3.0. Modified in 2026.
Fusion adds several productivity, moderation, and personalization features to the standard Nuclear player:
- Where to find it: Located at the bottom of the left sidebar.
- How to use: Click the timer to start or pause. Click the reset icon to start over. Use the settings gear icon to customize work and break intervals, toggle ticking/chime sound effects, and choose preset times.
- Where to find it: Click Recap & Filters in the left sidebar.
- How to use: Displays detailed statistics of your listening habits:
- Total plays and total listening time.
- Your top 5 artists and top 5 tracks.
- Hourly routines (Morning vs Night) and weekly listening trends.
- Scrollable list of recent plays with a "Clear History" button.
- Where to find & use:
- On Artist Pages: Click the
Banicon next to the Favorite heart button to block or unblock that artist. - On Recap & Filters: Go to the Artist & Genre Filters tab. Type any artist or style/genre name to block them manually.
- On Artist Pages: Click the
- Behavior: Any queued track featuring a blocked artist or containing a blocked genre/tag is automatically skipped during playback.
- Where to find it: Click Lyrics in the left sidebar, or press the microphone icon in the player bar.
- How to use: Lyrics are fetched automatically from lrclib.net for the current track. Synced lyrics auto-scroll karaoke-style as the song plays; plain text lyrics are shown when timing data is unavailable. A live mini waveform is displayed alongside the artwork.
- Where to find it: Click Visualizer in the left sidebar, or press the waveform icon in the player bar.
- Modes:
- Spectrum — 72-bar frequency analyzer with falling peak indicators and a purple/cyan gradient.
- Oscilloscope — real-time waveform with glow effect.
- Supports fullscreen via the expand button. Controls fade in on hover while in fullscreen.
- Where to find it: Click the + icon on the currently playing track in the player bar.
- How to use: Add the current track to any existing playlist, or create a new named playlist on the fly.
- Where to find it: Go to Themes in the left sidebar, then click Edit on any theme.
- How to use: Write or paste custom CSS overriding theme variables and preview the result live. Themes are saved per-name and can be deleted.
- Pre-configured with high-uptime HTTPS radio servers to avoid mixed-content web view blocks.
- Playlists can be imported using your local Floorp browser cookies configuration.
- Rebranded application window, app logo, and launcher name to Fusion.
- Comes with the custom Plasma theme (violet/magenta palette) enabled as the default dark mode theme.
- New Matrix theme — dark green terminal aesthetic.
Nuclear comes with multiple built-in themes:
 |
 |
| Artist search | Album search |
 |
 |
| Playlists | Plugin store |
 |
 |
| Installed plugins | Preferences |
 |
 |
| What's new | Log viewer |
Since Fusion is a custom personal fork of Nuclear, you can build and run it from source.
Make sure you have Node.js, PNPM, and Rust/Cargo installed.
- Install project dependencies:
npx pnpm install
- Build the application:
npx pnpm build
Once completed, the compiled binary will be available in:
packages/player/src-tauri/target/release/nuclear-music-player
If you are looking for the original, unmodified, and official pre-built releases of Nuclear, please visit the Official Nuclear Releases Page.
- Search for music and stream it from any source
- Browse artist pages with biographies, discographies, and similar artists
- Browse album pages with track listings
- Queue management with shuffle, repeat, and drag-and-drop reordering
- Favorites (albums, artists, and tracks)
- Playlists (create, import, export, import from varous services)
- Powerful plugin system with a built-in plugin store
- Themes (built-in and custom CSS themes)
- MCP server lets your AI agent drive the player
- Auto-updates
- Keyboard shortcuts
- Localized in multiple languages
Nuclear has a powerful plugin system now! Every functionality has been redesigned to be driven by plugins.
Plugins can provide streaming sources, metadata, playlists, dashboard content, and more. Browse and install plugins from the built-in plugin store, or write your own using the @nuclearplayer/plugin-sdk.
You can enable the MCP server in Settings → Integrations.
Then to add it to Claude Code:
claude mcp add nuclear --transport http http://127.0.0.1:8800/mcpCodex CLI:
codex mcp add nuclear --url http://127.0.0.1:8800/mcpOpenCode:
{
"mcp": {
"nuclear": {
"type": "remote",
"url": "http://127.0.0.1:8800/mcp"
}
}
}Claude Desktop / Cursor / Windsurf:
{
"mcpServers": {
"nuclear": {
"url": "http://127.0.0.1:8800/mcp"
}
}
}The MCP is designed to be discoverable, but there's a skill you can load to get your AI up to speed: Nuclear MCP Skill
Nuclear is a pnpm monorepo managed with Turborepo. The main app is built with Tauri (Rust + React).
- Node.js >= 22
- pnpm >= 9
- Rust (stable)
- Platform-specific Tauri dependencies (see Tauri docs)
git clone https://github.com/nukeop/nuclear.git
cd nuclear
pnpm install
pnpm devpnpm dev # Run the player in dev mode
pnpm dev:remote # Same, but binds Vite to 0.0.0.0 so you can open the remote control UI from other devices on your LAN
pnpm build # Build all packages
pnpm test # Run all tests
pnpm lint # Lint all packages
pnpm type-check # TypeScript checks
pnpm storybook # Run StorybookAGPL-3.0. See LICENSE.