nuclear README

The project's README from github.com/nukeop/nuclear. As one markdown file: README.md.

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

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

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.

nuclear (nukeop/nuclear)

Searching Database…

18.7K ·GitHub
Что это такое?Nuclear — это бесплатный десктопный плеер с открытым исходным кодом, который сам находит для вас бесплатную музыку: ищите любую песню или исполнителя, слушайте её в потоковом режиме и собирайте плейлисты.
Это десктопное приложение или оно работает в браузере?Это нативное десктопное приложение, которое вы устанавливаете на свой компьютер — текущая версия собрана на Tauri (бэкенд на Rust с интерфейсом на React), а не веб-приложение.
Нужен ли аккаунт или какая-то дополнительная настройка, чтобы начать слушать музыку?Нет — установите и сразу ищите музыку; никаких аккаунтов и подписок. Дополнительные инструменты нужны только для сборки из исходников: Node.js 22+, pnpm 9+ и stable Rust.
Откуда берётся музыка — там есть каталог, как у Spotify?Проект построен вокруг свободной музыки: Nuclear ищет и стримит музыку из любых доступных источников, а не продаёт доступ к лицензионному каталогу, поэтому то, что вы сможете услышать, зависит от источников, которые ей доступны.
На каких платформах он работает?Windows, macOS и Linux — включая Mac как на Apple Silicon, так и на Intel.
Он следит за мной или показывает рекламу?Нет — в README сказано прямо: музыкальный плеер без рекламы и слежки, к тому же он с открытым исходным кодом, так что код можно проверить.
Что умеют плагины?Очень многое — вся основная функциональность построена на плагинах. Они добавляют источники стриминга, метаданные, плейлисты и содержимое дашборда; устанавливайте их из встроенного магазина плагинов или пишите свои с помощью @nuclearplayer/plugin-sdk.
Можно ли управлять плеером через AI-агента?Да — включите MCP-сервер в Settings → Integrations, затем подключите Claude Code, Codex CLI, OpenCode, Claude Desktop, Cursor или Windsurf. MCP сделан так, чтобы его было легко обнаружить, а Nuclear MCP Skill быстро введёт вашего агента в курс дела.
Что есть кроме поиска и воспроизведения?Управление очередью с перемешиванием, повтором и перетаскиванием треков; избранное для альбомов, исполнителей и треков; импорт и экспорт плейлистов, в том числе из других сервисов; автообновления; горячие клавиши; несколько языков интерфейса; а также просмотрщик логов.
Можно ли настроить внешний вид?Да — в Nuclear есть несколько встроенных тем, а также поддержка кастомных тем на CSS, так что вы можете оформить плеер по-своему.
Creator
nukeop
Size
219.9 MB
Stars
18.7K
Age
10y
Commits · 90 Days