eva-md 0.0.0-stage → 0.3.2

package/eva.js

@@ -0,0 +1,1748 @@
+#!/usr/bin/env node
+/**
+ * EVA.md v0.3.2 — EVA Media Downloader by .maxon
+ * Pure Node.js Interactive TUI (Zero external npm dependencies!)
+ * Works just like Gemini CLI (`node eva.js` or `./eva.js`), with full mouse & keyboard support.
+ *
+ * Supported Sources (1-9):
+ *   01. Авто             05. Mixcloud          09. Internet Archive
+ *   02. YouTube / Music  06. Audiomack
+ *   03. Bandcamp         07. Audius
+ *   04. SoundCloud       08. ВКонтакте (VK)
+ *
+ * Integrated yt-dlp Flags ("Buttons" / Interactive Controls):
+ *   Audio (Музыка):
+ *     -x                         Extract audio only
+ *     --audio-format <fmt>       mp3, flac, m4a, wav
+ *     --audio-quality <q>        0 (best), 320K, 192K, 128K
+ *     --embed-metadata           Embed artist, title, album tags
+ *     --embed-thumbnail          Embed album art into audio file
+ *   Video (Видео):
+ *     -f "bv*+ba/b"              Download best video + best audio & merge
+ *     --write-subs               Download subtitles file
+ *     --embed-subs               Embed subtitles into media container
+ *     --write-thumbnail          Save thumbnail as a separate image file
+ *   File Naming & Archive (Именование файлов):
+ *     -o "<template>"            Output template (e.g. "%(playlist_index)s. %(title)s.%(ext)s")
+ *     --download-archive <file>  Record downloaded track IDs in archive.txt
+ *   Playlists (Плейлисты):
+ *     --playlist-items <range>   Download specific items (e.g. "1-5")
+ *     --playlist-reverse         Download playlist in reverse order
+ *   Network & Bypass (Сеть и обход блокировок — во вкладке Settings):
+ *     -4                         Force IPv4 connection (fixes DNS issues)
+ *     --proxy <url>              Use HTTP/SOCKS proxy (e.g. http://127.0.0.1:8080)
+ *     --cookies-from-browser <b> Extract cookies from browser (chrome, firefox, edge, brave, safari)
+ */
+
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { StringDecoder } = require('string_decoder');
+const { spawn, spawnSync } = require('child_process');
+
+// ---------------------------------------------------------------------------
+// Constants & Configuration
+// ---------------------------------------------------------------------------
+
+const APP_VERSION = 'v0.3.2 (Node.js)';
+const CONFIG_PATH = path.join(os.homedir(), '.config', 'eva_md', 'config.json');
+
+// Strictly 1-cell narrow glyphs (CP437/WGL4 safe) so Windows Terminal / PowerShell NEVER shifts borders!
+const SOURCES = [
+  { id: 1, code: '01', icon: '*', name: 'Авто', domain: '', hint: 'URL любого поддерживаемого сервиса' },
+  { id: 2, code: '02', icon: '►', name: 'YouTube / Music', domain: 'youtube.com', hint: 'https://www.youtube.com/watch?v=... или https://music.youtube.com/watch?v=...' },
+  { id: 3, code: '03', icon: '♦', name: 'Bandcamp', domain: 'bandcamp.com', hint: 'https://artist.bandcamp.com/album/...' },
+  { id: 4, code: '04', icon: '≈', name: 'SoundCloud', domain: 'soundcloud.com', hint: 'https://soundcloud.com/artist/track' },
+  { id: 5, code: '05', icon: 'ʍ', name: 'Mixcloud', domain: 'mixcloud.com', hint: 'https://www.mixcloud.com/artist/show/' },
+  { id: 6, code: '06', icon: '~', name: 'Audiomack', domain: 'audiomack.com', hint: 'https://audiomack.com/artist/song/...' },
+  { id: 7, code: '07', icon: 'Δ', name: 'Audius', domain: 'audius.co', hint: 'https://audius.co/artist/track' },
+  { id: 8, code: '08', icon: 'V', name: 'ВКонтакте (VK)', domain: 'vk.com', hint: 'https://vk.com/audio... or https://vkvideo.ru/...' },
+  { id: 9, code: '09', icon: '⌂', name: 'Internet Archive', domain: 'archive.org', hint: 'https://archive.org/details/...' },
+];
+
+const AUDIO_FORMATS = ['mp3', 'm4a', 'flac', 'wav'];
+const AUDIO_QUALITIES = [
+  { label: 'best', val: '0' },
+  { label: '320k', val: '320K' },
+  { label: '192k', val: '192K' },
+  { label: '128k', val: '128K' },
+];
+const BROWSERS = ['none', 'chrome', 'firefox', 'edge', 'brave', 'opera', 'vivaldi', 'safari'];
+
+const NAMING_PRESETS = [
+  { label: 'Плейлист: 01. Название файла.mp4(формат)', tpl: '%(playlist_index)s. %(title)s.%(ext)s' }, 
+  { label: 'Стандарт: Название файла.mp4(формат)', tpl: '%(title)s.%(ext)s' },
+  { label: 'Автор - Название: Автор - Название.mp4(формат)', tpl: '%(uploader)s - %(title)s.%(ext)s' },
+];
+
+const ASCII_LOGO = [
+  '███████╗██╗   ██╗ █████╗                         ⠀⠨⣔⢺⢿⡿⠟⠛⠋⠩⠥⠄⠀⠌⠉⠝⠻⠿⣿⣿⣷⣿⣿⣳⡀',
+  '██╔════╝██║   ██║██╔══██╗     ███╗ ███╗ ██████╗⠀⠀ ⢳⣭⢯⡆⠁⠠⠀⢀⣠⣤⠀⠀⠈⠀⠀⠈⡑⢬⢻⣿⣿⣿⣿⣧⡂⠌⠀ ',
+  '█████╗  ╚██╗ ██╔╝███████║    ██╔████╔██╗██╔══██╗ ⠈⠲⣽⣻⣽⢦⠀⠠⠝⣿⣷⡀⠀⠶⠂⠀⣸⣿⣟⠕⢼⣿⣿⣿⢿⢦',
+  '██╔══╝   ╚████╔╝ ██╔══██║    ██║╚██╔╝██║██║  ██║   ⢣⣼⣻⣿⣟⢇⠀⡜⠤⠻⢿⣄⣀⣀⠼⢟⡻⣃⠀⠘⣿⣿⠟',
+  '███████╗  ╚██╔╝  ██║  ██║ ██╗██║ ╚═╝ ██║██████╔╝    ⠐⢮⡿⣽⣿⣿⣞⡵⢢⣌⣦⣕⣢⣬⣧⣺⣿⣿⣿⣿⠝',
+  '╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═╝╚═╝     ╚═╝╚═════╝        ⠲⠕⠻⢿⣿⡻⣿⢯⢟⡿⢯⠟⠛⠻⠝⠋',
+];
+
+// ANSI Styling Helpers
+const CSI = '\x1b[';
+const ANSI = {
+  reset: `${CSI}0m`,
+  bold: `${CSI}1m`,
+  dim: `${CSI}2m`,
+  fgWhite: `${CSI}37m`,
+  fgCyan: `${CSI}38;2;8;128;128m`,
+  fgGreen: `${CSI}32m`,
+  fgYellow: `${CSI}33m`,
+  fgRed: `${CSI}31m`,
+  fgBlack: `${CSI}30m`,
+  fgGray: `${CSI}38;2;105;105;105m`,
+  fgOrange: `${CSI}38;2;222;91;9m`,   // Текст цвета RGB(222, 91, 9)
+  bgOrange: `${CSI}48;2;222;91;9m`,
+  bgGray: `${CSI}48;2;105;105;105m`, 
+  bgWhite: `${CSI}47m`,
+  bgCyan: `${CSI}46m`,
+  hideCursor: `${CSI}?25l`,
+  showCursor: `${CSI}?25h`,
+  altScreenOn: `${CSI}?1049h`,
+  altScreenOff: `${CSI}?1049l`,
+  mouseOn: `${CSI}?1000h${CSI}?1006h`,
+  mouseOff: `${CSI}?1000l${CSI}?1006l`,
+  clearScreen: `${CSI}2J${CSI}H`,
+};
+
+function whichBinary(binName) {
+  const cmd = process.platform === 'win32' ? 'where' : 'which';
+  const res = spawnSync(cmd, [binName], { encoding: 'utf8' });
+  if (res.status === 0 && res.stdout) {
+    return res.stdout.trim().split(/\r?\n/)[0];
+  }
+  try {
+    const bundledPath = binName === 'yt-dlp'
+      ? require('youtube-dl-exec').constants.YOUTUBE_DL_PATH
+      : binName === 'ffmpeg'
+      ? require('ffmpeg-static')
+      : null;
+    if (typeof bundledPath === 'string' && fs.existsSync(bundledPath)) {
+      return bundledPath;
+    }
+  } catch (_) {}
+  return null;
+}
+
+function shellQuote(arg) {
+  if (/[\s*%"'\\]/.test(arg)) {
+    return `"${arg.replace(/"/g, '\\"')}"`;
+  }
+  return arg;
+}
+
+function formatBytesToMB(bytes) {
+  if (!bytes || bytes <= 0) return '—';
+  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+
+function wrapTextByWords(text, maxWidth) {
+  if (maxWidth <= 10) return [text.slice(0, Math.max(1, maxWidth))];
+  const words = String(text).split(' ');
+  const lines = [];
+  let cur = '';
+
+  for (const w of words) {
+    if (!cur) {
+      if (w.length <= maxWidth) {
+        cur = w;
+      } else {
+        let rem = w;
+        while (rem.length > maxWidth) {
+          lines.push(rem.slice(0, maxWidth));
+          rem = '  ' + rem.slice(maxWidth);
+        }
+        cur = rem;
+      }
+    } else if (cur.length + 1 + w.length <= maxWidth) {
+      cur += ' ' + w;
+    } else {
+      lines.push(cur);
+      const indented = '  ' + w;
+      if (indented.length <= maxWidth) {
+        cur = indented;
+      } else {
+        let rem = indented;
+        while (rem.length > maxWidth) {
+          lines.push(rem.slice(0, maxWidth));
+          rem = '  ' + rem.slice(maxWidth);
+        }
+        cur = rem;
+      }
+    }
+  }
+  if (cur) lines.push(cur);
+  return lines;
+}
+
+// ---------------------------------------------------------------------------
+// Options & Command Builder
+// ---------------------------------------------------------------------------
+
+function createDefaultOptions() {
+  return {
+    sourceId: 1,
+    url: '',
+    outputDir: path.join(os.homedir(), 'Downloads'),
+
+    // Audio (Музыка)
+    extractAudio: true,                 // -x
+    audioFormat: 'mp3',                 // --audio-format mp3|flac|m4a|wav
+    audioQuality: '0',                  // --audio-quality 0|320K|128K
+    embedMetadata: true,                // --embed-metadata
+    embedThumbnail: true,               // --embed-thumbnail
+
+    // Video (Видео)
+    bestVideoMerge: false,              // -f "bv*+ba/b"
+    writeSubs: false,                   // --write-subs
+    embedSubs: false,                   // --embed-subs
+    writeThumbnail: false,              // --write-thumbnail
+
+    // Naming & Archive (Именование файлов)
+    usePlaylistTemplate: true,          // -o "%(playlist_index)s. %(title)s.%(ext)s"
+    outputTemplate: '%(playlist_index)s. %(title)s.%(ext)s',
+    useDownloadArchive: false,          // --download-archive archive.txt
+    archiveFile: 'archive.txt',
+
+    // Playlists (Плейлисты)
+    usePlaylistItems: false,            // --playlist-items 1-5
+    playlistItems: '1-5',
+    playlistReverse: false,             // --playlist-reverse
+
+    // Network & Bypass (Сеть и обход блокировок — во вкладке Settings)
+    forceIpv4: false,                   // -4
+    useProxy: false,                    // --proxy http://127.0.0.1:8080
+    proxyUrl: 'http://127.0.0.1:8080',
+    useCookiesBrowser: false,           // --cookies-from-browser chrome
+    cookiesBrowser: 'chrome',
+  };
+}
+
+function loadSavedOptions() {
+  const opts = createDefaultOptions();
+  try {
+    if (fs.existsSync(CONFIG_PATH)) {
+      const raw = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
+      Object.assign(opts, raw);
+    }
+  } catch (_) {}
+  return opts;
+}
+
+function buildYtdlpArgs(opts, targetUrl = null) {
+  // Force UTF-8 output from yt-dlp so Russian/Cyrillic track titles never become '?' on Windows!
+  const args = ['--newline', '--progress', '--encoding', 'utf-8'];
+
+  // Audio vs Video
+  if (opts.extractAudio && !opts.bestVideoMerge) {
+    args.push('-x');
+    args.push('--audio-format', opts.audioFormat);
+    args.push('--audio-quality', opts.audioQuality);
+  } else if (opts.bestVideoMerge) {
+    args.push('-f', 'bv*+ba/b');
+	args.push('--merge-output-format', 'mp4');
+    if (opts.extractAudio) {
+      args.push('-x');
+      args.push('--audio-format', opts.audioFormat);
+      args.push('--audio-quality', opts.audioQuality);
+    }
+  }
+
+  // Metadata, Thumbnails & Subtitles
+  if (opts.embedMetadata) args.push('--embed-metadata');
+  if (opts.embedThumbnail) args.push('--embed-thumbnail');
+  if (opts.writeSubs) args.push('--write-subs');
+  if (opts.embedSubs) args.push('--embed-subs');
+  if (opts.writeThumbnail) args.push('--write-thumbnail');
+
+  // File Naming & Archive
+  const outDir = opts.outputDir.replace(/^~(?=$|\/|\\)/, os.homedir());
+  const tpl = opts.usePlaylistTemplate ? opts.outputTemplate : '%(title)s.%(ext)s';
+  args.push('-o', path.join(outDir, tpl));
+
+  if (opts.useDownloadArchive && opts.archiveFile.trim()) {
+    args.push('--download-archive', path.join(outDir, opts.archiveFile.trim()));
+  }
+
+  // Playlists
+  if (opts.usePlaylistItems && opts.playlistItems.trim()) {
+    args.push('--playlist-items', opts.playlistItems.trim());
+  }
+  if (opts.playlistReverse) {
+    args.push('--playlist-reverse');
+  }
+
+  // Network & Bypass
+  if (opts.forceIpv4) {
+    args.push('-4');
+  }
+  if (opts.useProxy && opts.proxyUrl.trim()) {
+    args.push('--proxy', opts.proxyUrl.trim());
+  }
+  if (opts.useCookiesBrowser && opts.cookiesBrowser && opts.cookiesBrowser !== 'none') {
+    args.push('--cookies-from-browser', opts.cookiesBrowser);
+  }
+
+  const ffmpegPath = whichBinary('ffmpeg');
+  if (ffmpegPath) {
+    args.push('--ffmpeg-location', path.dirname(ffmpegPath));
+  }
+
+  const urlToUse = (targetUrl !== null ? targetUrl : opts.url).trim();
+  if (urlToUse) {
+    args.push(urlToUse);
+  }
+  return args;
+}
+
+function buildCommandPreview(opts) {
+  const url = opts.url.trim() ? opts.url.trim() : '<URL>';
+  const args = buildYtdlpArgs(opts, url);
+  return 'yt-dlp ' + args.map(shellQuote).join(' ');
+}
+
+function detectSource(url, defaultId = 1) {
+  const low = (url || '').toLowerCase();
+  if (low.includes('music.youtube.com')) return { id: 2, name: 'YouTube Music' };
+  if (low.includes('youtube.com') || low.includes('youtu.be')) return { id: 2, name: 'YouTube' };
+  if (low.includes('bandcamp.com')) return { id: 3, name: 'Bandcamp' };
+  if (low.includes('soundcloud.com')) return { id: 4, name: 'SoundCloud' };
+  if (low.includes('mixcloud.com')) return { id: 5, name: 'Mixcloud' };
+  if (low.includes('audiomack.com')) return { id: 6, name: 'Audiomack' };
+  if (low.includes('audius.co')) return { id: 7, name: 'Audius' };
+  if (low.includes('vk.com') || low.includes('vkvideo.ru')) return { id: 8, name: 'ВКонтакте (VK)' };
+  if (low.includes('archive.org')) return { id: 9, name: 'Internet Archive' };
+  const found = SOURCES.find((s) => s.id === defaultId) || SOURCES[0];
+  return { id: found.id, name: found.name };
+}
+
+// ---------------------------------------------------------------------------
+// Download Manager (Subprocess Spawner & Real-Time Progress Parser)
+// ---------------------------------------------------------------------------
+
+class DownloadManager {
+  constructor(simulateIfMissing = false, onUpdate = () => {}) {
+    this.items = [];
+    this.nextId = 1;
+    this.ytdlpPath = whichBinary('yt-dlp');
+    this.ffmpegPath = whichBinary('ffmpeg');
+    this.simulateIfMissing = simulateIfMissing;
+    this.onUpdate = onUpdate;
+
+    this.progressRe = /\[download\]\s+(\d+(?:\.\d+)?)%\s+of\s+~?(\S+)(?:\s+at\s+(\S+))?(?:\s+ETA\s+(\S+))?/;
+    this.destRe = /\[(?:download|ExtractAudio|Merger)\]\s+Destination:\s+(.+)/;
+    this.alreadyRe = /\[download\]\s+(.+?)\s+has already been downloaded/;
+    this.mergerRe = /\[Merger\]\s+Merging formats into\s+"(.+?)"/;
+  }
+
+  addTask(opts, startImmediately = true) {
+    const url = opts.url.trim();
+    const src = detectSource(url, opts.sourceId);
+    const fmt = opts.bestVideoMerge && !opts.extractAudio ? 'mp4/mkv' : opts.audioFormat;
+    const outDir = opts.outputDir.replace(/^~(?=$|\/|\\)/, os.homedir());
+    const cmdArgs = buildYtdlpArgs(opts, url);
+
+    let shortTitle = url.replace(/^https?:\/\//, '');
+    const item = {
+      id: this.nextId++,
+      url,
+      title: `[${src.name}] ${shortTitle.slice(0, 44)}`,
+      sourceName: src.name,
+      fmt,
+      outDir,
+      destFile: '',
+      sizeStr: '—',
+      progress: 0,
+      speedStr: '',
+      etaStr: '',
+      status: 'Queued',
+      cmdArgs,
+      errorMsg: '',
+      proc: null,
+      simTimer: null,
+      logLines: [],
+    };
+    this.items.push(item);
+    if (startImmediately) {
+      this.startItem(item);
+    }
+    this.onUpdate();
+    return item;
+  }
+
+  _updateFinalFileSize(item) {
+    if (item.destFile) {
+      try {
+        if (fs.existsSync(item.destFile)) {
+          const st = fs.statSync(item.destFile);
+          if (st.isFile() && st.size > 0) {
+            item.sizeStr = formatBytesToMB(st.size);
+            item.title = path.basename(item.destFile, path.extname(item.destFile));
+            return;
+          }
+        }
+        const dir = path.dirname(item.destFile);
+        const stem = path.basename(item.destFile, path.extname(item.destFile));
+        if (fs.existsSync(dir)) {
+          const candidates = fs
+            .readdirSync(dir)
+            .filter((name) => path.basename(name, path.extname(name)) === stem)
+            .map((name) => {
+              const full = path.join(dir, name);
+              return { name, full, stat: fs.statSync(full) };
+            })
+            .filter((f) => f.stat.isFile() && !f.name.endsWith('.part') && !f.name.endsWith('.ytdl'))
+            .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs);
+          if (candidates.length > 0) {
+            item.destFile = candidates[0].full;
+            item.sizeStr = formatBytesToMB(candidates[0].stat.size);
+            item.title = path.basename(candidates[0].full, path.extname(candidates[0].full));
+            return;
+          }
+        }
+      } catch (_) {}
+    }
+
+    if (item.outDir && fs.existsSync(item.outDir)) {
+      try {
+        const exts = new Set(['.mp3', '.m4a', '.flac', '.wav', '.mp4', '.mkv', '.webm', '.opus', '.ogg']);
+        const recent = fs
+          .readdirSync(item.outDir)
+          .map((name) => {
+            const full = path.join(item.outDir, name);
+            return { name, full, stat: fs.statSync(full), ext: path.extname(name).toLowerCase() };
+          })
+          .filter((f) => f.stat.isFile() && exts.has(f.ext) && Date.now() - f.stat.mtimeMs < 60000)
+          .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs);
+        if (recent.length > 0) {
+          item.destFile = recent[0].full;
+          item.sizeStr = formatBytesToMB(recent[0].stat.size);
+          item.title = path.basename(recent[0].full, path.extname(recent[0].full));
+        }
+      } catch (_) {}
+    }
+  }
+
+  startItem(item) {
+    if (item.status === 'Downloading') return;
+    item.status = 'Downloading';
+    item.errorMsg = '';
+
+    const oIdx = item.cmdArgs.indexOf('-o');
+    if (oIdx !== -1 && item.cmdArgs[oIdx + 1]) {
+      const dir = path.dirname(item.cmdArgs[oIdx + 1]);
+      item.outDir = dir;
+      try {
+        fs.mkdirSync(dir, { recursive: true });
+      } catch (_) {}
+    }
+
+    if (!this.ytdlpPath) {
+      if (this.simulateIfMissing) {
+        this._simulateDownload(item);
+      } else {
+        item.status = 'Error';
+        item.errorMsg = 'yt-dlp not found in PATH';
+        item.logLines.push('Error: yt-dlp binary not found. Install via brew/apt/winget or download standalone binary.');
+      }
+      this.onUpdate();
+      return;
+    }
+
+    const childEnv = Object.assign({}, process.env, {
+      PYTHONIOENCODING: 'utf-8',
+      PYTHONUTF8: '1',
+      LANG: 'en_US.UTF-8',
+      LC_ALL: 'en_US.UTF-8',
+    });
+
+    const proc = spawn(this.ytdlpPath, item.cmdArgs, {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: childEnv,
+    });
+    item.proc = proc;
+
+    const handleLine = (line) => {
+      const trimmed = line.trim();
+      if (!trimmed) return;
+      item.logLines.push(trimmed);
+      if (item.logLines.length > 200) item.logLines.shift();
+
+      const mDest = this.destRe.exec(trimmed) || this.mergerRe.exec(trimmed) || this.alreadyRe.exec(trimmed);
+      if (mDest) {
+        const destPath = mDest[1].trim().replace(/^"|"$/g, '');
+        item.destFile = destPath;
+        item.title = path.basename(destPath, path.extname(destPath));
+      }
+
+      const mProg = this.progressRe.exec(trimmed);
+      if (mProg) {
+        item.progress = parseFloat(mProg[1]) || item.progress;
+        const rawSz = mProg[2] || '';
+        if (rawSz) {
+          const mibMatch = /^(\d+(?:\.\d+)?)MiB$/i.exec(rawSz);
+          const kibMatch = /^(\d+(?:\.\d+)?)KiB$/i.exec(rawSz);
+          if (mibMatch) {
+            const bytes = parseFloat(mibMatch[1]) * 1024 * 1024;
+            item.sizeStr = formatBytesToMB(bytes);
+          } else if (kibMatch) {
+            const bytes = parseFloat(kibMatch[1]) * 1024;
+            item.sizeStr = formatBytesToMB(bytes);
+          } else {
+            item.sizeStr = rawSz;
+          }
+        }
+        item.speedStr = mProg[3] || '';
+        item.etaStr = mProg[4] || '';
+      }
+      this.onUpdate();
+    };
+
+    const stdoutDecoder = new StringDecoder('utf8');
+    const stderrDecoder = new StringDecoder('utf8');
+    let stdoutBuf = '';
+    let stderrBuf = '';
+
+    proc.stdout.on('data', (chunk) => {
+      stdoutBuf += stdoutDecoder.write(chunk);
+      const parts = stdoutBuf.split(/[\r\n]+/);
+      stdoutBuf = parts.pop();
+      for (const p of parts) handleLine(p);
+    });
+
+    proc.stderr.on('data', (chunk) => {
+      stderrBuf += stderrDecoder.write(chunk);
+      const parts = stderrBuf.split(/[\r\n]+/);
+      stderrBuf = parts.pop();
+      for (const p of parts) handleLine(p);
+    });
+
+    proc.on('close', (code) => {
+      const remOut = stdoutBuf + stdoutDecoder.end();
+      const remErr = stderrBuf + stderrDecoder.end();
+      if (remOut.trim()) handleLine(remOut);
+      if (remErr.trim()) handleLine(remErr);
+
+      item.proc = null;
+      if (item.status === 'Cancelled' || item.status === 'Paused') {
+        this.onUpdate();
+        return;
+      }
+      if (code === 0) {
+        item.progress = 100;
+        item.status = 'Done';
+        this._updateFinalFileSize(item);
+      } else {
+        item.status = 'Error';
+        item.errorMsg = item.logLines[item.logLines.length - 1] || `Exit code ${code}`;
+      }
+      this.onUpdate();
+    });
+  }
+
+  pauseItem(item) {
+    if (item.status !== 'Downloading') return;
+    if (item.proc) {
+      try {
+        item.proc.kill('SIGSTOP');
+        item.status = 'Paused';
+      } catch (_) {
+        item.proc.kill('SIGTERM');
+        item.status = 'Paused';
+      }
+    } else if (item.simTimer) {
+      item.status = 'Paused';
+    }
+    this.onUpdate();
+  }
+
+  resumeItem(item) {
+    if (item.status === 'Paused' && item.proc) {
+      try {
+        item.proc.kill('SIGCONT');
+        item.status = 'Downloading';
+        this.onUpdate();
+        return;
+      } catch (_) {}
+    }
+    if (item.status === 'Paused' && item.simTimer) {
+      item.status = 'Downloading';
+      this.onUpdate();
+      return;
+    }
+    if (['Paused', 'Queued', 'Error', 'Cancelled'].includes(item.status)) {
+      this.startItem(item);
+    }
+  }
+
+  cancelItem(item) {
+    if (item.simTimer) {
+      clearInterval(item.simTimer);
+      item.simTimer = null;
+    }
+    if (item.proc) {
+      try {
+        item.proc.kill('SIGTERM');
+      } catch (_) {}
+      item.proc = null;
+    }
+    item.status = 'Cancelled';
+    this.onUpdate();
+  }
+
+  removeItem(idx) {
+    if (idx >= 0 && idx < this.items.length) {
+      this.cancelItem(this.items[idx]);
+      this.items.splice(idx, 1);
+      this.items.forEach((it, i) => {
+        it.id = i + 1;
+      });
+      this.nextId = this.items.length + 1;
+      this.onUpdate();
+    }
+  }
+
+  _simulateDownload(item) {
+    item.sizeStr = '8.40 MB';
+    item.simTimer = setInterval(() => {
+      if (item.status === 'Paused') return;
+      if (item.status === 'Cancelled') {
+        clearInterval(item.simTimer);
+        item.simTimer = null;
+        return;
+      }
+      item.progress = Math.min(100, item.progress + 4);
+      item.speedStr = '3.5MiB/s';
+      item.etaStr = `00:${String(Math.max(0, Math.round((100 - item.progress) / 4))).padStart(2, '0')}`;
+      item.logLines.push(`[download]  ${item.progress.toFixed(1)}% of ${item.sizeStr} at ${item.speedStr} ETA ${item.etaStr}`);
+      if (item.progress >= 100) {
+        clearInterval(item.simTimer);
+        item.simTimer = null;
+        item.status = 'Done';
+      }
+      this.onUpdate();
+    }, 120);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Virtual Screen Buffer & Node.js TUI Engine
+// ---------------------------------------------------------------------------
+
+class ScreenBuffer {
+  constructor(cols, rows) {
+    this.cols = cols;
+    this.rows = rows;
+    this.chars = Array.from({ length: rows }, () => Array(cols).fill(' '));
+    this.styles = Array.from({ length: rows }, () => Array(cols).fill(ANSI.fgWhite));
+  }
+
+  putStr(y, x, text, style = ANSI.fgWhite) {
+    if (y < 0 || y >= this.rows) return;
+    const str = String(text);
+    for (let i = 0; i < str.length; i++) {
+      const cx = x + i;
+      if (cx >= 0 && cx < this.cols - 1) {
+        this.chars[y][cx] = str[i];
+        this.styles[y][cx] = style;
+      }
+    }
+  }
+
+  drawBox(y, x, h, w, title = '', style = ANSI.fgWhite, titleStyle = ANSI.bold + ANSI.fgCyan) {
+    if (h < 2 || w < 4) return;
+    this.putStr(y, x, '┌' + '─'.repeat(w - 2) + '┐', style);
+    for (let r = y + 1; r < y + h - 1; r++) {
+      this.putStr(r, x, '│', style);
+      this.putStr(r, x + w - 1, '│', style);
+    }
+    this.putStr(y + h - 1, x, '└' + '─'.repeat(w - 2) + '┘', style);
+    if (title) {
+      this.putStr(y, x + 2, ` ${title} `, titleStyle);
+    }
+  }
+
+  renderToAnsi() {
+    let out = `${CSI}H`;
+    for (let r = 0; r < this.rows; r++) {
+      let curStyle = '';
+      let line = '';
+      for (let c = 0; c < this.cols - 1; c++) {
+        const st = this.styles[r][c];
+        if (st !== curStyle) {
+          line += ANSI.reset + st;
+          curStyle = st;
+        }
+        line += this.chars[r][c];
+      }
+      line += ANSI.reset;
+      if (r < this.rows - 1) line += '\r\n';
+      out += line;
+    }
+    return out;
+  }
+}
+
+class EvaNodeTUI {
+  constructor(opts, manager) {
+    this.opts = opts;
+    this.manager = manager;
+    this.manager.onUpdate = () => this.render();
+
+    this.activeTab = 1; // 1: Download, 2: Queue, 3: Library, 4: Settings, 5: About
+    this.focusId = 'url_input';
+    this.focusOrder = [];
+    this.hitboxes = [];
+    this.selectedQueueIdx = 0;
+    this.statusBanner = '';
+
+    // Inline modal prompt state
+    this.modal = null; // { label, value, cursor, onConfirm }
+  }
+
+  start() {
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    process.stdout.write(ANSI.altScreenOn + ANSI.hideCursor + ANSI.mouseOn + ANSI.clearScreen);
+
+    process.stdout.on('resize', () => this.render());
+    process.stdin.on('data', (data) => this.handleInput(data));
+    process.on('SIGINT', () => this.quit());
+    process.on('SIGTERM', () => this.quit());
+
+    this.render();
+  }
+
+  quit() {
+    process.stdout.write(ANSI.mouseOff + ANSI.showCursor + ANSI.altScreenOff + ANSI.reset + '\n');
+    process.exit(0);
+  }
+
+	registerWidget(scr, id, y, x, label, action, { checked = null, radio = null, isCta = false, maxWidth = 0 } = {}) {
+	this.focusOrder.push(id);
+	const isFocused = this.focusId === id;
+
+	// Префикс и его цвет
+	let prefix = '';
+	let prefixStyle = ANSI.fgWhite;
+
+	if (checked !== null) {
+		prefix = checked ? '[x] ' : '[ ] ';
+		prefixStyle = checked
+		? ANSI.fgGreen + ANSI.bold
+		: ANSI.dim + ANSI.fgWhite;
+	} else if (radio !== null) {
+		prefix = radio ? '(•) ' : '( ) ';
+		prefixStyle = radio
+		? ANSI.fgCyan + ANSI.bold
+		: ANSI.dim + ANSI.fgWhite;
+	}
+
+	// Стиль основного текста
+	let style = ANSI.fgGray;
+
+	if (isFocused) {
+		style = isCta
+		? ANSI.bgGray + ANSI.fgWhite + ANSI.bold
+		: ANSI.bgWhite + ANSI.fgBlack + ANSI.bold;
+	} else if (isCta) {
+   style = id === 'url_input'
+    ? ANSI.fgWhite + ANSI.bold
+  : id === 'btn_add_queue'
+  ? ANSI.fgGreen + ANSI.bold
+  : ANSI.fgCyan + ANSI.bold;
+	} else if (checked || radio) {
+		style = ANSI.fgOrange + ANSI.bold;
+  }
+	
+	// Вывод префикса с раздельными цветами
+	if (checked !== null) {
+	  scr.putStr(y, x, '[', ANSI.fgGray);
+      scr.putStr(y, x + 1, checked ? 'x' : ' ', checked ? ANSI.fgOrange + ANSI.bold : ANSI.dim);
+	  scr.putStr(y, x + 2, '] ', ANSI.fgGray);
+	} else if (radio !== null) {
+	  scr.putStr(y, x, '(', ANSI.fgGray);
+	  scr.putStr(y, x + 1, radio ? '•' : ' ', radio ? ANSI.fgOrange + ANSI.bold : ANSI.dim);
+	  scr.putStr(y, x + 2, ') ', ANSI.fgGray);
+	}
+
+	// Расчёт доступной ширины текста
+	const availableWidth = maxWidth > 0
+		? Math.max(0, maxWidth - prefix.length)
+		: Infinity;
+	
+	let visibleLabel = label;
+
+	if (visibleLabel.length > availableWidth) {
+		visibleLabel = availableWidth > 0
+		? visibleLabel.slice(0, availableWidth - 1) + '…'
+		: '';
+	}
+	
+	// Вывод основного текста
+  const textX = x + (prefix ? prefix.length : 0);
+  const editMarker = '[ред.]';
+  const editMarkerIndex = visibleLabel.lastIndexOf(editMarker);
+  if (!isFocused && editMarkerIndex >= 0) {
+    const folderLabel = 'Папка:';
+    const folderLabelIndex = visibleLabel.indexOf(folderLabel);
+    if (folderLabelIndex >= 0 && folderLabelIndex < editMarkerIndex) {
+      scr.putStr(y, textX, visibleLabel.slice(0, folderLabelIndex), style);
+      scr.putStr(y, textX + folderLabelIndex, folderLabel, ANSI.fgWhite);
+      const afterFolderIndex = folderLabelIndex + folderLabel.length;
+      scr.putStr(y, textX + afterFolderIndex, visibleLabel.slice(afterFolderIndex, editMarkerIndex), style);
+    } else {
+      scr.putStr(y, textX, visibleLabel.slice(0, editMarkerIndex), style);
+    }
+    scr.putStr(y, textX + editMarkerIndex, editMarker, ANSI.fgWhite);
+    scr.putStr(y, textX + editMarkerIndex + editMarker.length, visibleLabel.slice(editMarkerIndex + editMarker.length), style);
+  } else {
+    scr.putStr(y, textX, visibleLabel, style);
+  }
+	
+	// Область взаимодействия
+	const totalLength = (prefix ? prefix.length : 0) + visibleLabel.length;
+	
+	this.hitboxes.push({
+		id,
+		y,
+		x1: x,
+		x2: x + totalLength - 1,
+		action
+	});
+	
+	return x + totalLength;
+	}
+
+
+  openPrompt(label, currentVal, onConfirm) {
+    const val = String(currentVal || '');
+    this.modal = {
+      label,
+      value: val,
+      cursor: val.length,
+      onConfirm,
+    };
+    this.render();
+  }
+
+  // -------------------------------------------------------------------------
+  // Rendering
+  // -------------------------------------------------------------------------
+
+  render() {
+    const cols = process.stdout.columns || 100;
+    const rows = process.stdout.rows || 28;
+    const scr = new ScreenBuffer(cols, rows);
+
+    this.focusOrder = [];
+    this.hitboxes = [];
+
+    if (rows < 22 || cols < 76) {
+      scr.putStr(1, 2, `Окно терминала слишком маленькое (${cols}x${rows}). Минимум: 78x22.`, ANSI.fgRed + ANSI.bold);
+      process.stdout.write(scr.renderToAnsi());
+      return;
+    }
+
+    // 1. Header Logo & Tagline
+    ASCII_LOGO.forEach((line, i) => {
+      scr.putStr(1 + i, 2, line, ANSI.fgWhite + ANSI.bold);
+    });
+    scr.putStr(7, 2, 'EVA MEDIA DOWNLOADER  —  by .maxon', ANSI.fgCyan);
+    scr.putStr(2, cols - APP_VERSION.length - 3, APP_VERSION, ANSI.fgWhite);
+    if (cols >= 90) {
+      const tagline = 'Music. Videos. Your collection.';
+      scr.putStr(5, cols - tagline.length - 3, tagline, ANSI.fgWhite);
+      scr.putStr(6, cols - tagline.length - 3, '─'.repeat(tagline.length), ANSI.fgCyan);
+    }
+
+    // 2. Left Sidebar Navigation (Strictly 1-cell narrow CP437/WGL4 characters so borders NEVER shift)
+    const sidebarW = 19;
+    const navItems = [
+      { tab: 1, label: '≡ General' },
+      { tab: 2, label: `↓ Download (${this.manager.items.length})` },
+      { tab: 3, label: '♫ Library' },
+      { tab: 4, label: '* Settings' },
+      { tab: 5, label: 'i About' },
+    ];
+
+    navItems.forEach((nav, idx) => {
+      const r = 9 + idx * 2;
+      const isActive = this.activeTab === nav.tab;
+      const padded = ` ${nav.label.padEnd(sidebarW - 3, ' ')} `;
+      const st = isActive ? ANSI.bgWhite + ANSI.fgBlack + ANSI.bold : ANSI.fgWhite;
+      scr.putStr(r, 2, padded, st);
+      this.hitboxes.push({
+        id: `tab_${nav.tab}`,
+        y: r,
+        x1: 2,
+        x2: 2 + padded.length - 1,
+        action: () => {
+          this.activeTab = nav.tab;
+          this.render();
+        },
+      });
+    });
+
+    for (let r = 8; r < rows - 2; r++) {
+      scr.putStr(r, sidebarW + 1, '│', ANSI.fgWhite);
+    }
+
+    // 3. Main Content Area
+    const mainX = sidebarW + 3;
+    const mainW = cols - mainX - 2;
+
+    if (this.activeTab === 1) this._renderDownloadTab(scr, mainX, mainW, rows);
+    else if (this.activeTab === 2) this._renderQueueTab(scr, mainX, mainW, rows);
+    else if (this.activeTab === 3) this._renderLibraryTab(scr, mainX, mainW, rows);
+    else if (this.activeTab === 4) this._renderSettingsTab(scr, mainX, mainW, rows);
+    else if (this.activeTab === 5) this._renderAboutTab(scr, mainX, mainW, rows);
+
+    if (this.focusOrder.length > 0 && !this.focusOrder.includes(this.focusId)) {
+      this.focusId = this.focusOrder[0];
+    }
+
+    // 4. Bottom Status Bar with Live Queue Counter & Progress Bar (or Modal Input)
+    if (this.modal) {
+      const prefix = ` * ${this.modal.label}: `;
+      scr.putStr(rows - 2, 0, prefix, ANSI.bgCyan + ANSI.fgBlack + ANSI.bold);
+      scr.putStr(rows - 2, prefix.length, this.modal.value.padEnd(Math.max(1, cols - prefix.length - 1), ' '), ANSI.fgYellow + ANSI.bold);
+      scr.putStr(rows - 1, 0, ' [Enter] Применить   [Esc] Отмена   [Ctrl+U] Очистить '.padEnd(cols - 1, ' '), ANSI.bgWhite + ANSI.fgBlack);
+    } else {
+      const footerLeft = 'EVA.md • yt-dlp';
+      scr.putStr(rows - 1, 2, footerLeft, ANSI.fgCyan + ANSI.bold);
+
+      const items = this.manager.items;
+      const activeItems = items.filter((i) => i.status === 'Downloading');
+      const doneCnt = items.filter((i) => i.status === 'Done').length;
+
+      let pct = 0;
+      if (activeItems.length > 0) {
+        const sum = activeItems.reduce((acc, i) => acc + (i.progress || 0), 0);
+        pct = Math.round(sum / activeItems.length);
+      } else if (items.length > 0 && doneCnt === items.length) {
+        pct = 100;
+      }
+
+      const barW = 12;
+      const filled = Math.round((pct / 100) * barW);
+      const bar = '█'.repeat(Math.max(0, filled)) + '░'.repeat(Math.max(0, barW - filled));
+
+	  const queueStatusStr = `│ ${activeItems.length}↓ ${doneCnt}✓ ${pct}%`;
+	  const qStyle = activeItems.length > 0 ? ANSI.fgGreen + ANSI.bold : ANSI.fgWhite;
+	  const qStartX = cols - queueStatusStr.length - 0;
+	  scr.putStr(rows - 1, qStartX, queueStatusStr, qStyle);
+
+      const afterQueueX = qStartX + queueStatusStr.length + 2;
+      if (this.statusBanner && afterQueueX < cols - 10) {
+        scr.putStr(rows - 1, afterQueueX, `│ ${this.statusBanner}`.slice(0, cols - afterQueueX - 2), ANSI.fgCyan);
+      }
+    }
+
+    process.stdout.write(scr.renderToAnsi());
+  }
+
+  // -------------------------------------------------------------------------
+  // Tab 1: Compact Main Download Screen (Word-wrapped CLI, no bottom queue)
+  // -------------------------------------------------------------------------
+
+  _renderDownloadTab(scr, x, w, rows) {
+    let y = 8;
+
+    // --- Box 1: Select a source (1-9) & URL input ---
+    scr.drawBox(y, x, 7, w, 'Select a source');
+	const colWidth = Math.floor(w / 3);
+	const col1X = x + 2;
+	const col2X = x + colWidth;
+	const col3X = x + colWidth * 2;
+	
+    SOURCES.forEach((s) => {
+  const colIndex = Math.floor((s.id - 1) / 3);
+  const rowIndex = (s.id - 1) % 3;
+  
+  const sy = y + 1 + rowIndex;
+  const sx = colIndex === 0 ? col1X : colIndex === 1 ? col2X : col3X;
+  
+      this.registerWidget(
+        scr,
+        `src_${s.id}`,
+        sy,
+        sx,
+        `${s.code} ${s.icon} ${s.name}`,
+        () => this._selectSource(s.id),
+        { radio: this.opts.sourceId === s.id, maxWidth: Math.floor(w / 2) - 3 }
+      );
+    });
+
+    scr.putStr(y + 4, x + 0, '├' + '─'.repeat(w - 2) + '┤', ANSI.fgWhite);
+    const srcObj = SOURCES.find((s) => s.id === this.opts.sourceId) || SOURCES[0];
+    const urlDisp = this.opts.url ? this.opts.url : `(нажмите 'u' или кликните для ввода URL — ${srcObj.hint})`;
+    this.registerWidget(
+      scr,
+      'url_input',
+      y + 5,
+      x + 2,
+      `URL > ${urlDisp}`,
+      () => this.openPrompt('Вставьте ссылку на трек или плейлист', this.opts.url, (val) => this._setUrl(val)),
+      { isCta: true, maxWidth: w - 4 }
+    );
+
+    y += 7;
+
+    // --- Box 2: Download Options & yt-dlp Flags ---
+    const box2H = 11;
+    scr.drawBox(y, x, box2H, w, 'Download Options Flags');
+    const c1 = x + 2;
+
+    // Row 1: Audio (-x, metadata, thumbnail)
+    scr.putStr(y + 1, c1, 'АУДИО:', ANSI.fgCyan + ANSI.bold);
+    let ax = c1 + 7;
+    ax =
+      this.registerWidget(
+        scr,
+        'flag_x',
+        y + 1,
+        ax,
+        'Только аудио',
+        () => this._toggle('extractAudio'),
+        { checked: this.opts.extractAudio }
+      ) + 2;
+    ax =
+      this.registerWidget(
+        scr,
+        'flag_meta',
+        y + 1,
+        ax,
+        'Встроить метаданные',
+        () => this._toggle('embedMetadata'),
+        { checked: this.opts.embedMetadata }
+      ) + 2;
+    this.registerWidget(
+      scr,
+      'flag_thumb',
+      y + 1,
+      ax,
+      'Встроить обложку',
+      () => this._toggle('embedThumbnail'),
+      { checked: this.opts.embedThumbnail, maxWidth: x + w - ax - 2 }
+    );
+
+    // Row 2: Format (--audio-format)
+    scr.putStr(y + 2, c1, 'ФОРМАТ:', ANSI.fgCyan + ANSI.bold);
+    let fx = c1 + 8;
+    AUDIO_FORMATS.forEach((fmt) => {
+      fx =
+        this.registerWidget(
+          scr,
+          `fmt_${fmt}`,
+          y + 2,
+          fx,
+          fmt,
+          () => {
+            this.opts.audioFormat = fmt;
+            this.opts.extractAudio = true;
+            this.opts.bestVideoMerge = false;
+            this.statusBanner = `Формат: --audio-format ${fmt}`;
+            this.render();
+          },
+          { radio: this.opts.audioFormat === fmt }
+        ) + 2;
+    });
+
+    // Row 3: Quality (--audio-quality)
+    scr.putStr(y + 3, c1, 'БИТРЕЙТ:', ANSI.fgCyan + ANSI.bold);
+    let qx = c1 + 9;
+    AUDIO_QUALITIES.forEach((q) => {
+      qx =
+        this.registerWidget(
+          scr,
+          `qual_${q.val}`,
+          y + 3,
+          qx,
+          q.label,
+          () => {
+            this.opts.audioQuality = q.val;
+            this.statusBanner = `Качество: --audio-quality ${q.val}`;
+            this.render();
+          },
+          { radio: this.opts.audioQuality === q.val }
+        ) + 2;
+    });
+
+    // Row 4: Video quality and subtitle file
+    scr.putStr(y + 4, c1, 'ВИДЕО:', ANSI.fgCyan + ANSI.bold);
+    let vx = c1 + 7;
+    vx =
+      this.registerWidget(
+        scr,
+        'flag_bvbab',
+        y + 4,
+        vx,
+        'Видео+Аудио',
+        () => {
+          this.opts.bestVideoMerge = !this.opts.bestVideoMerge;
+          this.opts.extractAudio = !this.opts.bestVideoMerge;
+          this.statusBanner = this.opts.bestVideoMerge ? 'Режим видео -f "bv*+ba/b"' : 'Режим аудио -x';
+          this.render();
+        },
+        { checked: this.opts.bestVideoMerge }
+      ) + 2;
+    vx =
+      this.registerWidget(scr, 'flag_wsubs', y + 4, vx, 'Файл субтитров', () => this._toggle('writeSubs'), {
+        checked: this.opts.writeSubs,
+      }) + 2;
+    let mediaOptionsX =
+      this.registerWidget(scr, 'flag_esubs', y + 5, c1 + 7, 'Встроить субтитры', () => this._toggle('embedSubs'), {
+        checked: this.opts.embedSubs,
+      }) + 2;
+    this.registerWidget(scr, 'flag_wthumb', y + 5, mediaOptionsX, 'Скачать обложку', () => this._toggle('writeThumbnail'), {
+      checked: this.opts.writeThumbnail,
+      maxWidth: x + w - mediaOptionsX - 2,
+    });
+
+    // Row 6: Naming & Archive (-o & --download-archive)
+    scr.putStr(y + 6, c1, 'ФАЙЛЫ:', ANSI.fgCyan + ANSI.bold);
+    const maxTplLen = Math.max(14, Math.floor((w - 20) / 4));
+    const shortTpl =
+      this.opts.outputTemplate.length > maxTplLen
+        ? this.opts.outputTemplate.slice(0, maxTplLen - 1) + '…'
+        : this.opts.outputTemplate;
+    let nx =
+      this.registerWidget(
+        scr,
+        'flag_otpl',
+        y + 6,
+        c1 + 9,
+        `-o "${shortTpl}"`,
+        () => this._toggle('usePlaylistTemplate'),
+        { checked: this.opts.usePlaylistTemplate }
+      ) + 1;
+    nx =
+      this.registerWidget(scr, 'edit_otpl', y + 6, nx, '[ред.]', () =>
+        this.openPrompt('Шаблон имени (-o)', this.opts.outputTemplate, (v) => {
+          this.opts.outputTemplate = v || '%(title)s.%(ext)s';
+        })
+      ) + 3;
+
+    let arx =
+      this.registerWidget(
+        scr,
+        'flag_archive',
+        y + 6,
+        nx,
+        `История загрузки ${this.opts.archiveFile}`,
+        () => this._toggle('useDownloadArchive'),
+        { checked: this.opts.useDownloadArchive }
+      ) + 1;
+    this.registerWidget(scr, 'edit_archive', y + 6, arx, '[ред.]', () =>
+      this.openPrompt('Файл архива (--download-archive)', this.opts.archiveFile, (v) => {
+        this.opts.archiveFile = v || 'archive.txt';
+      })
+    );
+
+    // Row 7: Playlists (--playlist-items & --playlist-reverse)
+    scr.putStr(y + 7, c1, 'ПЛЕЙЛИСТ:', ANSI.fgCyan + ANSI.bold);
+    let px =
+      this.registerWidget(
+        scr,
+        'flag_plitems',
+        y + 7,
+        c1 + 9,
+        `Выбрать файлы ${this.opts.playlistItems}`,
+        () => this._toggle('usePlaylistItems'),
+        { checked: this.opts.usePlaylistItems }
+      ) + 1;
+    px =
+      this.registerWidget(scr, 'edit_plitems', y + 7, px, '[ред.]', () =>
+        this.openPrompt('Номера треков (--playlist-items, напр. 1-5)', this.opts.playlistItems, (v) => {
+          this.opts.playlistItems = v || '1-5';
+        })
+      ) + 3;
+
+    this.registerWidget(
+      scr,
+      'flag_plrev',
+      y + 7,
+      px,
+      'Загрузить плейлист с конца',
+      () => this._toggle('playlistReverse'),
+      { checked: this.opts.playlistReverse, maxWidth: x + w - px - 2 }
+    );
+
+    // Row 9: Output directory & Add to Queue CTA button
+    const maxDirLen = Math.max(16, w - 48);
+    const shortDir =
+      this.opts.outputDir.length > maxDirLen
+        ? '…' + this.opts.outputDir.slice(-(maxDirLen - 1))
+        : this.opts.outputDir;
+    let dx =
+      this.registerWidget(scr, 'edit_outdir', y + 9, c1, `Папка: ${shortDir} [ред.]`, () =>
+        this.openPrompt('Папка сохранения', this.opts.outputDir, (v) => {
+          this.opts.outputDir = v || path.join(os.homedir(), 'Downloads');
+        })
+      ) + 3;
+
+    const ctaLabel = 'Скачать (Enter / a)';
+    const ctaX = Math.max(dx, x + w - ctaLabel.length - 3);
+    this.registerWidget(scr, 'btn_add_queue', y + 9, ctaX, ctaLabel, () => this._actionAddToQueue(), {
+      isCta: true,
+    });
+
+    y += box2H;
+
+    // Word-wrapped CLI Preview Lines (never overflows the window width)
+    const fullCliText = `CLI: ${buildCommandPreview(this.opts)}`;
+    const wrappedCli = wrapTextByWords(fullCliText, w - 2);
+    const availCliRows = Math.max(1, rows - 2 - y);
+    wrappedCli.slice(0, availCliRows).forEach((line, idx) => {
+      scr.putStr(y + idx, x + 1, line, ANSI.fgYellow);
+    });
+  }
+
+  // -------------------------------------------------------------------------
+  // Tab 2: Queue Tab (Full Queue Table + Live yt-dlp Output Log)
+  // -------------------------------------------------------------------------
+
+  _renderQueueBox(scr, y, x, h, w) {
+    scr.drawBox(y, x, h, w, 'Download Queue');
+    const titleColW = Math.max(18, w - 42);
+    const hdr = ` #  ${'Title'.padEnd(titleColW)} ${'Format'.padEnd(7)} ${'Size'.padEnd(10)} Status`;
+    scr.putStr(y + 1, x + 2, hdr.slice(0, w - 4), ANSI.fgCyan + ANSI.bold);
+    scr.putStr(y + 2, x + 1, '├' + '─'.repeat(w - 2) + '┤', ANSI.fgWhite);
+
+    const items = this.manager.items;
+    if (this.selectedQueueIdx >= items.length) {
+      this.selectedQueueIdx = Math.max(0, items.length - 1);
+    }
+
+    const listRows = Math.max(1, h - 5);
+    if (items.length === 0) {
+      scr.putStr(y + 3, x + 4, 'Очередь пуста. Добавьте трек во вкладке [1] Download.', ANSI.fgWhite);
+    } else {
+      const startI = Math.max(0, this.selectedQueueIdx - listRows + 1);
+      const slice = items.slice(startI, startI + listRows);
+      slice.forEach((it, rowOffset) => {
+        const idx = startI + rowOffset;
+        const ry = y + 3 + rowOffset;
+        const isSel = idx === this.selectedQueueIdx;
+        const pointer = isSel ? '►' : ' ';
+        const barW = 10;
+        const filled = Math.round((it.progress / 100) * barW);
+        const bar = '█'.repeat(Math.max(0, filled)) + '░'.repeat(Math.max(0, barW - filled));
+        const pct = `${String(Math.round(it.progress)).padStart(3, ' ')}%`;
+        let statusText = `[${bar}] ${pct} ${it.status}`;
+        if (it.status === 'Error' && it.errorMsg) {
+          statusText = `ERR: ${it.errorMsg.slice(0, 18)}`;
+        }
+
+        const seqNum = idx + 1;
+        const line = `${pointer}${String(seqNum).padEnd(2)} ${it.title.padEnd(titleColW).slice(0, titleColW)} ${it.fmt
+          .padEnd(7)
+          .slice(0, 7)} ${it.sizeStr.padEnd(10).slice(0, 10)} ${statusText}`;
+        const st = isSel
+          ? ANSI.bgWhite + ANSI.fgBlack + ANSI.bold
+          : it.status === 'Done'
+          ? ANSI.fgGreen
+          : it.status === 'Error'
+          ? ANSI.fgRed
+          : ANSI.fgWhite;
+
+        scr.putStr(ry, x + 2, line.slice(0, w - 4), st);
+        this.hitboxes.push({
+          id: `qitem_${idx}`,
+          y: ry,
+          x1: x + 2,
+          x2: x + w - 3,
+          action: () => {
+            this.selectedQueueIdx = idx;
+            this.render();
+          },
+        });
+      });
+    }
+
+    const ctrlY = y + h - 2;
+    scr.putStr(ctrlY - 1, x + 1, '├' + '─'.repeat(w - 2) + '┤', ANSI.fgWhite);
+    let cx = x + 3;
+    cx = this.registerWidget(scr, 'q_resume', ctrlY, cx, '[r] Resume', () => this._qAction('resume')) + 2;
+    cx = this.registerWidget(scr, 'q_pause', ctrlY, cx, '[p] Pause', () => this._qAction('pause')) + 2;
+    cx = this.registerWidget(scr, 'q_cancel', ctrlY, cx, '[c] Cancel', () => this._qAction('cancel')) + 2;
+    cx = this.registerWidget(scr, 'q_remove', ctrlY, cx, '[d] Remove', () => this._qAction('remove')) + 2;
+    const activeCnt = items.filter((i) => i.status === 'Downloading').length;
+    scr.putStr(ctrlY, cx, `│ Active: ${activeCnt}/${items.length}`.slice(0, Math.max(0, x + w - cx - 2)), ANSI.fgCyan);
+  }
+
+  _renderQueueTab(scr, x, w, rows) {
+    const queueH = Math.max(8, rows - 16);
+    this._renderQueueBox(scr, 8, x, queueH, w);
+    const logY = 8 + queueH;
+    const logH = Math.max(4, rows - logY - 1);
+    scr.drawBox(logY, x, logH, w, 'Selected Task yt-dlp Output Log');
+    const it = this.manager.items[this.selectedQueueIdx];
+    if (it) {
+      scr.putStr(logY + 1, x + 2, `CMD: yt-dlp ${it.cmdArgs.map(shellQuote).join(' ')}`.slice(0, w - 4), ANSI.fgYellow);
+      const maxLogLines = Math.max(1, logH - 3);
+      it.logLines.slice(-maxLogLines).forEach((l, i) => {
+        scr.putStr(logY + 2 + i, x + 2, l.slice(0, w - 4), ANSI.fgWhite);
+      });
+    } else {
+      scr.putStr(logY + 2, x + 2, 'Выберите задачу в очереди для просмотра лога yt-dlp.', ANSI.fgWhite);
+    }
+  }
+
+  // -------------------------------------------------------------------------
+  // Tab 3: Library Tab
+  // -------------------------------------------------------------------------
+
+  _renderLibraryTab(scr, x, w, rows) {
+    const h = rows - 9;
+    scr.drawBox(8, x, h, w, `Downloaded Media Library (${this.opts.outputDir})`);
+    const outDir = this.opts.outputDir.replace(/^~(?=$|\/|\\)/, os.homedir());
+    const exts = new Set(['.mp3', '.m4a', '.flac', '.wav', '.mp4', '.mkv', '.webm', '.opus', '.ogg']);
+    let files = [];
+    try {
+      if (fs.existsSync(outDir)) {
+        files = fs
+          .readdirSync(outDir)
+          .map((name) => {
+            const full = path.join(outDir, name);
+            const stat = fs.statSync(full);
+            return { name, full, stat, ext: path.extname(name).toLowerCase() };
+          })
+          .filter((f) => f.stat.isFile() && exts.has(f.ext))
+          .sort((a, b) => b.stat.mtimeMs - a.stat.mtimeMs);
+      }
+    } catch (_) {}
+
+    const nameColW = Math.max(20, w - 28);
+    if (files.length === 0) {
+      scr.putStr(10, x + 3, `В папке ${outDir} пока нет скачанных медиафайлов.`.slice(0, w - 6), ANSI.fgWhite);
+    } else {
+      scr.putStr(
+        10,
+        x + 3,
+        `${'#'.padEnd(4)} ${'Имя файла'.padEnd(nameColW)} ${'Формат'.padEnd(7)} Размер`.slice(0, w - 6),
+        ANSI.fgCyan + ANSI.bold
+      );
+      files.slice(0, h - 5).forEach((f, i) => {
+        const mb = formatBytesToMB(f.stat.size);
+        const line = `${String(i + 1).padEnd(4)} ${f.name.padEnd(nameColW).slice(0, nameColW)} ${f.ext
+          .slice(1)
+          .padEnd(7)} ${mb}`;
+        scr.putStr(12 + i, x + 3, line.slice(0, w - 6), ANSI.fgWhite);
+      });
+    }
+  }
+
+  // -------------------------------------------------------------------------
+  // Tab 4: Settings Tab (Network & Bypass flags + Naming Presets)
+  // -------------------------------------------------------------------------
+
+  _renderSettingsTab(scr, x, w, rows) {
+    const h = rows - 9;
+    scr.drawBox(8, x, h, w, 'Settings & Network Options');
+    const c1 = x + 3;
+
+    scr.putStr(10, c1, 'СЕТЬ И ОБХОД БЛОКИРОВОК:', ANSI.fgCyan + ANSI.bold);
+    this.registerWidget(
+      scr,
+      'flag_ipv4',
+      11,
+      c1 + 2,
+      'Принудительный IPv4 (Решает ошибки DNS)',
+      () => this._toggle('forceIpv4'),
+      { checked: this.opts.forceIpv4, maxWidth: w - 8 }
+    );
+
+    let px =
+      this.registerWidget(
+        scr,
+        'flag_proxy',
+        12,
+        c1 + 2,
+        `Прокси ${this.opts.proxyUrl}`,
+        () => this._toggle('useProxy'),
+        { checked: this.opts.useProxy }
+      ) + 2;
+    this.registerWidget(scr, 'edit_proxy', 12, px, '[изменить прокси]', () =>
+      this.openPrompt('Прокси (--proxy)', this.opts.proxyUrl, (v) => {
+        this.opts.proxyUrl = v || 'http://127.0.0.1:8080';
+      })
+    );
+
+    let ckx =
+      this.registerWidget(
+        scr,
+        'flag_cookies',
+        13,
+        c1 + 2,
+        `Брать cookies из браузера ${this.opts.cookiesBrowser}`,
+        () => this._toggle('useCookiesBrowser'),
+        { checked: this.opts.useCookiesBrowser }
+      ) + 2;
+    this.registerWidget(scr, 'cycle_browser', 13, ckx, '[сменить браузер]', () => {
+      const idx = BROWSERS.indexOf(this.opts.cookiesBrowser);
+      const nextB = BROWSERS[(idx + 1) % BROWSERS.length];
+      this.opts.cookiesBrowser = nextB;
+      this.opts.useCookiesBrowser = nextB !== 'none';
+      this.statusBanner = `Cookies браузер: ${nextB}`;
+      this.render();
+    });
+
+    scr.putStr(15, c1, 'ШАБЛОНЫ ИМЕНОВАНИЯ ФАЙЛОВ (-o):', ANSI.fgCyan + ANSI.bold);
+    NAMING_PRESETS.forEach((p, idx) => {
+      this.registerWidget(
+        scr,
+        `preset_${idx}`,
+        16 + idx,
+        c1 + 2,
+        p.label,
+        () => {
+          this.opts.outputTemplate = p.tpl;
+          this.opts.usePlaylistTemplate = true;
+          this.statusBanner = `Шаблон: ${p.tpl}`;
+          this.render();
+        },
+        { radio: this.opts.outputTemplate === p.tpl, maxWidth: w - 8 }
+      );
+    });
+
+    scr.putStr(20, c1, 'ОКРУЖЕНИЕ:', ANSI.fgCyan + ANSI.bold);
+    scr.putStr(
+      21,
+      c1 + 2,
+      `Node.js : ${process.version} (${process.platform}/${process.arch})`.slice(0, w - 8),
+      ANSI.fgGreen
+    );
+    scr.putStr(
+      22,
+      c1 + 2,
+      `yt-dlp  : ${this.manager.ytdlpPath || 'НЕ НАЙДЕН (Установите через winget/brew/apt)'}`.slice(0, w - 8),
+      this.manager.ytdlpPath ? ANSI.fgGreen : ANSI.fgRed
+    );
+    scr.putStr(
+      23,
+      c1 + 2,
+      `ffmpeg  : ${this.manager.ffmpegPath || 'НЕ НАЙДЕН (Нужен для конвертации в mp3/flac)'}`.slice(0, w - 8),
+      this.manager.ffmpegPath ? ANSI.fgGreen : ANSI.fgYellow
+    );
+
+    if (8 + h - 2 >= 25) {
+      this.registerWidget(
+        scr,
+        'btn_save_cfg',
+        Math.min(25, 8 + h - 2),
+        c1,
+        '[ Сохранить текущие настройки по умолчанию ]',
+        () => {
+          try {
+            fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
+            fs.writeFileSync(CONFIG_PATH, JSON.stringify(this.opts, null, 2), 'utf8');
+            this.statusBanner = `Настройки сохранены`;
+          } catch (err) {
+            this.statusBanner = `Ошибка: ${err.message}`;
+          }
+          this.render();
+        },
+        { isCta: true }
+      );
+    }
+  }
+
+  // -------------------------------------------------------------------------
+  // Tab 5: About Tab
+  // -------------------------------------------------------------------------
+
+  _renderAboutTab(scr, x, w, rows) {
+    const h = rows - 9;
+    scr.drawBox(8, x, h, w, 'About EVA.md (Node.js Edition)');
+    const lines = [
+      `EVA.md ${APP_VERSION} — Консольный загрузчик музыки и видео`,
+      '',
+      'Поддерживаемые площадки (9 источников):',
+      '  01. YouTube             04. SoundCloud          07. Audius',
+      '  02. YouTube Music       05. Mixcloud            08. ВКонтакте (VK)',
+      '  03. Bandcamp            06. Audiomack           09. Internet Archive',
+      '',
+      'Интегрированные флаги yt-dlp:',
+      '  • Аудио: -x, --audio-format (mp3/flac/m4a/wav), --audio-quality 0, --embed-metadata, --embed-thumbnail',
+      '  • Видео: -f "bv*+ba/b", --write-subs, --embed-subs, --write-thumbnail, --merge-output-format mp4',
+      '  • Файлы: -o "%(playlist_index)s. %(title)s.%(ext)s", --download-archive archive.txt',
+      '  • Плейлисты: --playlist-items 1-5, --playlist-reverse',
+      '  • Сеть (вкладка Settings): -4, --proxy http://127.0.0.1:8080, --cookies-from-browser chrome',
+    ];
+    lines.forEach((line, i) => {
+      if (10 + i < rows - 2) scr.putStr(10 + i, x + 3, line.slice(0, w - 6), ANSI.fgWhite);
+    });
+  }
+
+  // -------------------------------------------------------------------------
+  // Actions & Input Handling
+  // -------------------------------------------------------------------------
+
+  _selectSource(sid) {
+    this.opts.sourceId = sid;
+    const s = SOURCES.find((item) => item.id === sid) || SOURCES[0];
+    if (sid === 8 && !this.opts.useCookiesBrowser) {
+      this.opts.useCookiesBrowser = true;
+      this.statusBanner = `${s.name} (включен --cookies-from-browser)`;
+    } else if (sid === 1 && this.opts.url.trim()) {
+      const detected = detectSource(this.opts.url, sid);
+      this.statusBanner = `URL (${detected.name})`;
+    } else {
+      this.statusBanner = `Источник: ${s.name}`;
+    }
+    this.render();
+  }
+
+  _setUrl(val) {
+    this.opts.url = val;
+    if (val) {
+      const detected = detectSource(val, this.opts.sourceId);
+      if (this.opts.sourceId !== 1) {
+        this.opts.sourceId = detected.id;
+      }
+      this.statusBanner = `URL (${detected.name})`;
+    }
+    this.render();
+  }
+
+  _toggle(key) {
+    this.opts[key] = !this.opts[key];
+    this.render();
+  }
+
+  _actionAddToQueue() {
+    if (!this.opts.url.trim()) {
+      this.openPrompt('Сначала вставьте ссылку (URL)', this.opts.url, (val) => {
+        this._setUrl(val);
+        if (this.opts.url.trim()) {
+          const it = this.manager.addTask(this.opts, true);
+          this.selectedQueueIdx = this.manager.items.length - 1;
+          this.statusBanner = `+ #${this.manager.items.length} (${it.sourceName})`;
+          this.render();
+        }
+      });
+      return;
+    }
+    const item = this.manager.addTask(this.opts, true);
+    this.selectedQueueIdx = this.manager.items.length - 1;
+    this.statusBanner = `+ #${this.manager.items.length} (${item.sourceName})`;
+    this.render();
+  }
+
+  _qAction(type) {
+    const it = this.manager.items[this.selectedQueueIdx];
+    if (!it) return;
+    if (type === 'resume') this.manager.resumeItem(it);
+    else if (type === 'pause') this.manager.pauseItem(it);
+    else if (type === 'cancel') this.manager.cancelItem(it);
+    else if (type === 'remove') this.manager.removeItem(this.selectedQueueIdx);
+    this.render();
+  }
+
+  handleInput(data) {
+    if (this.modal) {
+      if (data === '\r' || data === '\n') {
+        const cb = this.modal.onConfirm;
+        const val = this.modal.value.trim();
+        this.modal = null;
+        cb(val);
+        this.render();
+        return;
+      }
+      if (data === '\x1b') {
+        this.modal = null;
+        this.render();
+        return;
+      }
+      if (data === '\x15') {
+        this.modal.value = '';
+        this.modal.cursor = 0;
+        this.render();
+        return;
+      }
+      if (data === '\x7f' || data === '\b') {
+        if (this.modal.value.length > 0) {
+          this.modal.value = this.modal.value.slice(0, -1);
+        }
+        this.render();
+        return;
+      }
+      if (!data.startsWith('\x1b')) {
+        const clean = data.replace(/[\r\n\t]/g, '');
+        this.modal.value += clean;
+        this.render();
+      }
+      return;
+    }
+
+    const mouseMatch = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/.exec(data);
+    if (mouseMatch) {
+      const btn = parseInt(mouseMatch[1], 10);
+      const mx = parseInt(mouseMatch[2], 10) - 1;
+      const my = parseInt(mouseMatch[3], 10) - 1;
+      const isPress = mouseMatch[4] === 'M';
+      if (isPress && btn === 0) {
+        const hit = this.hitboxes.find((h) => h.y === my && mx >= h.x1 && mx <= h.x2);
+        if (hit) {
+          this.focusId = hit.id;
+          hit.action();
+        }
+      }
+      return;
+    }
+
+    if (data === '\x03' || data === 'q' || data === 'Q' || data === '\x1b') {
+      this.quit();
+      return;
+    }
+    if (['1', '2', '3', '4', '5'].includes(data)) {
+      this.activeTab = parseInt(data, 10);
+      this.render();
+      return;
+    }
+    if (data === 'u' || data === 'U') {
+      this.activeTab = 1;
+      this.openPrompt('Вставьте ссылку на трек или плейлист', this.opts.url, (val) => this._setUrl(val));
+      return;
+    }
+    if (data === 'a' || data === 'A') {
+      this._actionAddToQueue();
+      return;
+    }
+    if (data === 'r' || data === 'R') return this._qAction('resume');
+    if (data === 'p' || data === 'P') return this._qAction('pause');
+    if (data === 'c' || data === 'C') return this._qAction('cancel');
+    if (data === 'd' || data === 'D') return this._qAction('remove');
+
+    if (data === '\t' || data === '\x1b[B' || data === '\x1b[C') {
+      if (this.focusOrder.length > 0) {
+        const idx = Math.max(0, this.focusOrder.indexOf(this.focusId));
+        this.focusId = this.focusOrder[(idx + 1) % this.focusOrder.length];
+        this.render();
+      }
+      return;
+    }
+    if (data === '\x1b[Z' || data === '\x1b[A' || data === '\x1b[D') {
+      if (this.focusOrder.length > 0) {
+        const idx = Math.max(0, this.focusOrder.indexOf(this.focusId));
+        this.focusId = this.focusOrder[(idx - 1 + this.focusOrder.length) % this.focusOrder.length];
+        this.render();
+      }
+      return;
+    }
+    if (data === ' ' || data === '\r' || data === '\n') {
+      const hit = this.hitboxes.find((h) => h.id === this.focusId);
+      if (hit) hit.action();
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// CLI Entrypoint & Exports for Testing
+// ---------------------------------------------------------------------------
+
+function updatePackage() {
+  console.log('Обновление EVA.md...');
+  const result = process.platform === 'win32'
+    ? spawnSync(process.env.ComSpec || 'cmd.exe', ['/d', '/s', '/c', 'npm install --global eva-md@latest'], { stdio: 'inherit' })
+    : spawnSync('npm', ['install', '--global', 'eva-md@latest'], { stdio: 'inherit' });
+
+  if (result.error) {
+    console.error(`Не удалось запустить npm: ${result.error.message}`);
+    process.exitCode = 1;
+  } else if (result.status === 0) {
+    console.log('EVA.md обновлена. Запустите команду eva снова.');
+  } else {
+    process.exitCode = result.status || 1;
+  }
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  if (argv[0] === '--update') {
+    if (argv.length !== 1) {
+      console.error('Использование: eva --update');
+      process.exitCode = 1;
+      return;
+    }
+    updatePackage();
+    return;
+  }
+
+  const isDemo = argv.includes('--demo');
+  const isPrintCmd = argv.includes('--print-cmd');
+  const urlArg = argv.find((a) => !a.startsWith('-')) || '';
+
+  const opts = loadSavedOptions();
+  if (urlArg) opts.url = urlArg;
+
+  if (isPrintCmd) {
+    console.log(buildCommandPreview(opts));
+    return;
+  }
+
+  const manager = new DownloadManager(isDemo);
+
+  if (isDemo) {
+    if (!opts.url) opts.url = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ';
+    const samples = [
+      { title: 'Валентин Стрыкало — Наше лето', src: 'SoundCloud', fmt: 'mp3', sz: '4.20 MB', prog: 68, st: 'Downloading' },
+      { title: 'Lo-fi beats to relax/study to', src: 'YouTube Music', fmt: 'mp3', sz: '12.60 MB', prog: 25, st: 'Queued' },
+      { title: 'The Weeknd - Blinding Lights', src: 'SoundCloud', fmt: 'mp3', sz: '8.70 MB', prog: 0, st: 'Queued' },
+      { title: 'Imagine Dragons - Believer', src: 'Bandcamp', fmt: 'flac', sz: '24.30 MB', prog: 100, st: 'Done' },
+    ];
+    samples.forEach((s, i) => {
+      manager.items.push({
+        id: i + 1,
+        url: opts.url,
+        title: s.title,
+        sourceName: s.src,
+        fmt: s.fmt,
+        outDir: opts.outputDir,
+        destFile: '',
+        sizeStr: s.sz,
+        progress: s.prog,
+        speedStr: '',
+        etaStr: '',
+        status: s.st,
+        cmdArgs: buildYtdlpArgs(opts, opts.url),
+        errorMsg: '',
+        proc: null,
+        simTimer: null,
+        logLines: [`[download] ${s.prog}% of ${s.sz}`],
+      });
+    });
+    manager.nextId = samples.length + 1;
+  }
+
+  const app = new EvaNodeTUI(opts, manager);
+  app.start();
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  createDefaultOptions,
+  buildYtdlpArgs,
+  buildCommandPreview,
+  detectSource,
+  DownloadManager,
+  formatBytesToMB,
+  wrapTextByWords,
+};