nukeop/nuclear

TypeScriptnuclearplayer.com
macOSWindowsLinux

Streaming music player that finds free music for you

music-playermusiclinuxwindowsmacstreamingdesktop-appreactrusttauritypescriptai
Crecimiento de estrellas
Estrellas
18.4k
Forks
1.3k
Crecimiento semanal
+39
Issues
1
5k10k15k
ene 2017mar 2020jun 2023sept 2026
Artefactosnpm
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 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.

Repositorios relacionados
lyswhut/lx-music-desktop

一个基于 Electron 的音乐软件

TypeScriptnpmappApache License 2.0music-playerjavascript
lyswhut.github.io/lx-music-doc/
53.4k7k
KRTirtho/spotube

🎧 Open source music streaming app! Available for both desktop & mobile!

DartappOtheryoutubedesktop-client
spotube.cc
49k2.3k
pear-devs/pear-desktop

Pear 🍐 is extension for music player

TypeScriptnpmappMIT Licensemusicdesktop-app
33.4k2k
qier222/YesPlayMusic

高颜值的第三方网易云播放器,支持 Windows / macOS / Linux :electron:

VueappMIT Licensevuevuex
music.qier222.com
33.3k4.7k
maotoumao/MusicFree

插件化、定制化、无广告的免费音乐播放器

TypeScriptnpmGNU Affero General Public License v3.0freemusic-player
musicfree.catcat.work
26.7k1.9k
lyswhut/lx-music-mobile

一个基于 React native 开发的音乐软件

TypeScriptnpmappApache License 2.0javascriptreact-native-app
lyswhut.github.io/lx-music-doc/
18.1k2.1k
koel/koel

Music streaming solution that works.

PHPPackagistMIT Licenselaravelvue
koel.dev
17.2k2.1k
algerkong/AlgerMusicPlayer

一个第三方音乐播放器、本地服务、桌面歌词、音乐下载、远程控制

VueappMIT Licensealgermusic
16.7k1.4k
MetrolistGroup/Metrolist

YouTube Music client for Android

KotlinappGNU General Public License v3.0androidinnertube
metrolist.cc
12.6k1k
listen1/listen1_chrome_extension

one for all free music in china (chrome extension, also works for firefox)

JavaScriptnpmappMIT Licensechrome-extensionmusic-player
listen1.github.io/listen1
12.1k2k
listen1/listen1_desktop

one for all free music in china (Windows, Mac, Linux desktop)

JavaScriptnpmappMIT Licensedesktop-appmusic-player
listen1.github.io/listen1
11.4k1.5k
jeffvli/feishin

A modern self-hosted music player.

TypeScriptnpmGNU General Public License v3.0jellyfinmusic-player
feishin.vercel.app
9.8k512