pal-explorer-cli 0.4.12 → 0.4.13

package/lib/commands/stream.js

@@ -1,562 +1,562 @@
-import chalk from 'chalk';
-import http from 'http';
-import fs from 'fs';
-import path from 'path';
-import crypto from 'crypto';
-
-let streamToken = null;
-
-let streamState = {
-  server: null,
-  port: null,
-  type: null,
-  filePath: null,
-  fileName: null,
-  magnet: null,
-  broadcast: null,
-  startedAt: null,
-};
-
-let folderStreamState = {
-  server: null,
-  port: null,
-  folderPath: null,
-  files: [],
-  startedAt: null,
-};
-
-const MEDIA_EXTS = new Set(['mp3', 'flac', 'wav', 'ogg', 'aac', 'm4a', 'mp4', 'mkv', 'webm', 'avi', 'mov']);
-const AUDIO_EXTS = new Set(['mp3', 'flac', 'wav', 'ogg', 'aac', 'm4a']);
-
-const MIME_TYPES = {
-  '.mp4': 'video/mp4',
-  '.webm': 'video/webm',
-  '.mkv': 'video/x-matroska',
-  '.avi': 'video/x-msvideo',
-  '.mp3': 'audio/mpeg',
-  '.flac': 'audio/flac',
-  '.ogg': 'audio/ogg',
-  '.wav': 'audio/wav',
-  '.m4a': 'audio/mp4',
-};
-
-function getMime(fileName) {
-  const ext = path.extname(fileName).toLowerCase();
-  return MIME_TYPES[ext] || 'application/octet-stream';
-}
-
-function startLocalServer(filePath) {
-  return new Promise((resolve, reject) => {
-    streamToken = crypto.randomBytes(16).toString('hex');
-    const fileName = path.basename(filePath);
-    const server = http.createServer((req, res) => {
-      res.setHeader('Access-Control-Allow-Origin', '*');
-      const reqUrl = new URL(req.url, `http://${req.headers.host}`);
-      if (reqUrl.searchParams.get('token') !== streamToken) {
-        res.writeHead(401);
-        res.end('Unauthorized');
-        return;
-      }
-      if (reqUrl.pathname !== '/stream') {
-        res.writeHead(404);
-        res.end();
-        return;
-      }
-
-      let fileSize;
-      try { fileSize = fs.statSync(filePath).size; } catch { res.writeHead(404); res.end(); return; }
-
-      const mime = getMime(fileName);
-      const range = req.headers.range;
-      if (range) {
-        const [startStr, endStr] = range.replace('bytes=', '').split('-');
-        const start = parseInt(startStr, 10);
-        const end = endStr ? parseInt(endStr, 10) : fileSize - 1;
-        res.writeHead(206, {
-          'Content-Range': `bytes ${start}-${end}/${fileSize}`,
-          'Accept-Ranges': 'bytes',
-          'Content-Length': end - start + 1,
-          'Content-Type': mime,
-        });
-        fs.createReadStream(filePath, { start, end }).pipe(res);
-      } else {
-        res.writeHead(200, {
-          'Content-Length': fileSize,
-          'Content-Type': mime,
-          'Accept-Ranges': 'bytes',
-        });
-        fs.createReadStream(filePath).pipe(res);
-      }
-    });
-
-    server.listen(0, '127.0.0.1', () => {
-      const port = server.address().port;
-      resolve({ server, port, token: streamToken });
-    });
-    server.on('error', reject);
-  });
-}
-
-function stopStream() {
-  if (streamState.server) {
-    streamState.server.close();
-  }
-  streamState = { server: null, port: null, type: null, filePath: null, fileName: null, magnet: null, broadcast: null, startedAt: null };
-}
-
-function scanFolder(dirPath, maxDepth = 5) {
-  const results = [];
-  function walk(dir, depth) {
-    if (depth > maxDepth || results.length >= 2000) return;
-    let entries;
-    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
-    for (const entry of entries) {
-      if (results.length >= 2000) return;
-      const fullPath = path.join(dir, entry.name);
-      if (entry.isDirectory() && !entry.name.startsWith('.')) {
-        walk(fullPath, depth + 1);
-      } else if (entry.isFile()) {
-        const ext = entry.name.split('.').pop().toLowerCase();
-        if (MEDIA_EXTS.has(ext)) {
-          let size = 0;
-          try { size = fs.statSync(fullPath).size; } catch {}
-          results.push({
-            name: entry.name,
-            path: fullPath,
-            size,
-            type: AUDIO_EXTS.has(ext) ? 'audio' : 'video',
-          });
-        }
-      }
-    }
-  }
-  walk(dirPath, 0);
-  results.sort((a, b) => a.name.localeCompare(b.name));
-  return results;
-}
-
-function startFolderServer(folderPath, files) {
-  return new Promise((resolve, reject) => {
-    streamToken = crypto.randomBytes(16).toString('hex');
-    const server = http.createServer((req, res) => {
-      res.setHeader('Access-Control-Allow-Origin', '*');
-      const url = new URL(req.url, `http://${req.headers.host}`);
-
-      if (url.searchParams.get('token') !== streamToken) {
-        res.writeHead(401);
-        res.end('Unauthorized');
-        return;
-      }
-
-      if (url.pathname === '/playlist') {
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify(files.map(f => ({ name: f.name, path: f.path, size: f.size, type: f.type }))));
-        return;
-      }
-
-      if (url.pathname === '/stream') {
-        const fileName = url.searchParams.get('file');
-        if (!fileName) { res.writeHead(400); res.end('Missing file param'); return; }
-        const file = files.find(f => f.name === fileName);
-        if (!file) { res.writeHead(404); res.end('File not found'); return; }
-
-        let fileSize;
-        try { fileSize = fs.statSync(file.path).size; } catch { res.writeHead(404); res.end(); return; }
-
-        const mime = getMime(file.name);
-        const range = req.headers.range;
-        if (range) {
-          const [startStr, endStr] = range.replace('bytes=', '').split('-');
-          const start = parseInt(startStr, 10);
-          const end = endStr ? parseInt(endStr, 10) : fileSize - 1;
-          res.writeHead(206, {
-            'Content-Range': `bytes ${start}-${end}/${fileSize}`,
-            'Accept-Ranges': 'bytes',
-            'Content-Length': end - start + 1,
-            'Content-Type': mime,
-          });
-          fs.createReadStream(file.path, { start, end }).pipe(res);
-        } else {
-          res.writeHead(200, {
-            'Content-Length': fileSize,
-            'Content-Type': mime,
-            'Accept-Ranges': 'bytes',
-          });
-          fs.createReadStream(file.path).pipe(res);
-        }
-        return;
-      }
-
-      res.writeHead(404);
-      res.end();
-    });
-
-    server.listen(0, '127.0.0.1', () => {
-      resolve({ server, port: server.address().port, token: streamToken });
-    });
-    server.on('error', reject);
-  });
-}
-
-function stopFolderStream() {
-  if (folderStreamState.server) {
-    folderStreamState.server.close();
-  }
-  folderStreamState = { server: null, port: null, folderPath: null, files: [], startedAt: null };
-}
-
-export default function streamCommand(program) {
-  const cmd = program
-    .command('stream')
-    .description('stream media files locally or from the network')
-    .addHelpText('after', `
-Examples:
-  $ pe stream local /path/to/video.mp4   Stream a local file via HTTP
-  $ pe stream remote magnet:?xt=...      Stream a remote file from magnet
-  $ pe stream stop                       Stop current stream
-  $ pe stream status                     Show current stream info
-  $ pe stream broadcast /path/to/file    Start a broadcast session
-  $ pe stream join magnet:?xt=...        Join a broadcast
-  $ pe stream folder /path/to/music      Serve a folder as a media library
-  $ pe stream playlist                   Show current folder playlist
-`)
-    .action(() => {
-      showStatus();
-    });
-
-  cmd
-    .command('local <file>')
-    .description('stream a local file (starts HTTP server)')
-    .action(async (file) => {
-      const filePath = path.resolve(file);
-      if (!fs.existsSync(filePath)) {
-        console.log(chalk.red('File not found.'));
-        process.exitCode = 1;
-        return;
-      }
-
-      stopStream();
-      try {
-        const { server, port } = await startLocalServer(filePath);
-        streamState = {
-          server,
-          port,
-          type: 'local',
-          filePath,
-          fileName: path.basename(filePath),
-          magnet: null,
-          broadcast: null,
-          startedAt: new Date().toISOString(),
-        };
-        console.log(chalk.green(`Streaming: ${streamState.fileName}`));
-        console.log(`  Local:  ${chalk.cyan(`http://127.0.0.1:${port}/stream?token=${streamToken}`)}`);
-        console.log(chalk.gray(`  Token:  ${streamToken}`));
-        console.log(chalk.gray('Press Ctrl+C to stop.'));
-      } catch (err) {
-        console.log(chalk.red(`Failed to start stream: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('remote <magnet>')
-    .description('stream a remote file from magnet link')
-    .action(async (magnet) => {
-      stopStream();
-      try {
-        const WebTorrent = (await import('webtorrent')).default;
-        const client = new WebTorrent();
-        const torrent = await new Promise((resolve, reject) => {
-          const t = client.add(magnet);
-          t.on('ready', () => resolve(t));
-          t.on('error', reject);
-          setTimeout(() => reject(new Error('Torrent timeout')), 30000);
-        });
-
-        const file = torrent.files[0];
-        console.log(chalk.green(`Streaming remote: ${file.name}`));
-        console.log(`  Size: ${chalk.white((file.length / 1048576).toFixed(1))} MB`);
-
-        streamState = {
-          server: client,
-          port: null,
-          type: 'remote',
-          filePath: null,
-          fileName: file.name,
-          magnet,
-          broadcast: null,
-          startedAt: new Date().toISOString(),
-        };
-      } catch (err) {
-        console.log(chalk.red(`Failed to stream: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('stop')
-    .description('stop the current stream')
-    .action(() => {
-      if (!streamState.type) {
-        console.log(chalk.gray('No active stream.'));
-        return;
-      }
-      const name = streamState.fileName;
-      stopStream();
-      console.log(chalk.green(`Stream stopped: ${name}`));
-    });
-
-  cmd
-    .command('status')
-    .description('show current stream status')
-    .action(() => {
-      showStatus();
-    });
-
-  cmd
-    .command('broadcast <file>')
-    .description('start a broadcast session for a file')
-    .action(async (file) => {
-      const filePath = path.resolve(file);
-      if (!fs.existsSync(filePath)) {
-        console.log(chalk.red('File not found.'));
-        process.exitCode = 1;
-        return;
-      }
-
-      stopStream();
-      try {
-        const { server, port } = await startLocalServer(filePath);
-        streamState = {
-          server,
-          port,
-          type: 'broadcast',
-          filePath,
-          fileName: path.basename(filePath),
-          magnet: null,
-          broadcast: { hostStartedAt: new Date().toISOString(), viewers: 0 },
-          startedAt: new Date().toISOString(),
-        };
-        console.log(chalk.green(`Broadcasting: ${streamState.fileName}`));
-        console.log(`  URL: ${chalk.cyan(`http://127.0.0.1:${port}/stream?token=${streamToken}`)}`);
-        console.log(chalk.gray('Share the URL with your pals to let them watch.'));
-      } catch (err) {
-        console.log(chalk.red(`Failed to start broadcast: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('join <magnet>')
-    .description('join a broadcast via magnet link')
-    .action(async (magnet) => {
-      stopStream();
-      try {
-        const WebTorrent = (await import('webtorrent')).default;
-        const client = new WebTorrent();
-        const torrent = await new Promise((resolve, reject) => {
-          const t = client.add(magnet);
-          t.on('ready', () => resolve(t));
-          t.on('error', reject);
-          setTimeout(() => reject(new Error('Torrent timeout')), 30000);
-        });
-
-        const file = torrent.files[0];
-        console.log(chalk.green(`Joined broadcast: ${file.name}`));
-        console.log(`  Peers: ${chalk.white(torrent.numPeers)}`);
-
-        streamState = {
-          server: client,
-          port: null,
-          type: 'joined-broadcast',
-          filePath: null,
-          fileName: file.name,
-          magnet,
-          broadcast: { hostHandle: null },
-          startedAt: new Date().toISOString(),
-        };
-      } catch (err) {
-        console.log(chalk.red(`Failed to join broadcast: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('transport')
-    .description('show or configure stream transport settings')
-    .option('--set <type>', 'Set preferred transport: p2p, relay, tunnel')
-    .option('--stun-add <url>', 'Add custom STUN server')
-    .option('--stun-remove <url>', 'Remove custom STUN server')
-    .option('--turn-add <json>', 'Add custom TURN server (JSON: {"urls":"turn:host:3478","username":"u","credential":"p"})')
-    .option('--turn-remove <url>', 'Remove custom TURN server by URL')
-    .option('--tunnel <url>', 'Set custom tunnel URL (cloudflared, ngrok, etc.)')
-    .action(async (opts) => {
-      const { getTransportConfig, setTransportConfig } = await import('../core/streamTransport.js');
-
-      if (opts.set) {
-        const valid = ['p2p', 'relay', 'tunnel'];
-        if (!valid.includes(opts.set)) {
-          console.log(chalk.red(`Invalid transport. Options: ${valid.join(', ')}`));
-          process.exitCode = 1;
-          return;
-        }
-        setTransportConfig({ preferred: opts.set });
-        console.log(chalk.green(`Transport set to: ${opts.set}`));
-        return;
-      }
-
-      if (opts.stunAdd) {
-        const tc = getTransportConfig();
-        if (!tc.customStunServers.includes(opts.stunAdd)) {
-          tc.customStunServers.push(opts.stunAdd);
-          setTransportConfig({ customStunServers: tc.customStunServers });
-        }
-        console.log(chalk.green(`Added STUN: ${opts.stunAdd}`));
-        return;
-      }
-
-      if (opts.stunRemove) {
-        const tc = getTransportConfig();
-        tc.customStunServers = tc.customStunServers.filter(s => s !== opts.stunRemove);
-        setTransportConfig({ customStunServers: tc.customStunServers });
-        console.log(chalk.green(`Removed STUN: ${opts.stunRemove}`));
-        return;
-      }
-
-      if (opts.turnAdd) {
-        try {
-          const turn = JSON.parse(opts.turnAdd);
-          if (!turn.urls) throw new Error('Missing "urls"');
-          const tc = getTransportConfig();
-          tc.customTurnServers.push(turn);
-          setTransportConfig({ customTurnServers: tc.customTurnServers });
-          console.log(chalk.green(`Added TURN: ${turn.urls}`));
-        } catch (err) {
-          console.log(chalk.red(`Invalid JSON: ${err.message}`));
-          process.exitCode = 1;
-        }
-        return;
-      }
-
-      if (opts.turnRemove) {
-        const tc = getTransportConfig();
-        tc.customTurnServers = tc.customTurnServers.filter(t => t.urls !== opts.turnRemove);
-        setTransportConfig({ customTurnServers: tc.customTurnServers });
-        console.log(chalk.green(`Removed TURN: ${opts.turnRemove}`));
-        return;
-      }
-
-      if (opts.tunnel) {
-        setTransportConfig({ tunnelUrl: opts.tunnel });
-        console.log(chalk.green(`Tunnel URL set to: ${opts.tunnel}`));
-        return;
-      }
-
-      // Show current config
-      const tc = getTransportConfig();
-      console.log('');
-      console.log(chalk.cyan('Stream Transport Config:'));
-      console.log(`  Preferred: ${chalk.yellow(tc.preferred)}`);
-      console.log(`  STUN servers (built-in): ${chalk.white(tc.stunServers.join(', ') || 'none')}`);
-      console.log(`  STUN servers (custom):   ${chalk.white(tc.customStunServers.join(', ') || 'none')}`);
-      console.log(`  TURN servers (custom):   ${chalk.white(tc.customTurnServers.map(t => t.urls).join(', ') || 'none')}`);
-      console.log(`  TURN server (default):   ${chalk.gray(tc.turnServer)}`);
-      console.log(`  Tunnel URL:              ${chalk.white(tc.tunnelUrl || 'not set')}`);
-      console.log('');
-      console.log(chalk.gray('  Transport options:'));
-      console.log(chalk.gray('    p2p    — WebRTC peer-to-peer (default, best privacy)'));
-      console.log(chalk.gray('    relay  — Through palexplorer relay server'));
-      console.log(chalk.gray('    tunnel — Through your own tunnel (cloudflared, ngrok, etc.)'));
-    });
-  cmd
-    .command('folder <path>')
-    .description('serve a folder as a streamable media library')
-    .action(async (folderPath) => {
-      const resolved = path.resolve(folderPath);
-      if (!fs.existsSync(resolved)) {
-        console.log(chalk.red('Folder not found.'));
-        process.exitCode = 1;
-        return;
-      }
-      const stat = fs.statSync(resolved);
-      if (!stat.isDirectory()) {
-        console.log(chalk.red('Path is not a directory.'));
-        process.exitCode = 1;
-        return;
-      }
-
-      console.log(chalk.gray('Scanning folder...'));
-      const files = scanFolder(resolved);
-      if (files.length === 0) {
-        console.log(chalk.red('No media files found.'));
-        process.exitCode = 1;
-        return;
-      }
-
-      stopFolderStream();
-      try {
-        const { server, port } = await startFolderServer(resolved, files);
-        folderStreamState = { server, port, folderPath: resolved, files, startedAt: new Date().toISOString() };
-
-        const audio = files.filter(f => f.type === 'audio').length;
-        const video = files.filter(f => f.type === 'video').length;
-        console.log(chalk.green(`Serving ${files.length} files (${audio} audio, ${video} video)`));
-        console.log(`  Playlist: ${chalk.cyan(`http://127.0.0.1:${port}/playlist?token=${streamToken}`)}`);
-        console.log(`  Stream:   ${chalk.cyan(`http://127.0.0.1:${port}/stream?file=<name>&token=${streamToken}`)}`);
-        console.log(chalk.gray(`  Token:    ${streamToken}`));
-        console.log(chalk.gray('Press Ctrl+C to stop.'));
-      } catch (err) {
-        console.log(chalk.red(`Failed to start folder stream: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('playlist')
-    .description('show current folder stream playlist')
-    .action(() => {
-      if (!folderStreamState.server) {
-        console.log(chalk.gray('No folder stream active.'));
-        return;
-      }
-      console.log('');
-      console.log(chalk.cyan(`Folder: ${folderStreamState.folderPath}`));
-      console.log(chalk.cyan(`URL: http://127.0.0.1:${folderStreamState.port}/playlist`));
-      console.log('');
-      folderStreamState.files.forEach((f, i) => {
-        const sizeStr = (f.size / 1048576).toFixed(1) + ' MB';
-        const icon = f.type === 'audio' ? '♪' : '▶';
-        console.log(`  ${chalk.gray(String(i + 1).padStart(3))}  ${icon}  ${chalk.white(f.name)}  ${chalk.gray(sizeStr)}`);
-      });
-      console.log('');
-      console.log(chalk.gray(`${folderStreamState.files.length} files | Started ${folderStreamState.startedAt}`));
-    });
-}
-
-function showStatus() {
-  if (!streamState.type) {
-    console.log(chalk.gray('No active stream.'));
-    return;
-  }
-  console.log('');
-  console.log(chalk.cyan('Stream Status:'));
-  console.log(`  Type: ${chalk.yellow(streamState.type)}`);
-  console.log(`  File: ${chalk.white(streamState.fileName)}`);
-  if (streamState.port) console.log(`  URL: ${chalk.cyan(`http://127.0.0.1:${streamState.port}/stream`)}`);
-  if (streamState.magnet) console.log(`  Magnet: ${chalk.gray(streamState.magnet.slice(0, 60))}...`);
-  console.log(`  Started: ${chalk.gray(streamState.startedAt)}`);
-  if (streamState.broadcast) {
-    console.log(`  Broadcast: ${chalk.green('Active')}`);
-    if (streamState.broadcast.viewers !== undefined) console.log(`  Viewers: ${chalk.white(streamState.broadcast.viewers)}`);
-  }
-  if (folderStreamState.server) {
-    console.log('');
-    console.log(chalk.cyan('Folder Stream:'));
-    console.log(`  Folder: ${chalk.white(folderStreamState.folderPath)}`);
-    console.log(`  Files: ${chalk.white(folderStreamState.files.length)}`);
-    console.log(`  Playlist: ${chalk.cyan(`http://127.0.0.1:${folderStreamState.port}/playlist`)}`);
-    console.log(`  Started: ${chalk.gray(folderStreamState.startedAt)}`);
-  }
-}
-
-export { streamState, stopStream, folderStreamState, stopFolderStream, scanFolder };
+import chalk from 'chalk';
+import http from 'http';
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+
+let streamToken = null;
+
+let streamState = {
+  server: null,
+  port: null,
+  type: null,
+  filePath: null,
+  fileName: null,
+  magnet: null,
+  broadcast: null,
+  startedAt: null,
+};
+
+let folderStreamState = {
+  server: null,
+  port: null,
+  folderPath: null,
+  files: [],
+  startedAt: null,
+};
+
+const MEDIA_EXTS = new Set(['mp3', 'flac', 'wav', 'ogg', 'aac', 'm4a', 'mp4', 'mkv', 'webm', 'avi', 'mov']);
+const AUDIO_EXTS = new Set(['mp3', 'flac', 'wav', 'ogg', 'aac', 'm4a']);
+
+const MIME_TYPES = {
+  '.mp4': 'video/mp4',
+  '.webm': 'video/webm',
+  '.mkv': 'video/x-matroska',
+  '.avi': 'video/x-msvideo',
+  '.mp3': 'audio/mpeg',
+  '.flac': 'audio/flac',
+  '.ogg': 'audio/ogg',
+  '.wav': 'audio/wav',
+  '.m4a': 'audio/mp4',
+};
+
+function getMime(fileName) {
+  const ext = path.extname(fileName).toLowerCase();
+  return MIME_TYPES[ext] || 'application/octet-stream';
+}
+
+function startLocalServer(filePath) {
+  return new Promise((resolve, reject) => {
+    streamToken = crypto.randomBytes(16).toString('hex');
+    const fileName = path.basename(filePath);
+    const server = http.createServer((req, res) => {
+      res.setHeader('Access-Control-Allow-Origin', '*');
+      const reqUrl = new URL(req.url, `http://${req.headers.host}`);
+      if (reqUrl.searchParams.get('token') !== streamToken) {
+        res.writeHead(401);
+        res.end('Unauthorized');
+        return;
+      }
+      if (reqUrl.pathname !== '/stream') {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+
+      let fileSize;
+      try { fileSize = fs.statSync(filePath).size; } catch { res.writeHead(404); res.end(); return; }
+
+      const mime = getMime(fileName);
+      const range = req.headers.range;
+      if (range) {
+        const [startStr, endStr] = range.replace('bytes=', '').split('-');
+        const start = parseInt(startStr, 10);
+        const end = endStr ? parseInt(endStr, 10) : fileSize - 1;
+        res.writeHead(206, {
+          'Content-Range': `bytes ${start}-${end}/${fileSize}`,
+          'Accept-Ranges': 'bytes',
+          'Content-Length': end - start + 1,
+          'Content-Type': mime,
+        });
+        fs.createReadStream(filePath, { start, end }).pipe(res);
+      } else {
+        res.writeHead(200, {
+          'Content-Length': fileSize,
+          'Content-Type': mime,
+          'Accept-Ranges': 'bytes',
+        });
+        fs.createReadStream(filePath).pipe(res);
+      }
+    });
+
+    server.listen(0, '127.0.0.1', () => {
+      const port = server.address().port;
+      resolve({ server, port, token: streamToken });
+    });
+    server.on('error', reject);
+  });
+}
+
+function stopStream() {
+  if (streamState.server) {
+    streamState.server.close();
+  }
+  streamState = { server: null, port: null, type: null, filePath: null, fileName: null, magnet: null, broadcast: null, startedAt: null };
+}
+
+function scanFolder(dirPath, maxDepth = 5) {
+  const results = [];
+  function walk(dir, depth) {
+    if (depth > maxDepth || results.length >= 2000) return;
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const entry of entries) {
+      if (results.length >= 2000) return;
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory() && !entry.name.startsWith('.')) {
+        walk(fullPath, depth + 1);
+      } else if (entry.isFile()) {
+        const ext = entry.name.split('.').pop().toLowerCase();
+        if (MEDIA_EXTS.has(ext)) {
+          let size = 0;
+          try { size = fs.statSync(fullPath).size; } catch {}
+          results.push({
+            name: entry.name,
+            path: fullPath,
+            size,
+            type: AUDIO_EXTS.has(ext) ? 'audio' : 'video',
+          });
+        }
+      }
+    }
+  }
+  walk(dirPath, 0);
+  results.sort((a, b) => a.name.localeCompare(b.name));
+  return results;
+}
+
+function startFolderServer(folderPath, files) {
+  return new Promise((resolve, reject) => {
+    streamToken = crypto.randomBytes(16).toString('hex');
+    const server = http.createServer((req, res) => {
+      res.setHeader('Access-Control-Allow-Origin', '*');
+      const url = new URL(req.url, `http://${req.headers.host}`);
+
+      if (url.searchParams.get('token') !== streamToken) {
+        res.writeHead(401);
+        res.end('Unauthorized');
+        return;
+      }
+
+      if (url.pathname === '/playlist') {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(files.map(f => ({ name: f.name, path: f.path, size: f.size, type: f.type }))));
+        return;
+      }
+
+      if (url.pathname === '/stream') {
+        const fileName = url.searchParams.get('file');
+        if (!fileName) { res.writeHead(400); res.end('Missing file param'); return; }
+        const file = files.find(f => f.name === fileName);
+        if (!file) { res.writeHead(404); res.end('File not found'); return; }
+
+        let fileSize;
+        try { fileSize = fs.statSync(file.path).size; } catch { res.writeHead(404); res.end(); return; }
+
+        const mime = getMime(file.name);
+        const range = req.headers.range;
+        if (range) {
+          const [startStr, endStr] = range.replace('bytes=', '').split('-');
+          const start = parseInt(startStr, 10);
+          const end = endStr ? parseInt(endStr, 10) : fileSize - 1;
+          res.writeHead(206, {
+            'Content-Range': `bytes ${start}-${end}/${fileSize}`,
+            'Accept-Ranges': 'bytes',
+            'Content-Length': end - start + 1,
+            'Content-Type': mime,
+          });
+          fs.createReadStream(file.path, { start, end }).pipe(res);
+        } else {
+          res.writeHead(200, {
+            'Content-Length': fileSize,
+            'Content-Type': mime,
+            'Accept-Ranges': 'bytes',
+          });
+          fs.createReadStream(file.path).pipe(res);
+        }
+        return;
+      }
+
+      res.writeHead(404);
+      res.end();
+    });
+
+    server.listen(0, '127.0.0.1', () => {
+      resolve({ server, port: server.address().port, token: streamToken });
+    });
+    server.on('error', reject);
+  });
+}
+
+function stopFolderStream() {
+  if (folderStreamState.server) {
+    folderStreamState.server.close();
+  }
+  folderStreamState = { server: null, port: null, folderPath: null, files: [], startedAt: null };
+}
+
+export default function streamCommand(program) {
+  const cmd = program
+    .command('stream')
+    .description('stream media files locally or from the network')
+    .addHelpText('after', `
+Examples:
+  $ pal stream local /path/to/video.mp4   Stream a local file via HTTP
+  $ pal stream remote magnet:?xt=...      Stream a remote file from magnet
+  $ pal stream stop                       Stop current stream
+  $ pal stream status                     Show current stream info
+  $ pal stream broadcast /path/to/file    Start a broadcast session
+  $ pal stream join magnet:?xt=...        Join a broadcast
+  $ pal stream folder /path/to/music      Serve a folder as a media library
+  $ pal stream playlist                   Show current folder playlist
+`)
+    .action(() => {
+      showStatus();
+    });
+
+  cmd
+    .command('local <file>')
+    .description('stream a local file (starts HTTP server)')
+    .action(async (file) => {
+      const filePath = path.resolve(file);
+      if (!fs.existsSync(filePath)) {
+        console.log(chalk.red('File not found.'));
+        process.exitCode = 1;
+        return;
+      }
+
+      stopStream();
+      try {
+        const { server, port } = await startLocalServer(filePath);
+        streamState = {
+          server,
+          port,
+          type: 'local',
+          filePath,
+          fileName: path.basename(filePath),
+          magnet: null,
+          broadcast: null,
+          startedAt: new Date().toISOString(),
+        };
+        console.log(chalk.green(`Streaming: ${streamState.fileName}`));
+        console.log(`  Local:  ${chalk.cyan(`http://127.0.0.1:${port}/stream?token=${streamToken}`)}`);
+        console.log(chalk.gray(`  Token:  ${streamToken}`));
+        console.log(chalk.gray('Press Ctrl+C to stop.'));
+      } catch (err) {
+        console.log(chalk.red(`Failed to start stream: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('remote <magnet>')
+    .description('stream a remote file from magnet link')
+    .action(async (magnet) => {
+      stopStream();
+      try {
+        const WebTorrent = (await import('webtorrent')).default;
+        const client = new WebTorrent();
+        const torrent = await new Promise((resolve, reject) => {
+          const t = client.add(magnet);
+          t.on('ready', () => resolve(t));
+          t.on('error', reject);
+          setTimeout(() => reject(new Error('Torrent timeout')), 30000);
+        });
+
+        const file = torrent.files[0];
+        console.log(chalk.green(`Streaming remote: ${file.name}`));
+        console.log(`  Size: ${chalk.white((file.length / 1048576).toFixed(1))} MB`);
+
+        streamState = {
+          server: client,
+          port: null,
+          type: 'remote',
+          filePath: null,
+          fileName: file.name,
+          magnet,
+          broadcast: null,
+          startedAt: new Date().toISOString(),
+        };
+      } catch (err) {
+        console.log(chalk.red(`Failed to stream: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('stop')
+    .description('stop the current stream')
+    .action(() => {
+      if (!streamState.type) {
+        console.log(chalk.gray('No active stream.'));
+        return;
+      }
+      const name = streamState.fileName;
+      stopStream();
+      console.log(chalk.green(`Stream stopped: ${name}`));
+    });
+
+  cmd
+    .command('status')
+    .description('show current stream status')
+    .action(() => {
+      showStatus();
+    });
+
+  cmd
+    .command('broadcast <file>')
+    .description('start a broadcast session for a file')
+    .action(async (file) => {
+      const filePath = path.resolve(file);
+      if (!fs.existsSync(filePath)) {
+        console.log(chalk.red('File not found.'));
+        process.exitCode = 1;
+        return;
+      }
+
+      stopStream();
+      try {
+        const { server, port } = await startLocalServer(filePath);
+        streamState = {
+          server,
+          port,
+          type: 'broadcast',
+          filePath,
+          fileName: path.basename(filePath),
+          magnet: null,
+          broadcast: { hostStartedAt: new Date().toISOString(), viewers: 0 },
+          startedAt: new Date().toISOString(),
+        };
+        console.log(chalk.green(`Broadcasting: ${streamState.fileName}`));
+        console.log(`  URL: ${chalk.cyan(`http://127.0.0.1:${port}/stream?token=${streamToken}`)}`);
+        console.log(chalk.gray('Share the URL with your pals to let them watch.'));
+      } catch (err) {
+        console.log(chalk.red(`Failed to start broadcast: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('join <magnet>')
+    .description('join a broadcast via magnet link')
+    .action(async (magnet) => {
+      stopStream();
+      try {
+        const WebTorrent = (await import('webtorrent')).default;
+        const client = new WebTorrent();
+        const torrent = await new Promise((resolve, reject) => {
+          const t = client.add(magnet);
+          t.on('ready', () => resolve(t));
+          t.on('error', reject);
+          setTimeout(() => reject(new Error('Torrent timeout')), 30000);
+        });
+
+        const file = torrent.files[0];
+        console.log(chalk.green(`Joined broadcast: ${file.name}`));
+        console.log(`  Peers: ${chalk.white(torrent.numPeers)}`);
+
+        streamState = {
+          server: client,
+          port: null,
+          type: 'joined-broadcast',
+          filePath: null,
+          fileName: file.name,
+          magnet,
+          broadcast: { hostHandle: null },
+          startedAt: new Date().toISOString(),
+        };
+      } catch (err) {
+        console.log(chalk.red(`Failed to join broadcast: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('transport')
+    .description('show or configure stream transport settings')
+    .option('--set <type>', 'Set preferred transport: p2p, relay, tunnel')
+    .option('--stun-add <url>', 'Add custom STUN server')
+    .option('--stun-remove <url>', 'Remove custom STUN server')
+    .option('--turn-add <json>', 'Add custom TURN server (JSON: {"urls":"turn:host:3478","username":"u","credential":"p"})')
+    .option('--turn-remove <url>', 'Remove custom TURN server by URL')
+    .option('--tunnel <url>', 'Set custom tunnel URL (cloudflared, ngrok, etc.)')
+    .action(async (opts) => {
+      const { getTransportConfig, setTransportConfig } = await import('../core/streamTransport.js');
+
+      if (opts.set) {
+        const valid = ['p2p', 'relay', 'tunnel'];
+        if (!valid.includes(opts.set)) {
+          console.log(chalk.red(`Invalid transport. Options: ${valid.join(', ')}`));
+          process.exitCode = 1;
+          return;
+        }
+        setTransportConfig({ preferred: opts.set });
+        console.log(chalk.green(`Transport set to: ${opts.set}`));
+        return;
+      }
+
+      if (opts.stunAdd) {
+        const tc = getTransportConfig();
+        if (!tc.customStunServers.includes(opts.stunAdd)) {
+          tc.customStunServers.push(opts.stunAdd);
+          setTransportConfig({ customStunServers: tc.customStunServers });
+        }
+        console.log(chalk.green(`Added STUN: ${opts.stunAdd}`));
+        return;
+      }
+
+      if (opts.stunRemove) {
+        const tc = getTransportConfig();
+        tc.customStunServers = tc.customStunServers.filter(s => s !== opts.stunRemove);
+        setTransportConfig({ customStunServers: tc.customStunServers });
+        console.log(chalk.green(`Removed STUN: ${opts.stunRemove}`));
+        return;
+      }
+
+      if (opts.turnAdd) {
+        try {
+          const turn = JSON.parse(opts.turnAdd);
+          if (!turn.urls) throw new Error('Missing "urls"');
+          const tc = getTransportConfig();
+          tc.customTurnServers.push(turn);
+          setTransportConfig({ customTurnServers: tc.customTurnServers });
+          console.log(chalk.green(`Added TURN: ${turn.urls}`));
+        } catch (err) {
+          console.log(chalk.red(`Invalid JSON: ${err.message}`));
+          process.exitCode = 1;
+        }
+        return;
+      }
+
+      if (opts.turnRemove) {
+        const tc = getTransportConfig();
+        tc.customTurnServers = tc.customTurnServers.filter(t => t.urls !== opts.turnRemove);
+        setTransportConfig({ customTurnServers: tc.customTurnServers });
+        console.log(chalk.green(`Removed TURN: ${opts.turnRemove}`));
+        return;
+      }
+
+      if (opts.tunnel) {
+        setTransportConfig({ tunnelUrl: opts.tunnel });
+        console.log(chalk.green(`Tunnel URL set to: ${opts.tunnel}`));
+        return;
+      }
+
+      // Show current config
+      const tc = getTransportConfig();
+      console.log('');
+      console.log(chalk.cyan('Stream Transport Config:'));
+      console.log(`  Preferred: ${chalk.yellow(tc.preferred)}`);
+      console.log(`  STUN servers (built-in): ${chalk.white(tc.stunServers.join(', ') || 'none')}`);
+      console.log(`  STUN servers (custom):   ${chalk.white(tc.customStunServers.join(', ') || 'none')}`);
+      console.log(`  TURN servers (custom):   ${chalk.white(tc.customTurnServers.map(t => t.urls).join(', ') || 'none')}`);
+      console.log(`  TURN server (default):   ${chalk.gray(tc.turnServer)}`);
+      console.log(`  Tunnel URL:              ${chalk.white(tc.tunnelUrl || 'not set')}`);
+      console.log('');
+      console.log(chalk.gray('  Transport options:'));
+      console.log(chalk.gray('    p2p    — WebRTC peer-to-peer (default, best privacy)'));
+      console.log(chalk.gray('    relay  — Through palexplorer relay server'));
+      console.log(chalk.gray('    tunnel — Through your own tunnel (cloudflared, ngrok, etc.)'));
+    });
+  cmd
+    .command('folder <path>')
+    .description('serve a folder as a streamable media library')
+    .action(async (folderPath) => {
+      const resolved = path.resolve(folderPath);
+      if (!fs.existsSync(resolved)) {
+        console.log(chalk.red('Folder not found.'));
+        process.exitCode = 1;
+        return;
+      }
+      const stat = fs.statSync(resolved);
+      if (!stat.isDirectory()) {
+        console.log(chalk.red('Path is not a directory.'));
+        process.exitCode = 1;
+        return;
+      }
+
+      console.log(chalk.gray('Scanning folder...'));
+      const files = scanFolder(resolved);
+      if (files.length === 0) {
+        console.log(chalk.red('No media files found.'));
+        process.exitCode = 1;
+        return;
+      }
+
+      stopFolderStream();
+      try {
+        const { server, port } = await startFolderServer(resolved, files);
+        folderStreamState = { server, port, folderPath: resolved, files, startedAt: new Date().toISOString() };
+
+        const audio = files.filter(f => f.type === 'audio').length;
+        const video = files.filter(f => f.type === 'video').length;
+        console.log(chalk.green(`Serving ${files.length} files (${audio} audio, ${video} video)`));
+        console.log(`  Playlist: ${chalk.cyan(`http://127.0.0.1:${port}/playlist?token=${streamToken}`)}`);
+        console.log(`  Stream:   ${chalk.cyan(`http://127.0.0.1:${port}/stream?file=<name>&token=${streamToken}`)}`);
+        console.log(chalk.gray(`  Token:    ${streamToken}`));
+        console.log(chalk.gray('Press Ctrl+C to stop.'));
+      } catch (err) {
+        console.log(chalk.red(`Failed to start folder stream: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('playlist')
+    .description('show current folder stream playlist')
+    .action(() => {
+      if (!folderStreamState.server) {
+        console.log(chalk.gray('No folder stream active.'));
+        return;
+      }
+      console.log('');
+      console.log(chalk.cyan(`Folder: ${folderStreamState.folderPath}`));
+      console.log(chalk.cyan(`URL: http://127.0.0.1:${folderStreamState.port}/playlist`));
+      console.log('');
+      folderStreamState.files.forEach((f, i) => {
+        const sizeStr = (f.size / 1048576).toFixed(1) + ' MB';
+        const icon = f.type === 'audio' ? '♪' : '▶';
+        console.log(`  ${chalk.gray(String(i + 1).padStart(3))}  ${icon}  ${chalk.white(f.name)}  ${chalk.gray(sizeStr)}`);
+      });
+      console.log('');
+      console.log(chalk.gray(`${folderStreamState.files.length} files | Started ${folderStreamState.startedAt}`));
+    });
+}
+
+function showStatus() {
+  if (!streamState.type) {
+    console.log(chalk.gray('No active stream.'));
+    return;
+  }
+  console.log('');
+  console.log(chalk.cyan('Stream Status:'));
+  console.log(`  Type: ${chalk.yellow(streamState.type)}`);
+  console.log(`  File: ${chalk.white(streamState.fileName)}`);
+  if (streamState.port) console.log(`  URL: ${chalk.cyan(`http://127.0.0.1:${streamState.port}/stream`)}`);
+  if (streamState.magnet) console.log(`  Magnet: ${chalk.gray(streamState.magnet.slice(0, 60))}...`);
+  console.log(`  Started: ${chalk.gray(streamState.startedAt)}`);
+  if (streamState.broadcast) {
+    console.log(`  Broadcast: ${chalk.green('Active')}`);
+    if (streamState.broadcast.viewers !== undefined) console.log(`  Viewers: ${chalk.white(streamState.broadcast.viewers)}`);
+  }
+  if (folderStreamState.server) {
+    console.log('');
+    console.log(chalk.cyan('Folder Stream:'));
+    console.log(`  Folder: ${chalk.white(folderStreamState.folderPath)}`);
+    console.log(`  Files: ${chalk.white(folderStreamState.files.length)}`);
+    console.log(`  Playlist: ${chalk.cyan(`http://127.0.0.1:${folderStreamState.port}/playlist`)}`);
+    console.log(`  Started: ${chalk.gray(folderStreamState.startedAt)}`);
+  }
+}
+
+export { streamState, stopStream, folderStreamState, stopFolderStream, scanFolder };