Quantum Downloader - Hyper-Intelligence Protocol 🚀

中文 | English

---

English

Quantum Downloader is a high-performance, futuristic video downloader built on the power of yt-dlp. It features a stunning glassmorphism UI, real-time progress tracking, and intelligent subtitle processing.

✨ Features

• Futuristic UI: Premium glassmorphism design with dynamic background gradients and micro-animations.
• iOS-Style Progress Bar: The "Execute Download" button morphs into a sleek, iOS-volume-style progress bar upon activation.
• Smart Subtitles: Automatically downloads, converts (to SRT), and embeds subtitles into your MP4/MKV files.
• Multi-Platform Support: Powered by yt-dlp, supporting 1000+ sites (YouTube, Bilibili, Twitter, etc.).
• Real-time Kernel Logs: View the low-level processing logs directly in the built-in terminal window.
• Flexible Quality: Choose from 480p to 4K (2160p) or extract pure audio (MP3).

🛠 Tech Stack

• Frontend: HTML5, Vanilla JavaScript, Tailwind CSS (Modern Glassmorphism Tech).
• Backend: Node.js, Express, Socket.IO (for real-time duplex communication).
• Core Engine: yt-dlp & FFmpeg.

📋 Prerequisites

Before running this project, ensure you have the following installed and added to your system PATH:

1. yt-dlp: The powerhouse downloader.
2. FFmpeg: Required for merging video/audio and embedding subtitles.
3. Node.js: Recommended version v16+.

🚀 Getting Started

1. Clone the repository:

   git clone https://github.com/yourusername/quantum-downloader.git
   cd quantum-downloader

2. Install dependencies:

   npm install

3. Launch the application:

   • Mac/Linux: Double-click start_downloader.command or run node server.js.
   • Windows: Run node server.js.

4. Access the UI: Open your browser and navigate to http://localhost:3000.

---

简体中文

Quantum Downloader 是一款基于 yt-dlp 的高性能、未来感视频下载工具。它拥有迷人的毛玻璃 UI 设计，支持实时进度追踪和智能字幕处理。

✨ 核心特性

• 未来感交互: 采用高级毛玻璃 (Glassmorphism) 设计，配合动态光球背景与微交互动画。
• iOS 风格进度条: 点击“执行下载”后，按钮会平滑变形为类似 iOS 音量条的进度填充交互，实时显示百分比。
• 智能字幕处理: 自动下载、转换 (SRT 格式) 并将字幕内嵌至 MP4/MKV 视频文件中。
• 全平台支持: 基于 yt-dlp 内核，支持 YouTube、Bilibili、Twitter 等 1000 多个站点。
• 实时内核日志: 内置终端窗口，直接查看 yt-dlp 的底层运行日志。
• 灵活质量选择: 支持从 480p 到 4K (2160p) 的多种精度，或提取高品质纯净音频 (MP3)。

🛠 技术栈

• 前端: HTML5, Vanilla JavaScript, Tailwind CSS (现代科技风格)。
• 后端: Node.js, Express, Socket.IO (实现全双工实时通信)。
• 核心内核: yt-dlp & FFmpeg.

📋 环境要求

在运行本项目之前，请确保您的系统中已安装以下工具并已添加至环境变量 PATH 中：

1. yt-dlp: 核心下载引擎。
2. FFmpeg: 用于音视频合并及字幕内嵌。
3. Node.js: 推荐版本 v16+。

🚀 快速开始

1. 克隆仓库:

   git clone https://github.com/yourusername/quantum-downloader.git
   cd quantum-downloader

2. 安装依赖:

   npm install

3. 运行程序:

   • Mac/Linux: 直接双击运行 start_downloader.command 或在终端执行 node server.js。
   • Windows: 在终端执行 node server.js。

4. 访问界面: 在浏览器中打开 http://localhost:3000 即可开始使用。

---

📝 License

Distributed under the MIT License. See LICENSE for more information.