🎥 YouTube Downloader

Aplicación nativa de macOS para descargar videos de YouTube en alta calidad

Características • Instalación • Uso • Arquitectura

---

✨ Características

• 🎬 Descarga hasta 4K (2160p) - Máxima calidad disponible con merge automático
• 🚀 100% Portable - Todo incluido: Python, pytubefix y ffmpeg empaquetados
• 🎨 Interfaz moderna - Diseño nativo con Swift/SwiftUI 5.9
• 📊 Progreso en tiempo real - Visualiza el avance byte a byte
• 🎵 Audio MP3 - Extrae solo el audio en alta calidad
• 🖼️ Vista previa - Thumbnail y detalles del video antes de descargar
• 📁 Auto-apertura - Finder se abre automáticamente al finalizar
• 🧹 Limpieza automática - Vista se resetea después de cada descarga
• 💻 Sin emojis en logs - Interfaz profesional y limpia

📦 Instalación

Para Usuarios Finales

1. Descarga DownloadTool-Portable-FIXED.zip (60 MB)
2. Descomprime el archivo
3. Arrastra DownloadTool.app a tu carpeta Aplicaciones
4. Abre la app (doble click)

Primera ejecución (Gatekeeper)

Si macOS bloquea la app por Gatekeeper:

xattr -cr /Applications/DownloadTool.app

O: Click derecho → Abrir → Abrir

✅ Sin Requisitos Adicionales

La app es completamente standalone:

• ✅ Python 3.14 incluido (empaquetado con PyInstaller)
• ✅ pytubefix 10.3.6 incluido
• ✅ ffmpeg incluido para merge de video + audio
• ❌ No requiere Homebrew
• ❌ No requiere instalación de Python
• ❌ No requiere pip install

🚀 Uso

1. Pega un link de YouTube en el campo de búsqueda
2. Click en el botón de búsqueda 🔍
3. Verás el thumbnail y detalles del video
4. Selecciona la calidad deseada (o solo audio)
5. Click en Descargar Ahora
6. 📁 Finder se abre automáticamente mostrando el archivo descargado

Los videos se guardan en:

~/Downloads/MateoTool/Downloads/

🎯 Calidades Disponibles

Calidad	Resolución	Merge Automático
4K	2160p	✅ Video + Audio
2K	1440p	✅ Video + Audio
Full HD	1080p	✅ Video + Audio
HD	720p	⚡ Progressive
SD	480p, 360p	⚡ Progressive

Nota: Las calidades 1080p+ requieren merge de video + audio separados. ffmpeg está incluido en el bundle.

🛠️ Compilación desde Código (Desarrolladores)

Requisitos de Desarrollo

• macOS 13.0+
• Xcode 15.0+
• Homebrew (para ffmpeg)
• Python 3.8+ (para PyInstaller)

Clonar el Repositorio

git clone https://github.com/Mats2208/DownloadYoutubeTool.git
cd DownloadTool

Setup de FFmpeg y Dylibs

# Instalar ffmpeg (si no lo tienes)
brew install ffmpeg

# Las dylibs de ffmpeg se almacenan fuera del proyecto para evitar link automático
mkdir -p ~/temp_ffmpeg_libs

# Copiar dylibs necesarias
cp /opt/homebrew/Cellar/ffmpeg/*/lib/libav*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/Cellar/ffmpeg/*/lib/libsw*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/opt/libvpx/lib/libvpx.*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/opt/dav1d/lib/libdav1d.*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/opt/lame/lib/libmp3lame.*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/opt/opus/lib/libopus.*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/opt/svt-av1/lib/libSvtAv1Enc.*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/opt/x264/lib/libx264.*.dylib ~/temp_ffmpeg_libs/
cp /opt/homebrew/opt/x265/lib/libx265.*.dylib ~/temp_ffmpeg_libs/

# Copiar ffmpeg binary
cp $(which ffmpeg) DownloadTool/Resources/bin/
chmod +x DownloadTool/Resources/bin/ffmpeg

Compilar el Ejecutable Standalone (Opcional)

Si modificaste download_youtube.py, recompila el ejecutable:

# Crear entorno virtual
python3 -m venv .venv
source .venv/bin/activate

# Instalar dependencias
pip install pytubefix pyinstaller

# Compilar ejecutable
cd DownloadTool
python -m PyInstaller --onefile --name youtube_downloader \
    --collect-all pytubefix --clean download_youtube.py

# Copiar al proyecto
cp dist/youtube_downloader Resources/
chmod +x Resources/youtube_downloader

# Limpiar
rm -rf build dist youtube_downloader.spec
cd ..
deactivate

Compilar la App

# Limpiar builds anteriores
rm -rf build/

# Compilar desde terminal
xcodebuild -project DownloadTool.xcodeproj -configuration Debug build

# O desde Xcode: Product → Build (⌘+B)

Empaquetar FFmpeg Dylibs

Después de compilar, ejecuta el script para copiar y configurar las dylibs:

# Copiar dylibs y reescribir paths con install_name_tool
python3 ffmpeg_bundle.py Debug

