https://github.com/nukeop/nuclear
Streaming music player that finds free music for you
https://github.com/nukeop/nuclear
electron linux mac music music-player stream streaming windows youtube
Last synced: 8 days ago
JSON representation
Streaming music player that finds free music for you
- Host: GitHub
- URL: https://github.com/nukeop/nuclear
- Owner: nukeop
- License: agpl-3.0
- Created: 2016-09-22T22:58:21.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2026-02-28T02:49:51.000Z (25 days ago)
- Last Synced: 2026-02-28T08:35:04.991Z (24 days ago)
- Topics: electron, linux, mac, music, music-player, stream, streaming, windows, youtube
- Language: TypeScript
- Homepage: https://nuclearplayer.com
- Size: 137 MB
- Stars: 17,016
- Watchers: 161
- Forks: 1,265
- Open Issues: 171
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-electron - Nuclear - Music player that streams from free sources. (Apps / Open Source)
- fucking-Awesome-Linux-Software -  (Apps / Video/Music)
- awesome-rainmana - nukeop/nuclear - Streaming music player that finds free music for you (TypeScript)
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/nukeop/nuclear - Streaming music player that finds free music for you (Media / Other)
- StarryDivineSky - nukeop/nuclear
- jimsghstars - nukeop/nuclear - Streaming music player that finds free music for you (TypeScript)
- awesome-list-for-developers - nuclear - first-issue)_ <br> Multiplatform music player that streams from free sources. (JavaScript / Misc)
- awesome-mac - nukeop/nuclear
- awesomeelectron - Nuclear - Music player that streams from free sources. (Apps / Open Source)
- awesome-systools - nuclear
- awesome-electron-zh - Nuclear - Music player that streams from free sources. (Apps / Open Source)
- awesome-electron - Nuclear - Music player that streams from free sources. (Apps / Open Source)
README
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:
| | |
|:---:|:---:|
|  |  |
| Artist search | Album search |
|  |  |
| Playlists | Plugin store |
|  |  |
| Installed plugins | Preferences |
|  |  |
| What's new | Log viewer |
## 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 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](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/public/skills/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 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).