nuclear
Streaming music player that finds free music for you
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/nukeop/nuclear with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/nukeop/nuclear'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/nukeop--nuclear)HTML
<a href="/listings/nukeop--nuclear"><img src="/api/listings/nukeop--nuclear/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/nukeop/nuclear.git cd nuclear pnpm install pnpm dev
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 183 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <picture>
- <source alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png">
- <img alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png">
- </picture>
- </p>
- <div align="center">
- # Nuclear
- </div>
- <div align="center">
- Nuclear is a free, open-source music player without ads or tracking. Search for any song or artist, build playlists, and start listening.<br>
- Runs on Windows, macOS, and Linux.
- </div>
- ## Screenshots
- <p align="center">
- <img src="packages/docs/.gitbook/assets/dashboard-main.png" alt="Nuclear Music Player - Dashboard" width="100%">
- </p>
- Nuclear comes with multiple built-in themes, with light and a dark modes:
- <p align="center">
- <img src="packages/docs/.gitbook/assets/dashboard-aurora-light.png" alt="Aurora theme, light mode" width="32%">
- <img src="packages/docs/.gitbook/assets/dashboard-ember-light.png" alt="Ember theme, light mode" width="32%">
- <img src="packages/docs/.gitbook/assets/dashboard-lagoon-light.png" alt="Lagoon theme, light mode" width="32%">
- </p>
- <p align="center">
- <img src="packages/docs/.gitbook/assets/dashboard-default-dark.png" alt="Default theme, dark mode" width="32%">
- <img src="packages/docs/.gitbook/assets/dashboard-lagoon-dark.png" alt="Lagoon theme, dark mode" width="32%">
- <img src="packages/docs/.gitbook/assets/dashboard-arctic-moss-dark.png" alt="Arctic Moss theme, dark mode" width="32%">
- </p>
- | | |
- |:---:|:---:|
- |  |  |
- | 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:
- <p align="center">
- <img src="packages/docs/.gitbook/assets/jam-remote.png" alt="Nuclear Jam remote control on a phone" width="300">
- </p>
- ## Download
- Grab the latest release for your platform from the [Releases page](https://github.com/nukeop/nuclear/releases).
- | 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](https://www.npmjs.com/package/@nuclearplayer/plugin-sdk).
- ## MCP
- You can enable the MCP server in Settings → Integrations.
- Then to add it to **Claude Code:**
- ```bash
- claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp
- ```
- **Codex CLI:**
- ```bash
- codex mcp add nuclear --url http://127.0.0.1:8800/mcp
- ```
- **OpenCode:**
- ```json
- {
- "mcp": {
- "nuclear": {
- "type": "remote",
- "url": "http://127.0.0.1:8800/mcp"
- }
- }
- }
- ```
- **Claude Desktop / Cursor / Windsurf:**
- ```json
- {
- "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](./packages/docs/.gitbook/assets/nuclear-mcp.zip)
- ## 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](https://v2.tauri.app/start/prerequisites/))
- ### Getting started
- ```bash
- git clone https://github.com/nukeop/nuclear.git
- cd nuclear
- pnpm install
- pnpm dev
- ```
- ### Useful commands
- ```bash
- 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
- ```
- ## Community
- - [Discord](https://discord.gg/JqPjKxE)
- - [Mastodon](https://fosstodon.org/@nuclearplayer)
- - [Discussions](https://github.com/nukeop/nuclear/discussions)
- ## License
- AGPL-3.0. See [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.