A local YouTube video and audio downloader with a modern web interface (React + Flask) that converts files to H.264/AAC MP4 for mobile compatibility.

Stars

7

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-14

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a one-click Windows setup, guarantees playback on iOS/Android devices, and features a real-time interactive equalizer showing download progress.

Who it is for

  • Users who need offline access to YouTube content on mobile devices
  • Developers learning React with Flask integration
  • Individuals wanting a self-hosted, privacy-respecting downloader

Use cases

  • Downloading personal YouTube videos for offline viewing on smartphones
  • Converting YouTube videos to MP3 for music listening
  • Archiving legally permissible content for offline access

Strengths

  • One-click batch file for Windows automates installation and launch
  • Re-encodes videos to H.264/AAC in MP4 for universal mobile/PC compatibility
  • Interactive real-time equalizer provides visual download progress
  • Persistent local download history for tracking completed files

Considerations

  • Educational/experimental only; users must respect YouTube ToS and copyright
  • Requires manual installation of ffmpeg and Node.js on non-Windows systems
  • No built-in update mechanism or active maintenance guarantees

README quick start

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

  1. Python 3.9+python.org/downloads (marca "Add Python to PATH" al instalar).
  2. Node.js 18+ — necesario para compilar la interfaz de React.
  3. 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

  1. Pega el enlace del video de YouTube en el campo y pulsa Analizar.
  2. Elige Video o Audio.
  3. Elige la calidad (resoluciones disponibles para ese video, o el bitrate de MP3).
  4. Pulsa Grabar y Descargar Archivo. El ecualizador interactivo te mostrará el progreso en tiempo real. Al terminar, el navegador iniciará la descarga automáticamente.
  5. 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

Related repositories

Similar projects matched by category, topics, and programming language.

CodeDrobe
CodeDrobe GitHub avatar

skills

CodeDrobe Skills provides installable agent workflows for creating, managing, and publishing reversible themes in supported Chromium/Electron AI desktop apps like OpenAI Codex and Tencent WorkBuddy.

CSS
232
Brandon030722
Brandon030722 GitHub avatar

ark-ui-skill

Ark UI is a clean-room design system with five style families and four depth levels, enabling structured UI reconstruction and prototyping.

CSS
195
DutchDiederik
DutchDiederik GitHub avatar

AmberConsole

Amber Console is a zero-dependency CSS framework that recreates the monochrome amber-terminal look of late-1980s industrial control panels, using a single stylesheet and no JavaScript for appearance.

CSS
183