# Firmar todo (ad-hoc signature)
for dylib in build/Debug/DownloadTool.app/Contents/Resources/ffmpeg_libs/*.dylib; do
    codesign --force --sign - "$dylib"
done
codesign --force --sign - "build/Debug/DownloadTool.app/Contents/Resources/ffmpeg"
codesign --force --sign - "build/Debug/DownloadTool.app/Contents/Resources/youtube_downloader"
codesign --force --sign - "build/Debug/DownloadTool.app"

Crear Distribución ZIP

# Crear ZIP sin metadata de macOS
cd build/Debug
ditto -c -k --keepParent --norsrc DownloadTool.app "../../DownloadTool-Portable.zip"
cd ../..

# El ZIP estará en la raíz del proyecto
ls -lh DownloadTool-Portable.zip

Notas Importantes para el Build

⚠️ Las dylibs de ffmpeg NO deben estar en DownloadTool/Resources/ffmpeg_libs/ durante la compilación, porque Xcode las enlazaría automáticamente al binario principal. Por eso se guardan en ~/temp_ffmpeg_libs/ y se copian después del build con ffmpeg_bundle.py.

⚠️ ffmpeg_bundle.py usa install_name_tool para reescribir todos los load paths de las dylibs de rutas absolutas (/opt/homebrew/...) a rutas relativas (@loader_path/ffmpeg_libs/...), haciendo el app portable.

⚠️ Cada vez que uses install_name_tool se invalida la firma del código, por eso hay que re-firmar todo con codesign.

🏗️ Arquitectura

┌─────────────────────────────────────┐
│   SwiftUI Interface                 │
│   (DownloaderView.swift)            │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│   YouTubeManager (Singleton)        │
│   - Process management              │
│   - Environment variables (FFMPEG)  │
│   - JSON communication              │
└──────────────┬──────────────────────┘
               │
         ┌─────┴─────┐
         │           │
┌────────▼─────┐ ┌──▼────────────────┐
│ youtube_     │ │ Python + Script   │
│ downloader   │ │ (Fallback Dev)    │
│ (9.9 MB)     │ │                   │
└──────────────┘ └───────────────────┘
         │           │
         └─────┬─────┘
               │
┌──────────────▼──────────────────────┐
│   pytubefix (YouTube API)           │
│   - Stream resolution detection     │
│   - Progressive/Adaptive formats    │
│   - Download with progress          │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│   ffmpeg (Bundle: 432 KB)           │
│   - Merge video + audio streams     │
│   - Format: -c:v copy -c:a aac      │
└─────────────────────────────────────┘

Componentes Principales

Componente	Descripción	Tamaño
DownloaderView.swift	UI SwiftUI moderna (650x800px)	-
YouTubeManager.swift	Singleton, maneja procesos y estado	-
download_youtube.py	Script Python con pytubefix	10 KB
youtube_downloader	Python 3.14 + pytubefix empaquetado	8.1 MB
ffmpeg	Herramienta de merge incluida	432 KB

🔄 Flujo de Descarga 1080p+

1. Usuario selecciona 1080p
   ↓
2. Manager ejecuta: youtube_downloader download <url> 1080p
   ↓
3. Python (pytubefix) descarga:
   - video_12345.mp4 (1080p sin audio)
   - audio_12345.m4a (audio high quality)
   ↓
4. Manager pasa FFMPEG_PATH al proceso
   ↓
5. Python ejecuta ffmpeg desde bundle:
   ffmpeg -i video.mp4 -i audio.m4a -c:v copy -c:a aac final.mp4
   ↓
6. Archivos temporales eliminados
   ↓
7. ✅ Video final con audio → Finder auto-abre → Vista se limpia

🐛 Solución de Problemas

"La app está dañada y no se puede abrir"

xattr -cr /Applications/DownloadTool.app

Videos sin audio en 1080p+

Solución: La versión v3-FIXED incluye ffmpeg empaquetado. Descarga la última versión.

Error al buscar video

• Verifica que el link sea válido de YouTube
• Comprueba tu conexión a internet
• Algunos videos tienen restricciones regionales o de edad

Logs del sistema

La app muestra logs en la parte inferior. Haz click en "Logs del sistema" para expandir y ver detalles del proceso.

📊 Especificaciones Técnicas

Componente	Versión/Info
Plataforma	macOS 13.0+ (Apple Silicon + Intel)
Swift	5.9
SwiftUI	5.9
Python	3.14.2 (empaquetado)
pytubefix	10.3.6
ffmpeg	8.0.1
PyInstaller	6.18.0
Tamaño Total	44 MB (comprimido)

⚠️ Aviso Legal

Esta herramienta es solo para uso personal y educativo. El usuario es responsable de:

• Respetar los términos de servicio de YouTube
• Cumplir las leyes de copyright de su región
• Descargar únicamente contenido del que tenga derechos

📝 Licencia

MIT License - Ver LICENSE para más detalles.

---

Hecho con ❤️ usando Swift y Python

Reportar Bug • Solicitar Feature

2. Crea una rama para tu feature (`git checkout -b feature/AmazingFeature`) 3. Commit tus cambios (`git commit -m 'Add some AmazingFeature'`) 4. Push a la rama (`git push origin feature/AmazingFeature`) 5. Abre un Pull Request

📞 Soporte

Si encuentras algún problema:

1. Revisa la sección Solución de Problemas
2. Verifica los logs del sistema en la app
3. Abre un issue con los detalles

---

Hecho con ❤️ usando Swift y Python

⭐ Si te gusta este proyecto, dale una estrella en GitHub ⭐