Initial commit

Author: nukeop

.github/workflows/release.yml

@@ -0,0 +1,23 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create plugin.zip
+        run: zip -r plugin.zip src package.json README.md
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: plugin.zip
+          generate_release_notes: true

.gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+build

LICENSE

@@ -0,0 +1,11 @@
+# YouTube Streaming Plugin for Nuclear
+
+A streaming provider plugin that plays audio from Youtube using yt-dlp.
+
+## Requirements
+
+[yt-dlp](https://github.com/yt-dlp/yt-dlp) must be installed and available in your PATH.
+
+## Installation
+
+Install from the Nuclear plugin browser.

README.md

@@ -0,0 +1,32 @@
+{
+  "name": "nuclear-plugin-youtube",
+  "version": "0.1.0",
+  "description": "YouTube streaming provider for Nuclear music player",
+  "author": "nukeop",
+  "license": "AGPL-3.0-only",
+  "main": "src/index.ts",
+  "type": "module",
+  "nuclear": {
+    "displayName": "YouTube",
+    "category": "streaming",
+    "icon": {
+      "type": "link",
+      "link": "https://www.youtube.com/s/desktop/26a583e4/img/favicon_144x144.png"
+    },
+    "permissions": []
+  },
+  "keywords": [
+    "nuclear",
+    "plugin",
+    "youtube",
+    "streaming"
+  ],
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "@nuclearplayer/plugin-sdk": "^0.0.14"
+  },
+  "packageManager": "pnpm@10.16.1"
+}

package.json

@@ -0,0 +1,50 @@
+import type {
+  NuclearPlugin,
+  NuclearPluginAPI,
+  StreamingProvider,
+} from '@nuclearplayer/plugin-sdk';
+
+const PROVIDER_ID = 'youtube';
+
+const createProvider = (api: NuclearPluginAPI): StreamingProvider => ({
+  id: PROVIDER_ID,
+  kind: 'streaming',
+  name: 'YouTube',
+
+  searchForTrack: async (artist, title) => {
+    const query = `${artist} ${title}`;
+    const results = await api.Ytdlp.search(query);
+
+    return results.map((result) => ({
+      id: result.id,
+      title: result.title,
+      durationMs: result.duration ? result.duration * 1000 : undefined,
+      thumbnail: result.thumbnail ?? undefined,
+      failed: false,
+      source: { provider: PROVIDER_ID, id: result.id },
+    }));
+  },
+
+  getStreamUrl: async (candidateId) => {
+    const info = await api.Ytdlp.getStream(candidateId);
+
+    return {
+      url: info.stream_url,
+      protocol: 'https',
+      durationMs: info.duration ? info.duration * 1000 : undefined,
+      source: { provider: PROVIDER_ID, id: candidateId },
+    };
+  },
+});
+
+const plugin: NuclearPlugin = {
+  onEnable(api: NuclearPluginAPI) {
+    api.Providers.register(createProvider(api));
+  },
+
+  onDisable(api: NuclearPluginAPI) {
+    api.Providers.unregister(PROVIDER_ID);
+  },
+};
+
+export default plugin;

pnpm-lock.yaml

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src"]
+}