nukeop/nuclear

nukeop/nuclear has 18,896 GitHub stars and 1,357 forks. GitHot measured +5 stars in 24 hours. Last checked 2026-11-08 17:13 UTC. Last push 2026-11-04.

Comment ces chiffres sont mesurés

Lecteur de musique en streaming qui trouve de la musique gratuite pour vous

18,896 étoiles 1,357 forks +5 in 24h

What you can do

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

Progression mesurée des étoiles

in 24h: +5
in 7 days: Mise à jour retardée
in 15 days: Mise à jour retardée
in 1 month: Mise à jour retardée

Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.

README.md

Original

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, with light and a dark modes:

Aurora theme, light mode Ember theme, light mode Lagoon theme, light mode

Default theme, dark mode Lagoon theme, dark mode Arctic Moss theme, dark mode



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:

Nuclear Jam remote control on a phone

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

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

License

AGPL-3.0. See LICENSE.