💻 Instalación manual desde la fuente
+💻 Instalación manual desde el código fuente
### 1. Clonar el repositorio @@ -183,7 +184,7 @@ cd YTSage ### 2. Instalar dependencias -#### ⚡ Con ultravioleta +#### ⚡ Con uv ```bash uv pip install . @@ -195,7 +196,7 @@ uv pip install . pip install . ``` -### 3. Ejecute la aplicación +### 3. Ejecutar la aplicación ```bash python -m ytsage.main @@ -209,167 +210,171 @@ python -m ytsage.main |
-  |
+ |
+ |
| Configuración de descarga | -Descargar lista de reproducción | +Ajustes de descarga | +Descarga de lista de reproducción |
 |
-  |
+ |
+ |
| Formato de audio | -Opciones personalizadas | +Opción personalizada |
🎯 Uso básico
-1. **Inicie YTSage** -2. **Pegue la URL de YouTube** (o use el botón "Pegar URL") -3. **Haga clic en "Analizar"** -4. **Seleccione formato:** - - `Video` para descargas de videos +1. **Lanza YTSage** +2. **Pega la URL de YouTube** (o usa el botón "Paste URL") +3. **Haz clic en "Analyze"** +4. **Selecciona el formato:** + - `Video` para descargas de video - `Audio Only` para extracción de audio -5. **Elija Opciones:** - - Habilitar subtítulos y seleccionar idioma. - - Habilitar la combinación de subtítulos +5. **Elige opciones:** + - Activar subtítulos y elegir idioma + - Activar fusión de subtítulos - Guardar miniatura - - Eliminar segmentos de patrocinadores + - Eliminar segmentos patrocinados - Guardar descripción - - Insertar capítulos -6. **Seleccione el directorio de salida** -7. **Haga clic en "Descargar"** + - Integrar capítulos +6. **Selecciona directorio de salida** +7. **Haz clic en "Download"** -> 💡 El directorio de descarga predeterminado es la carpeta "Descargas" del usuario. +> 💡 El directorio de descarga predeterminado es la carpeta "Downloads" del usuario.
-
📋 Descarga de lista de reproducción
+📋 Descarga de listas de reproducción
-1. **Pegar URL de la lista de reproducción** -2. **Haga clic en "Analizar"** -3. **Seleccione videos del selector de lista de reproducción (opcional, el valor predeterminado es todos)** -4. **Elija el formato/calidad deseado** -5. **Haga clic en "Descargar"** +1. **Pega la URL de la lista de reproducción** +2. **Haz clic en "Analyze"** +3. **Selecciona videos del selector de listas (opcional, todos por defecto)** +4. **Elige formato/calidad deseada** +5. **Haz clic en "Download"** -> 💡 La aplicación maneja automáticamente la cola de descarga +> 💡 La aplicación gestiona las colas de descarga automáticamente, y puedes exportar entradas de la lista como archivos `.txt`, `.csv`, `.m3u` o `.json`.
-
🌍 Modo genérico para sitios que no son de YouTube
+🌍 Modo genérico para sitios que no son YouTube
-Utilice el modo genérico cuando desee que YTSage acepte URL de sitios compatibles con yt-dlp, como Dailymotion, CBC Gem, TikTok y otros. +Usa el modo genérico (Generic Mode) cuando desees que YTSage acepte URLs de sitios compatibles con yt-dlp, como Dailymotion, CBC Gem, TikTok y otros. Cómo usarlo: -1. Abra `Download Settings`. -2. Habilite `Generic Mode`. -3. Pegue una URL de lista de reproducción o video compatible que no sea de YouTube. -4. Haga clic en `Analyze`. -5. Elija un formato y descárguelo como de costumbre. +1. Abre `Download Settings`. +2. Activa `Generic Mode`. +3. Pega una URL de video o lista de reproducción compatible que no sea de YouTube. +4. Haz clic en `Analyze`. +5. Elige el formato y descarga como de costumbre. Notas: -- El modo genérico solo cambia la validación de URL dentro de YTSage. El sitio de destino aún debe ser compatible con la versión de yt-dlp instalada. -- Algunos sitios requieren cookies, una sesión de inicio de sesión, un proxy o argumentos yt-dlp adicionales según el extractor. -- Si un sitio falla, actualice primero yt-dlp desde la pestaña de actualización integrada antes de informar el problema. +- El modo genérico solo cambia la validación de la URL dentro de YTSage. El sitio debe ser compatible con tu versión instalada de yt-dlp. +- Algunos sitios requieren cookies, inicio de sesión, proxy o argumentos adicionales de yt-dlp dependiendo del extractor. +- Si un sitio falla, actualiza primero yt-dlp desde la pestaña de actualización integrada antes de informar del problema.
-
🧰 Opciones de descarga y medios
+🧰 Opciones de medios y descarga
-- **Opciones de subtítulos:** Filtrar idiomas e incrustar subtítulos en el archivo de video -- **Combinación de subtítulos:** Combina subtítulos en el archivo de video para obtener subtítulos codificados -- **Guardar descripción:** Guarde la descripción del video como un archivo de texto. -- **Guardar miniatura:** Guarda la miniatura del vídeo como un archivo de imagen. -- **Incrustar capítulos:** Incrustar marcadores de capítulos como metadatos para reproductores de video compatibles -- **Eliminar segmentos de patrocinador:** Elimina segmentos de patrocinador del video usando SponsorBlock -- **Recortar video:** Descargue solo partes específicas de un video especificando rangos de tiempo en formato `HH:MM:SS` +- **Opciones de subtítulos:** Filtra idiomas e incrusta subtítulos en el archivo de video. +- **Fusión de subtítulos:** Fusiona subtítulos en el archivo de video para subtítulos fijos (hardcoded). +- **Guardar descripción:** Guarda la descripción del video como un archivo de texto. +- **Guardar miniatura:** Guarda la miniatura del video como un archivo de imagen. +- **Integrar capítulos:** Incluye marcas de capítulo como metadatos para reproductores de video compatibles. +- **Eliminar segmentos patrocinados:** Elimina segmentos patrocinados del video usando SponsorBlock. +- **Recortar video:** Descarga solo partes específicas de un video especificando rangos de tiempo en formato `HH:MM:SS`.
-
⚙️ Configuración de archivos y salida
+⚙️ Ajustes de salida y archivos
+ +- **Limitador de velocidad:** Limita la velocidad de descarga, p. ej., `500K` para 500 KB/s. +- **Guardar ruta de descarga:** Guarda la ruta de descarga predeterminada para futuras descargas. Disponible en **Download Settings → Download Path**. +- **Resolución de video predeterminada:** Establece tu resolución de video preferida para selección automática (p. ej., 1080p, 720p). Disponible en **Download Settings → Default Video Resolution**. +- **Idiomas de subtítulos predeterminados:** Establece idiomas de subtítulos para selección automática (separados por comas, p. ej., `es,en`). Disponible en **Download Settings → Default Subtitle Languages**. +- **Formato de nombre de archivo:** Personaliza el formato del nombre de archivo usando variables como `%(title)s`, `%(uploader)s`, `%(playlist_index)s` y `%(resolution)s`. Disponible en **Download Settings → Filename Format**. +- **Forzar formato de salida:** Fuerza las descargas de video a un formato de contenedor específico como `mp4`, `webm` o `mkv`. Disponible en **Download Settings → Output Format Settings**. +- **Conversión de formato de audio:** Convierte descargas de solo audio a formatos preferidos como `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis` o `Best`. Disponible en **Download Settings → Audio Format Settings**. +- **Normalización de audio:** Estandariza el volumen para descargas de solo audio usando EBU R128. +- **Conexiones simultáneas:** Aumenta drásticamente la velocidad de descarga descargando archivos en múltiples fragmentos a la vez. Disponible en **Download Settings → General → Concurrent Connections** (1 por defecto, máximo recomendado 8-10 para evitar bloqueos por IP). -- **Limitador de velocidad:** Limita la velocidad de descarga, por ejemplo `500K` a 500 KB/s -- **Guardar ruta de descarga:** Guarde la ruta de descarga predeterminada para futuras descargas. Disponible en **Configuración de descarga → Ruta de descarga**. -- **Formato de nombre de archivo de salida:** Personalice el formato de nombre de archivo de salida usando variables como `%(title)s`, `%(uploader)s` y `%(resolution)s`. Disponible en **Configuración de descarga → Formato de nombre de archivo**. -- **Forzar formato de salida:** Fuerza las descargas de videos en un formato contenedor específico como `mp4`, `webm` o `mkv`. Disponible en **Configuración de descarga → Configuración de formato de salida**. -- **Conversión de formato de audio:** Convierta descargas de solo audio a formatos preferidos como `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis` o `Best`. Disponible en **Configuración de descarga → Configuración de formato de audio**. -- **Normalización de audio:** Estandarice el volumen para descargas de solo audio usando EBU R128. -- **Conexiones Concurrentes:** Aumente la velocidad de descarga drásticamente descargando archivos en múltiples fragmentos simultáneamente. Disponible en **Configuración de Descarga → General → Conexiones Concurrentes** (El valor predeterminado es 1, el máximo recomendado es 8-10 para evitar bloqueos de IP).\n
-:`
-- **Modo genérico:** Permita que YTSage analice y descargue desde sitios que no sean de YouTube compatibles con yt-dlp. Habilítelo desde **Configuración de descarga → Modo genérico**.
+ 1. **Recomendado:** Usa la opción integrada `Extract cookies from browser` en la aplicación, luego selecciona tu navegador y opcionalmente un perfil.
+ 2. Alternativamente, extrae las cookies manualmente:
+ a. Exporta cookies de tu navegador usando una extensión como [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file)
+ b. Copia las cookies en formato Netscape
+ c. Crea un archivo llamado `cookies.txt` y pega las cookies
+ d. Selecciona el archivo `cookies.txt` en la aplicación
+- **Soporte de proxy:** Usa un servidor proxy para las descargas, p. ej., `http://:`
+- **Modo genérico:** Permite a YTSage analizar y descargar desde sitios que no son YouTube compatibles con yt-dlp. Actívalo en **Download Settings → Generic Mode**.
🌐 Acceso y Red
+🌐 Acceso y red
-- **Iniciar sesión con cookies:** Inicie sesión en YouTube utilizando cookies para acceder a contenido privado. +- **Inicio de sesión con cookies:** Inicia sesión en YouTube usando cookies para acceder a contenido privado. Cómo usarlo: - 1. **Recomendado:** Utilice la opción `Extract cookies from browser` incorporada en la aplicación, luego seleccione su navegador y, opcionalmente, un perfil. - 2. Alternativamente, extraiga las cookies manualmente: - un. Exporte cookies desde su navegador usando una extensión como [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) - B. Copiar las cookies en formato Netscape - c. Cree un archivo llamado `cookies.txt` y pegue las cookies en él - d. Seleccione el archivo `cookies.txt` en la aplicación -- **Soporte de proxy:** Utilice un servidor proxy para descargas, por ejemplo `http://
-
🛠️ Herramientas y Mantenimiento
+🛠️ Herramientas y mantenimiento
-- **Comandos personalizados:** Acceda a funciones avanzadas de yt-dlp a través de argumentos de línea de comando -- **Pestaña Actualizador:** Administre las herramientas de actualización integradas desde un solo lugar en Opciones personalizadas: - - **Actualizaciones de yt-dlp:** Busque actualizaciones y cambie entre los canales de lanzamiento estable y nocturno - - **Comprobador de versiones de FFmpeg:** Verifique su versión de FFmpeg y abra las guías de instalación - - **Actualizaciones de Deno:** Verifique y actualice el tiempo de ejecución de Deno -- **Detección de FFmpeg/yt-dlp/Deno:** Detecta automáticamente las rutas y versiones de FFmpeg, yt-dlp y Deno desde el cuadro de diálogo Acerca de. -- **Historial de descargas:** Vea descargas anteriores con miniaturas y estados desde el botón **Historial**. +- **Comandos personalizados:** Accede a funciones avanzadas de yt-dlp mediante argumentos de línea de comandos. +- **Pestaña de actualización:** Gestiona herramientas de actualización desde un solo lugar en Opciones personalizadas: + - **Actualizaciones de yt-dlp:** Busca actualizaciones y cambia entre canales estable y nightly. + - **Verificador de versión de FFmpeg:** Verifica tu versión de FFmpeg y abre guías de instalación. + - **Actualizaciones de Deno:** Verifica y actualiza el motor de ejecución Deno. +- **Detección de FFmpeg/yt-dlp/Deno:** Detecta automáticamente rutas y versiones de FFmpeg, yt-dlp y Deno desde el diálogo Acerca de. +- **Historial de descargas:** Visualiza descargas pasadas con miniaturas y estados desde el botón **History**.🌍 Localización
-YTSage admite **14 idiomas** para accesibilidad mundial. Seleccione su idioma preferido en **Opciones personalizadas → Idioma**. +YTSage soporta **14 idiomas** para accesibilidad global. Selecciona tu idioma preferido en **Custom Options → Language**. -### Idiomas admitidos +### Idiomas soportados | Idioma | Código | Idioma | Código | |----------|------|----------|------| | 🇺🇸 Inglés | `en` | 🇪🇸 Español | `es` | | 🇸🇦 Árabe | `ar` | 🇫🇷 Francés | `fr` | -| 🇩🇪 Alemán | `de` | 🇮🇳 hindi | `hi` | +| 🇩🇪 Alemán | `de` | 🇮🇳 Hindi | `hi` | | 🇮🇩 Indonesio | `id` | 🇮🇹 Italiano | `it` | | 🇯🇵 Japonés | `ja` | 🇵🇱 Polaco | `pl` | | 🇧🇷 Portugués | `pt` | 🇷🇺 Ruso | `ru` | | 🇹🇷 Turco | `tr` | 🇨🇳 Chino | `zh` | -### Léame Traducciones +### Traducciones del README | Idioma | Archivo | Idioma | Archivo | |----------|------|----------|------| -| 🇺🇸 Inglés | [README.md](../README.md) | 🇪🇸 Español | [README.es.md](README.es.md) +| 🇺🇸 Inglés | [README.md](README.md) | 🇪🇸 Español | [README.es.md](README.es.md) | | 🇸🇦 Árabe | [README.ar.md](README.ar.md) | 🇫🇷 Francés | [README.fr.md](README.fr.md) | -| 🇩🇪 Alemán | [README.de.md](README.de.md) | 🇮🇳 hindi | [README.hi.md](README.hi.md) | +| 🇩🇪 Alemán | [README.de.md](README.de.md) | 🇮🇳 Hindi | [README.hi.md](README.hi.md) | | 🇮🇩 Indonesio | [README.id.md](README.id.md) | 🇮🇹 Italiano | [README.it.md](README.it.md) | | 🇯🇵 Japonés | [README.ja.md](README.ja.md) | 🇵🇱 Polaco | [README.pl.md](README.pl.md) | | 🇧🇷 Portugués | [README.pt.md](README.pt.md) | 🇷🇺 Ruso | [README.ru.md](README.ru.md) | | 🇹🇷 Turco | [README.tr.md](README.tr.md) | 🇨🇳 Chino | [README.zh.md](README.zh.md) | -> 💡 **¿Quieres contribuir con una traducción?** ¡Consulta la sección [Contributing](#contributing) para ayudarnos a agregar más idiomas! +> 💡 **¿Quieres contribuir con una traducción?** ¡Consulta la sección de [Contribución](#contributing) para ayudarnos a añadir más idiomas!
--ffmpeg.exe`, que viene incluido con FFmpeg.
+ - **Videos privados:** Usa autenticación por cookies para acceder a contenido privado.
+ - **Contenido con restricción de edad:** Inicia sesión en tu cuenta de YouTube para ver videos restringidos.
+ - **Videos bloqueados geográficamente:** Considera usar una VPN para saltar restricciones regionales.
+ - **Videos eliminados:** El video ya no está disponible en YouTube.
+ - **Transmisiones en vivo:** Los directos no se pueden descargar; espera a que la transmisión termine.
+ - **Errores de red:** Verifica tu conexión a internet e inténtalo de nuevo.
+ - **URLs no válidas:** Asegúrate de que la URL sea correcta y de una plataforma compatible.
+ - **Contenido Premium:** Requiere suscripción a YouTube Premium.
+ - **Bloqueos por copyright:** El contenido está bloqueado por restricciones de derechos de autor.
+- **Archivos de video y audio separados tras descarga:** Esto sucede cuando falta FFmpeg o no se detecta. YTSage requiere FFmpeg para fusionar flujos de video y audio de alta calidad.
+ - **Solución:** Asegúrate de que FFmpeg esté instalado y accesible en el PATH de tu sistema. Para usuarios de Windows, la opción más fácil es descargar el archivo `YTSage-v-ffmpeg.exe`, que incluye FFmpeg.
---
-#### 🛡️ Advertencia de Windows Defender/Antivirus
+#### 🛡️ Advertencia de Windows Defender / Antivirus
-Algunos programas antivirus pueden marcar los archivos `.exe` como falsos positivos. Esta es una **limitación conocida** de las aplicaciones empaquetadas.
+Algunos programas antivirus pueden marcar archivos `.exe` como falsos positivos. Esta es una **limitación conocida** de las aplicaciones empaquetadas.
**Por qué sucede esto:**
-- La heurística antivirus puede identificar erróneamente ejecutables empaquetados como sospechosos.
+- La heurística de los antivirus puede identificar erróneamente ejecutables empaquetados como sospechosos.
**Alternativas seguras:**
-- ✅ **Usar instalación de pip:** `pip install ytsage` (recomendado)
-- ✅ **Construir desde la fuente**: siguiendo esto [guide](../.github/CI_CD_README.md)
-- ✅ **Incluye la aplicación en la lista blanca** en tu software antivirus
+- ✅ **Usa la instalación de pip:** `pip install ytsage` (Recomendado)
+- ✅ **Construye desde el código fuente**: siguiendo esta [guía](.github/CI_CD_README.md)
+- ✅ **Añade la aplicación a la lista blanca** en tu software antivirus.
#### 🍎 macOS: "La aplicación está dañada y no se puede abrir"
-Si ve este error en macOS Sonoma o posterior, debe eliminar el atributo de cuarentena.
+Si ves este error en macOS Sonoma o más reciente, necesitas eliminar el atributo de cuarentena.
-1. **Abrir Terminal** (puedes encontrarlo usando Spotlight).
-2. **Escriba el siguiente comando** pero **no** presione Entrar todavía. Asegúrate de incluir el espacio al final:
+1. **Abre el Terminal** (puedes encontrarlo usando Spotlight).
+2. **Escribe el siguiente comando** pero **no presiones** Enter todavía. Asegúrate de incluir el espacio al final:
```bash
xattr -d com.apple.quarantine
```
-3. **Arrastre el archivo `YTSage.app`** desde la ventana de su Finder y suéltelo directamente en la ventana de Terminal. Esto pegará automáticamente la ruta del archivo correcta.
-4. **Presione Entrar** para ejecutar el comando.
-5. **Intenta abrir YTSage.app nuevamente.** Ahora debería iniciarse correctamente.
+3. **Arrastra el archivo `YTSage.app`** desde tu ventana de Finder y suéltalo directamente en la ventana del Terminal. Esto pegará automáticamente la ruta correcta del archivo.
+4. **Presiona Enter** para ejecutar el comando.
+5. **Intenta abrir YTSage.app de nuevo.** Ahora debería lanzarse correctamente.
---
-#### **Ubicaciones de configuración (avanzada)**
+#### **Ubicaciones de configuración (Avanzado)**
- **Windows:** `%LOCALAPPDATA%\YTSage`
- **macOS:** `~/Library/Application Support/YTSage`
- **Linux:** `~/.local/share/YTSage`
@@ -430,40 +435,40 @@ Si ve este error en macOS Sonoma o posterior, debe eliminar el atributo de cuare
-## 💖 Patrocinador
+## 💖 Patrocinar
-Si YTSage le ahorra tiempo, considere patrocinar el proyecto. El patrocinio ayuda a cubrir el tiempo de desarrollo, las pruebas en todas las plataformas y las mejoras futuras.
+Si YTSage te ahorra tiempo, considera patrocinar el proyecto. El patrocinio ayuda a cubrir tiempo de desarrollo, pruebas en todas las plataformas y futuras mejoras.
-- Patrocinadores de GitHub: https://github.com/sponsors/oop7
-- El enlace del patrocinador también está disponible directamente dentro de la aplicación desde el cuadro de diálogo Acerca de.
+- GitHub Sponsors: https://github.com/sponsors/oop7
+- El enlace de patrocinio también está disponible directamente en la aplicación a través del diálogo Acerca de.
[](https://github.com/sponsors/oop7)
-## 👥 Contribuyendo
+## 👥 Contribuir
-¡Agradecemos las contribuciones! Así es como puedes ayudar:
+¡Agradecemos las contribuciones! Aquí tienes cómo puedes ayudar:
-1. 🍴 Bifurca el repositorio
-2. 🌿 Crea tu rama de funciones:
+1. 🍴 Haz un Fork del repositorio
+2. 🌿 Crea tu rama de características:
```bash
git checkout -b feature/AmazingFeature
```
-3. 💾 Confirme sus cambios:
+3. 💾 Haz commit de tus cambios:
```bash
git commit -m 'Add some AmazingFeature'
```
-4. 📤 Empuje a la sucursal:
+4. 📤 Haz Push a la rama:
```bash
git push origin feature/AmazingFeature
```
-5. 🔄 Abra una solicitud de extracción
+5. 🔄 Abre un Pull Request
-### 🌍 Contribuyendo con traducciones
+### 🌍 Contribuir con traducciones
-- Actualice el archivo README localizado coincidente (por ejemplo `README.es.md`)
-- Mantenga las cadenas de aplicaciones sincronizadas editando `ytsage/languages/Haga clic para ver problemas y soluciones comunes
+Haz clic para ver problemas comunes y soluciones
-- **La tabla de formato no se muestra:** Actualice yt-dlp a la última versión y cambie a yt-dlp todas las noches. -- **La descarga falla:** Verifique su conexión a Internet y asegúrese de que el video esté disponible. +- **La tabla de formatos no aparece:** Actualiza yt-dlp a la última versión y cambia a yt-dlp nightly. +- **Fallo de descarga:** Verifica tu conexión a internet y asegúrate de que el video esté disponible. - **Errores de descarga específicos:** - - **Vídeos privados:** Utilice la autenticación de cookies para acceder a contenido privado. - - **Contenido restringido por edad:** Inicie sesión en su cuenta de YouTube para ver videos restringidos por edad. - - **Videos bloqueados geográficamente:** Considere usar una VPN para evitar las restricciones regionales. - - **Videos eliminados/eliminados:** El video ya no está disponible en YouTube. - - **Transmisiones en vivo:** Las transmisiones en vivo no se pueden descargar; espera a que termine la transmisión. - - **Errores de red:** Verifica tu conexión a Internet y vuelve a intentarlo. - - **URL no válidas:** Asegúrese de que la URL sea correcta y provenga de una plataforma compatible. - - **Contenido premium:** Requiere membresía de YouTube Premium. - - **Bloqueos de derechos de autor:** El contenido está bloqueado debido a restricciones de derechos de autor. -- **Separar archivos de video y audio después de la descarga:** Esto sucede cuando falta FFmpeg o no se detecta. YTSage requiere FFmpeg para fusionar transmisiones de audio y video de alta calidad. - - **Solución:** Asegúrese de que FFmpeg esté instalado y sea accesible en la RUTA de su sistema. Para los usuarios de Windows, la opción más sencilla es descargar el archivo `YTSage-v.json`
-- Si falta su idioma, comience desde `README.md` y cree `README..md`
+- Actualiza el archivo README localizado correspondiente (p. ej., `readme-translations/README.es.md`)
+- Mantén las cadenas de la aplicación sincronizadas editando `ytsage/languages/.json`
+- Si falta tu idioma, comienza desde `README.md` y crea `README..md`
📂 Estructura del proyecto
@@ -476,58 +481,58 @@ Este documento describe la estructura de carpetas organizada de YTSage.
```
YTSage/
-├── 📁 .github/ # GitHub configuration
-│ ├── 📁 ISSUE_TEMPLATE/ # Issue templates
-│ │ └── 🐛-bug-report.md # Bug report template
-│ ├─── 📁 workflows/ # GitHub Actions workflows
-│ │ ├── build-linux.yml # Linux build workflow
-│ │ ├── build-macos.yml # macOS build workflow
-│ │ │── build-windows.yml # Windows build workflow
-| | └── release-all.yml # Master release workflow
-│ └── 📄 CI_CD_README.md # CI/CD documentation
-├── 📁 branding/ # Branding assets (Screenshots, SVGs)
-│ ├── 📁 icons/ # Application icons
-│ ├── 📁 screenshots/ # Screenshots for documentation
-│ └── 📁 svg/ # SVG assets
-├── 📄 LICENSE # License file
-├── 📄 pyproject.toml # Project metadata and dependencies
-├── 📄 README.md # Project documentation
-├── 📄 requirements.txt # Python dependencies (dev)
-└── 📁 ytsage/ # Source package
- ├── 📁 assets/ # Runtime assets
- │ ├── 📁 Icon/ # Application icons
- │ └── 📁 sound/ # Audio files
- ├── 📁 languages/ # Localization files
- │ ├── 📄 ar.json # Arabic translation
- │ ├── 📄 de.json # German translation
- │ ├── 📄 en.json # English translation
- │ └── ... # Other languages
- ├── 📁 core/ # Core business logic
- │ ├── 📄 __init__.py # Core package init
- │ ├── 📄 ytsage_deno.py # Deno integration
- │ ├── 📄 ytsage_downloader.py # Download functionality
- │ ├── 📄 ytsage_ffmpeg.py # FFmpeg integration
- │ ├── 📄 ytsage_utils.py # Utility functions
- │ └── 📄 ytsage_yt_dlp.py # yt-dlp integration
- ├── 📁 gui/ # User interface components
- │ ├── 📄 __init__.py # GUI package init
- │ ├── 📄 ytsage_gui_main.py # Main application window
- │ └── 📁 ytsage_gui_dialogs/ # Dialog classes
- ├── 📁 utils/ # Utility modules
- │ ├── 📄 __init__.py # Utils package init
- │ ├── 📄 ytsage_config_manager.py # Configuration management
- │ └── 📄 ytsage_logger.py # Logging utilities
- ├── 📄 __init__.py # Package entry point
- └── 📄 main.py # Main execution script
+├── 📁 .github/ # Configuración de GitHub
+│ ├── 📁 ISSUE_TEMPLATE/ # Plantillas de problemas
+│ │ └── 🐛-bug-report.md # Plantilla de informe de errores
+│ ├─── 📁 workflows/ # Flujos de trabajo de GitHub Actions
+│ │ ├── build-linux.yml # Flujo de construcción para Linux
+│ │ ├── build-macos.yml # Flujo de construcción para macOS
+│ │ │── build-windows.yml # Flujo de construcción para Windows
+| | └── release-all.yml # Flujo de liberación maestra
+│ └── 📄 CI_CD_README.md # Documentación de CI/CD
+├── 📁 branding/ # Activos de marca (Capturas de pantalla, SVGs)
+│ ├── 📁 icons/ # Iconos de la aplicación
+│ ├── 📁 screenshots/ # Capturas de pantalla para documentación
+│ └── 📁 svg/ # Activos SVG
+├── 📄 LICENSE # Archivo de licencia
+├── 📄 pyproject.toml # Metadatos del proyecto y dependencias
+├── 📄 README.md # Documentación del proyecto
+├── 📄 requirements.txt # Dependencias de Python (dev)
+└── 📁 ytsage/ # Paquete de código fuente
+ ├── 📁 assets/ # Activos en tiempo de ejecución
+ │ ├── 📁 Icon/ # Iconos de la aplicación
+ │ └── 📁 sound/ # Archivos de audio
+ ├── 📁 languages/ # Archivos de localización
+ │ ├── 📄 ar.json # Traducción al árabe
+ │ ├── 📄 de.json # Traducción al alemán
+ │ ├── 📄 en.json # Traducción al inglés
+ │ └── ... # Otros idiomas
+ ├── 📁 core/ # Lógica de negocio principal
+ │ ├── 📄 __init__.py # Init del paquete core
+ │ ├── 📄 ytsage_deno.py # Integración con Deno
+ │ ├── 📄 ytsage_downloader.py # Funcionalidad de descarga
+ │ ├── 📄 ytsage_ffmpeg.py # Integración con FFmpeg
+ │ ├── 📄 ytsage_utils.py # Funciones de utilidad
+ │ └── 📄 ytsage_yt_dlp.py # Integración con yt-dlp
+ ├── 📁 gui/ # Componentes de interfaz de usuario
+ │ ├── 📄 __init__.py # Init del paquete GUI
+ │ ├── 📄 ytsage_gui_main.py # Ventana principal de la aplicación
+ │ └── 📁 ytsage_gui_dialogs/ # Clases de diálogos
+ ├── 📁 utils/ # Módulos de utilidad
+ │ ├── 📄 __init__.py # Init del paquete utils
+ │ ├── 📄 ytsage_config_manager.py # Gestión de configuración
+ │ └── 📄 ytsage_logger.py # Utilidad de registro
+ ├── 📄 __init__.py # Punto de entrada del paquete
+ └── 📄 main.py # Script de ejecución principal
```
-## ⭐️ Historia de las estrellas
+## ⭐️ Historial de estrellas
-## Historia de las estrellas
+## Star History
@@ -541,16 +546,16 @@ YTSage/
## 📜 Licencia
-Este proyecto tiene la licencia MIT; consulte el archivo [LICENSE](../LICENSE) para obtener más detalles.
+Este proyecto está bajo la Licencia MIT - mira el archivo [LICENSE](LICENSE) para más detalles.
## 🙏 Agradecimientos
-Mostrar agradecimientos
+Ver agradecimientos
-Un sincero agradecimiento a todos los que contribuyeron a este proyecto abriendo un problema para sugerir una mejora o informar un error.
+Muchas gracias a todos los que han contribuido a este proyecto abriendo un problema para sugerir una mejora o informar de un error.