freshcrate
Skin:/
Home > MCP Servers > nuclear

nuclear

Streaming music player that finds free music for you

Why this rank:Strong adoptionRecent releaseHealthy release cadence

Description

Streaming music player that finds free music for you

README

Nuclear Music Player

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 Music Player - Dashboard

Nuclear comes with multiple built-in themes:

Green theme Aqua theme Mint theme

Orange theme Red theme Violet theme

Search artists Search albums
Artist search Album search
Playlists Plugin store
Playlists Plugin store
Installed plugins Preferences
Installed plugins Preferences
What's new Log viewer
What's new Log viewer

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 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

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

Codex CLI:

codex mcp add nuclear --url http://127.0.0.1:8800/mcp

OpenCode:

{
  "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

Development

Nuclear is a pnpm monorepo managed with Turborepo. The main app is built with Tauri (Rust + React).

Prerequisites

  • Node.js >= 22
  • pnpm >= 9
  • Rust (stable)
  • Platform-specific Tauri dependencies (see Tauri docs)

Getting started

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 build          # Build all packages
pnpm test           # Run all tests
pnpm lint           # Lint all packages
pnpm type-check     # TypeScript checks
pnpm storybook      # Run Storybook

Community

License

AGPL-3.0. See LICENSE.

Release History

VersionChangesUrgencyDate
player@1.39.0## What's New in v1.39.0 - **Feature**: The window now remembers its size, position, and maximized state between restarts `UI` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High6/1/2026
player@1.38.0## What's New in v1.38.0 <p align="center"> <picture> <img width="640" height="216" alt="jam-update-banner" src="https://github.com/user-attachments/assets/50e74e23-dc88-45c4-9d5c-d21d731aa651" /> </picture> <p align="center"> **Nuclear Jam** is your mobile remote control for Nuclear. It lets you control Nuclear from any device with a web browser. Pull out your phone, scan a QR code, and you can control playback and see the queue. Handy for parties, cooking, your housemates, and so oHigh5/29/2026
player@1.37.4## What's New in v1.37.4 - **Fix**: Fix HLS tracks getting stuck at 0:00 when the queue advances `Streaming` - @nukeop - **Fix**: Fix tracks failing to play in saved playlists and in queues restored after restart by re-resolving stream URLs when they expire `Streaming` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High5/22/2026
player@1.37.3Nuclear Player release v1.37.3 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High5/13/2026
player@1.36.0## What's New in v1.36.0 - **Feature**: MPD server lets you control Nuclear from MPD clients like mpc and ncmpcpp `Integrations` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High5/11/2026
player@1.35.0## What's New in v1.35.0 - **Feature**: Installed plugins are automatically updated to the latest version on startup `Plugins` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High5/4/2026
player@1.34.1## What's New in v1.34.1 - **Fix**: Fix legacy playlist import failing when track durations use mm:ss or hh:mm:ss format `Playlists` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High4/22/2026
player@1.34.0## What's New in v1.34.0 - **Fix**: Fix source selection being reset to the first available provider on startup `Plugins` - @nukeop - **Fix**: Show an empty state in Sources when no providers of a given kind are installed `UI` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High4/17/2026
player@1.33.3Nuclear Player release v1.33.3 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High4/15/2026
player@1.33.2Nuclear Player release v1.33.2 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.High4/9/2026
player@1.33.1Nuclear Player release v1.33.1 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium4/8/2026
player@1.33.0## What's New in v1.33.0 - **Feature**: Streaming providers can now access full track metadata when resolving streams `Plugins` - @nukeop - **Fix**: Fix paired streaming provider not activating when registered after the metadata provider `Plugins` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium4/8/2026
player@1.32.1Nuclear Player release v1.32.1 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium4/3/2026
player@1.32.0## What's New in v1.32.0 - **Feature**: Frameless window toggle in settings `UI` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium4/2/2026
player@1.31.0Nuclear Player release v1.31.0 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium4/1/2026
player@1.30.0## What's New in v1.30.0 - **Feature**: Theme store for browsing and installing community themes `Themes` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium4/1/2026
player@1.29.1Nuclear Player release v1.29.1 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium3/27/2026
player@1.29.0## What's New in v1.29.0 - **Feature**: Discord rich presence integration `Integrations` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium3/27/2026
player@1.28.0## What's New in v1.28.0 - **Feature**: Plugins can provide music discovery recommendations based on the current queue `Plugins` `Playback` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium3/26/2026
player@1.27.0Nuclear Player release v1.27.0 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium3/25/2026
player@1.26.0Nuclear Player release v1.26.0 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium3/24/2026
player@1.25.1Nuclear Player release v1.25.1 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium3/24/2026
player@1.24.1Nuclear Player release v1.24.1 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Medium3/23/2026
player@1.24.0## What's New in v1.24.0 - **Improvement**: Nuclear is now built from source for Flatpak, with new app icons `Linux` - @nukeop - **Fix**: Fixed album tracks being added to the queue without thumbnails `Queue` - @nukeop - **Improvement**: Dashboard, search, and plugins views now prompt to install plugins when none are active `Plugins` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Low3/21/2026
player@1.23.3## What's New in v1.23.3 - **Improvement**: AUR packages are now automatically updated when a new release is published `Linux` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Low3/18/2026
player@1.23.2Nuclear Player release v1.23.2 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Low3/16/2026
player@1.23.1Nuclear Player release v1.23.1 > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Low3/16/2026
player@1.23.0## What's New in v1.23.0 - **Feature**: New Sources view lets you switch the active metadata and streaming providers from the sidebar `Sources` - @nukeop - **Improvement**: yt-dlp is now downloaded and updated automatically at runtime, fixing Flatpak and AppImage compatibility `Playback` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Low3/16/2026
player@1.22.0## What's New in v1.22.0 - **Improvement**: yt-dlp is now downloaded and updated automatically at runtime, fixing Flatpak and AppImage compatibility `Playback` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Low3/13/2026
player@1.21.0## What's New in v1.21.0 - **Feature**: Border width is now themable - advanced themes can set border-width to control all borders in the app `Themes` - @nukeop - **Improvement**: Improved dark mode for all basic themes with better backgrounds, toned-down primaries, and themed borders `Themes` - @nukeop > **macOS:** If the app won't open, run `sudo xattr -r -d com.apple.quarantine /Applications/Nuclear.app` in Terminal.Low3/13/2026
player@1.20.0Nuclear Player release v1.20.0Low3/12/2026
player@1.19.1Nuclear Player release v1.19.1Low3/12/2026
player@1.19.0## What's New in v1.19.0 - **Feature**: Social links in settings sidebar (Discord, GitHub, Mastodon, Website) `Settings` - @nukeop - **Fix**: Fixed repeat, shuffle, and volume for MSE streams `Playback` - @nukeopLow3/9/2026
player@1.18.0## What's New in v1.18.0 - **Feature**: Plugins can import YouTube playlists by URL via yt-dlp `Playlists` `Plugins` `YouTube` - @nukeopLow3/7/2026
player@1.17.0## What's New in v1.17.0 - **Fix**: YouTube tracks now play using MSE-based streaming, fixing incorrect duration display and enabling proper seeking `Playback` `Streaming` - @nukeopLow3/6/2026
player@1.16.0## What's New in v1.16.0 - **Feature**: Customizable keyboard shortcuts with settings UI for rebinding `Settings` `Playback` - @nukeopLow3/5/2026
player@1.15.0## What's New in v1.15.0 - **Feature**: Plugin event bus with trackFinished and trackStarted events `Plugins` - @nukeop - **Feature**: Custom settings widgets for plugins (render React components in settings UI) `Plugins` - @nukeop - **Feature**: Shell API for plugins to open URLs in the system browser `Plugins` - @nukeop - **Feature**: Plugins can use Nuclear UI components (Button, Toggle, etc.) `Plugins` - @nukeop - **Fix**: Fixed plugin settings using wrong storage key (core prefix instead oLow3/4/2026
player@1.14.0Nuclear Player release v1.14.0Low3/3/2026
player@1.13.0Nuclear Player release v1.13.0Low3/2/2026
player@1.12.0Nuclear Player release v1.12.0Low3/1/2026
player@1.11.1Nuclear Player release v1.11.1Low2/28/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

metorial-platformThe engine powering hundreds of thousands of MCP connections 🤖 đŸ”Ĩdev@2026-06-06
studioOpen-source control plane for your AI agents. Connect tools, hire agents, track every token and dollarv2.396.1
mcp-ts-coreAgent-native TypeScript framework for building MCP servers. Build tools, not infrastructure.v0.10.0
apify-mcp-serverThe Apify MCP server enables your AI agents to extract data from social media, search engines, maps, e-commerce sites, or any other website using thousands of ready-made scrapers, crawlers, and automav0.10.12
mcp-searxngMCP Server for SearXNGv1.1.0

More in MCP Servers

AstrBotAgentic IM Chatbot infrastructure that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
agentscopeBuild and run agents you can see, understand and trust.
claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.
langchain4jLangChain4j is an open-source Java library that simplifies the integration of LLMs into Java applications through a unified API, providing access to popular LLMs and vector databases. It makes impleme