Primary Purpose:
Nuclear is a free music streaming program designed to aggregate content from various sources across the internet, offering users a comprehensive platform for discovering and enjoying music without ads or accounts.
Key Features:
Multi-Platform Integration: Stream music seamlessly from YouTube, Jamendo, Audius, and SoundCloud.
Playlist Management: Create, save, and export playlists in JSON format for easy sharing and organization.
Scrobbling Support: Sync your listening activity with Last.fm to track your favorites and share your musical taste.
Radio Mode: Automatically curate similar tracks to keep the music flowing without interruption.
Offline Listening: Access your local library to enjoy your favorite tunes even without an internet connection.
Audience & Benefits:
Ideal for music enthusiasts seeking a free, ad-free experience with extensive content availability. Nuclear provides unparalleled access to a vast library of music streams across multiple platforms, ensuring you always have something new to discover or revisit.
Install Nuclear via winget and enjoy your favorite tunes effortlessly.
README
Nuclear
Nuclear is a free, open-source music player without ads or tracking. Search for any song or artist, build playlists, and start listening.
Runs on Windows, macOS, and Linux.
Screenshots
Nuclear comes with multiple built-in themes, with light and a dark modes:
Artist search
Album search
Track search with recent searches
Artist page
Album page
Favorites
Playlists
Playlist
Synced lyrics
Lyrics with furigana and translations
Listening history
Listening stats
Stream sources for a queued track
Plugin store
Installed plugins
Preferences
What's new
Log viewer
Control Nuclear from your phone with Nuclear Jam:
Download
Grab the latest release for your platform from the Releases page.
Platform
Formats
Windows
.exe installer, .msi
macOS
.dmg (Apple Silicon and Intel)
Linux
.AppImage, .deb, .rpm, .flatpak
Features
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 various 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
Plugins
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.
MCP
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/mcp
git clone https://github.com/nukeop/nuclear.git
cd nuclear
pnpm install
pnpm dev
Useful commands
pnpm 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 Storybook
