为什么值得关注

提供 Windows 一键安装，确保在 iOS/Android 设备上流畅播放，并配有实时交互式均衡器显示下载进度。

适合谁使用

需要在移动设备上离线观看 YouTube 内容的用户
学习 React 与 Flask 集成的开发者
希望自行托管、注重隐私的下载工具使用者

典型使用场景

下载个人 YouTube 视频以便在手机上离线观看
将 YouTube 视频转换为 MP3 用于音乐收听
存档合法许可的内容以供离线访问

项目优势

Windows 一键批处理文件自动化安装和启动
重新编码为 H.264/AAC 的 MP4 格式，确保在手机和 PC 上通用兼容
实时交互式均衡器直观显示下载进度
持久本地下载历史记录，方便追踪已完成文件

使用前须知

仅用于教育/实验目的，用户必须遵守 YouTube 服务条款和版权
非 Windows 系统需要手动安装 ffmpeg 和 Node.js
未提供内置更新机制，也无明确维护承诺

README 快速开始

MTS.DOWNLOADER

Descargador local de video y audio de YouTube, con interfaz web moderna desarrollada en React + TypeScript y backend en Flask. Corre en tu máquina y convierte los archivos para garantizar máxima compatibilidad con teléfonos celulares (iOS/Android) y PC.

[!IMPORTANT] Aviso Legal / Fines Educativos: Este proyecto ha sido desarrollado exclusivamente con fines educativos y experimentales para el análisis de flujos de descarga y estructuración de aplicaciones modernas (React + Flask). El desarrollador no se hace responsable del uso indebido del software.

Requisitos

Python 3.9+ — python.org/downloads (marca "Add Python to PATH" al instalar).
Node.js 18+ — necesario para compilar la interfaz de React.
ffmpeg — necesario para unir video+audio en MP4 (H.264/AAC) y convertir a MP3.
- Windows: winget install ffmpeg (o descárgalo de ffmpeg.org y agrégalo al PATH).
- macOS: brew install ffmpeg
- Linux: sudo apt install ffmpeg

Instalación y arranque

Windows — un clic

Haz doble clic en run.bat. La primera vez instalará el entorno virtual de Python, instalará las dependencias de React (node_modules), compilará el frontend automáticamente e iniciará la aplicación abriéndola en tu navegador.

Manual (cualquier sistema)

1. Construir el Frontend de React:

cd frontend
npm install
npm run build
cd ..

2. Arrancar el Backend en Flask:

# Crear entorno virtual de Python
python -m venv .venv

# Activar entorno virtual
# Windows:
.venv\Scripts\activate
# macOS / Linux:
source .venv/bin/activate

# Instalar dependencias y correr
pip install -r requirements.txt
python app.py

Abre http://127.0.0.1:5000 en tu navegador.

Uso

Pega el enlace del video de YouTube en el campo y pulsa Analizar.
Elige Video o Audio.
Elige la calidad (resoluciones disponibles para ese video, o el bitrate de MP3).
Pulsa Grabar y Descargar Archivo. El ecualizador interactivo te mostrará el progreso en tiempo real. Al terminar, el navegador iniciará la descarga automáticamente.
Las descargas completadas se guardarán en el historial local persistente.

Notas técnicas

Frontend: Single-Page Application construida con React (TypeScript), Vite y CSS premium con soporte para

yt-downloader