Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nukeop--nuclear/badge.svg)](/listings/nukeop--nuclear)

HTML

<a href="/listings/nukeop--nuclear"><img src="/api/listings/nukeop--nuclear/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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)

  1. <p align="center">
  2. <picture>
  3. <source alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png">
  4. <img alt="Nuclear Music Player" srcset="packages/docs/.gitbook/assets/readme-banner.png">
  5. </picture>
  6. </p>
  7. <div align="center">
  8. # Nuclear
  9. </div>
  10. <div align="center">
  11. Nuclear is a free, open-source music player without ads or tracking. Search for any song or artist, build playlists, and start listening.<br>
  12. Runs on Windows, macOS, and Linux.
  13. </div>
  14. ## Screenshots
  15. <p align="center">
  16. <img src="packages/docs/.gitbook/assets/dashboard-main.png" alt="Nuclear Music Player - Dashboard" width="100%">
  17. </p>
  18. Nuclear comes with multiple built-in themes, with light and a dark modes:
  19. <p align="center">
  20. <img src="packages/docs/.gitbook/assets/dashboard-aurora-light.png" alt="Aurora theme, light mode" width="32%">
  21. <img src="packages/docs/.gitbook/assets/dashboard-ember-light.png" alt="Ember theme, light mode" width="32%">
  22. <img src="packages/docs/.gitbook/assets/dashboard-lagoon-light.png" alt="Lagoon theme, light mode" width="32%">
  23. </p>
  24. <p align="center">
  25. <img src="packages/docs/.gitbook/assets/dashboard-default-dark.png" alt="Default theme, dark mode" width="32%">
  26. <img src="packages/docs/.gitbook/assets/dashboard-lagoon-dark.png" alt="Lagoon theme, dark mode" width="32%">
  27. <img src="packages/docs/.gitbook/assets/dashboard-arctic-moss-dark.png" alt="Arctic Moss theme, dark mode" width="32%">
  28. </p>
  29. | | |
  30. |:---:|:---:|
  31. | ![Search artists](packages/docs/.gitbook/assets/search-artists.png) | ![Search albums](packages/docs/.gitbook/assets/search-albums.png) |
  32. | Artist search | Album search |
  33. | ![Search tracks](packages/docs/.gitbook/assets/search-tracks.png) | ![Artist page](packages/docs/.gitbook/assets/artist.png) |
  34. | Track search with recent searches | Artist page |
  35. | ![Album page](packages/docs/.gitbook/assets/album.png) | ![Favorite artists](packages/docs/.gitbook/assets/favorite-artists.png) |
  36. | Album page | Favorites |
  37. | ![Playlists](packages/docs/.gitbook/assets/playlists.png) | ![Playlist](packages/docs/.gitbook/assets/playlist-detail-view.png) |
  38. | Playlists | Playlist |
  39. | ![Synced lyrics](packages/docs/.gitbook/assets/lyrics.png) | ![Lyrics with furigana and translations](packages/docs/.gitbook/assets/lyrics-translations.png) |
  40. | Synced lyrics | Lyrics with furigana and translations |
  41. | ![Listening history](packages/docs/.gitbook/assets/history.png) | ![Listening stats](packages/docs/.gitbook/assets/history-stats.png) |
  42. | Listening history | Listening stats |
  43. | ![Stream sources](packages/docs/.gitbook/assets/stream-candidates.png) | ![Plugin store](packages/docs/.gitbook/assets/plugin-store.png) |
  44. | Stream sources for a queued track | Plugin store |
  45. | ![Installed plugins](packages/docs/.gitbook/assets/installed-plugins.png) | ![Preferences](packages/docs/.gitbook/assets/preferences.png) |
  46. | Installed plugins | Preferences |
  47. | ![What's new](packages/docs/.gitbook/assets/whats-new.png) | ![Log viewer](packages/docs/.gitbook/assets/log-viewer.png) |
  48. | What's new | Log viewer |
  49. Control Nuclear from your phone with Nuclear Jam:
  50. <p align="center">
  51. <img src="packages/docs/.gitbook/assets/jam-remote.png" alt="Nuclear Jam remote control on a phone" width="300">
  52. </p>
  53. ## Download
  54. Grab the latest release for your platform from the [Releases page](https://github.com/nukeop/nuclear/releases).
  55. | Platform | Formats |
  56. |----------|---------|
  57. | Windows | `.exe` installer, `.msi` |
  58. | macOS | `.dmg` (Apple Silicon and Intel) |
  59. | Linux | `.AppImage`, `.deb`, `.rpm`, `.flatpak` |
  60. ## Features
  61. - Search for music and stream it from any source
  62. - Browse artist pages with biographies, discographies, and similar artists
  63. - Browse album pages with track listings
  64. - Queue management with shuffle, repeat, and drag-and-drop reordering
  65. - Favorites (albums, artists, and tracks)
  66. - Playlists (create, import, export, import from various services)
  67. - Powerful plugin system with a built-in plugin store
  68. - Themes (built-in and custom CSS themes)
  69. - MCP server lets your AI agent drive the player
  70. - Auto-updates
  71. - Keyboard shortcuts
  72. - Localized in multiple languages
  73. ## Plugins
  74. Nuclear has a powerful plugin system now! Every functionality has been redesigned to be driven by plugins.
  75. 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).
  76. ## MCP
  77. You can enable the MCP server in Settings → Integrations.
  78. Then to add it to **Claude Code:**
  79. ```bash
  80. claude mcp add nuclear --transport http http://127.0.0.1:8800/mcp
  81. ```
  82. **Codex CLI:**
  83. ```bash
  84. codex mcp add nuclear --url http://127.0.0.1:8800/mcp
  85. ```
  86. **OpenCode:**
  87. ```json
  88. {
  89. "mcp": {
  90. "nuclear": {
  91. "type": "remote",
  92. "url": "http://127.0.0.1:8800/mcp"
  93. }
  94. }
  95. }
  96. ```
  97. **Claude Desktop / Cursor / Windsurf:**
  98. ```json
  99. {
  100. "mcpServers": {
  101. "nuclear": {
  102. "url": "http://127.0.0.1:8800/mcp"
  103. }
  104. }
  105. }
  106. ```
  107. 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)
  108. ## Development
  109. Nuclear is a pnpm monorepo managed with Turborepo. The main app is built with Tauri (Rust + React).
  110. ### Prerequisites
  111. - Node.js >= 22
  112. - pnpm >= 9
  113. - Rust (stable)
  114. - Platform-specific Tauri dependencies ([see Tauri docs](https://v2.tauri.app/start/prerequisites/))
  115. ### Getting started
  116. ```bash
  117. git clone https://github.com/nukeop/nuclear.git
  118. cd nuclear
  119. pnpm install
  120. pnpm dev
  121. ```
  122. ### Useful commands
  123. ```bash
  124. pnpm dev # Run the player in dev mode
  125. 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
  126. pnpm build # Build all packages
  127. pnpm test # Run all tests
  128. pnpm lint # Lint all packages
  129. pnpm type-check # TypeScript checks
  130. pnpm storybook # Run Storybook
  131. ```
  132. ## Community
  133. - [Discord](https://discord.gg/JqPjKxE)
  134. - [Mastodon](https://fosstodon.org/@nuclearplayer)
  135. - [Discussions](https://github.com/nukeop/nuclear/discussions)
  136. ## License
  137. AGPL-3.0. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.