README.es.md

CLI Video Compressor

Pack es un compresor de videos CLI simple pero poderoso.

Reduce el tamaño de los archivos hasta un 60% mientras mantiene una alta calidad, utilizando FFmpeg como un sub-proceso. Comprime videos individuales o carpetas enteras con facilidad.

English ｜ Español

---

Instalación | Actualización

Asegúrate de haber instalado Python 3.10+ y FFmpeg. La aplicación CLI usa FFmpeg internamente, así que asegúrate de tenerlo instalado y agregado a tu PATH.

pip install -U vidpack

Requisitos previos

```console
# MacOS
brew install ffmpeg

# Ubuntu
sudo apt install ffmpeg

# ArchLinux
sudo pacman -S ffmpeg

# Fedora
sudo dnf install ffmpeg
```

Uso básico

Para comprimir un video o varios videos, usa el comando pack, seguido del argumento de entrada requerido (un archivo o un directorio).

pack INPUT [OPTIONS]

Note

INPUT: Este es el archivo o directorio que deseas procesar. Si proporcionas un directorio, todos los videos dentro de él serán comprimidos.

Tip

Para obtener ayuda adicional o ver todas las opciones disponibles, puedes usar el comando:

pack --help

Opciones

Pack ofrece varias opciones para personalizar el proceso de compresión:

• --output, -o: Especifica el archivo de salida donde se guardará el video comprimido.
• --quality, -q: Define el nivel de calidad del video (0-100). Valor predeterminado: 75.
• --overwrite, -w: Sobrescribe el archivo de salida si ya existe.
• --codec, -c: Especifica el codec de video a utilizar para la compresión. Valor predeterminado: h264. Solo se admiten codecs h264 y libx265.
• --delete-original, -d: Elimina el video original después de la compresión exitosa.
• --verbose, -v: Habilita el modo de depuración para obtener más información durante el proceso.

Important

El codec H265 (libx265) ofrece una mejor calidad de compresión y genera archivos más pequeños en comparación con H264. Sin embargo, la codificación con H265 toma más tiempo y requiere considerablemente más potencia de procesamiento. Si tienes una GPU moderna y suficiente tiempo para la codificación, H265 es una excelente opción para reducir el tamaño de los archivos sin comprometer la calidad.

Ejemplos de uso

Para comprimir un video llamado video.mp4, simplemente ejecuta:

pack video.mp4

Este comando comprimirá video.mp4 con los ajustes predeterminados (calidad: 75) y guardará el resultado como video_compressed.mp4 en el mismo directorio.

Ver más ejemplos

Especificar un archivo de salida

Si deseas especificar el nombre o la ubicación del archivo comprimido:

pack video.mp4 --output compressed/small_video.mp4

Este comando comprimirá video.mp4 y guardará el resultado como small_video.mp4 en el directorio compressed.

Ajustar la calidad de la compresión

Para comprimir un video con una calidad específica (por ejemplo, 60):

pack video.mp4 -q 60

Esto comprimirá el video con menor calidad, resultando en un archivo más pequeño.

Comprimir todos los videos en un directorio

Para comprimir todos los videos en un directorio:

pack /ruta/a/mis/videos

Este comando comprimirá todos los videos en el directorio especificado y guardará los resultados en el mismo directorio.

Sobrescribir archivos existentes

Si deseas sobrescribir archivos comprimidos existentes:

pack video.mp4 --output output.mp4 --overwrite

Esto sobrescribirá el archivo output.mp4 si ya existe.

Eliminar el archivo original después de la compresión

Para eliminar el archivo de video original después de una compresión exitosa:

pack video.mp4 --delete-original

El archivo original video.mp4 será eliminado después de la compresión.

Especificar un codec de video

Para comprimir un video con un codec de video específico (por ejemplo, libx265):

pack video.mp4 --codec libx265

Esto comprimirá el video con el codec libx265, resultando en un archivo más pequeño. Actualmente, solo se admiten los codecs h264 y libx265.

Usar múltiples opciones

Puedes combinar múltiples opciones en un solo comando:

pack video.mp4 -o compressed.mp4 -q 80 -w -d -v

Este comando comprimirá video.mp4 con una calidad de 80, guardará el resultado como compressed.mp4, sobrescribirá el archivo si existe, eliminará el original y mostrará información detallada durante el proceso.

Notas adicionales

• La opción de calidad (-q) afecta tanto la calidad visual como el tamaño del archivo. Un valor más bajo resultará en un archivo más pequeño pero con menor calidad visual, mientras que un valor más alto mantendrá mejor calidad pero con un archivo más grande.
• Siempre es recomendable hacer una copia de seguridad de tus videos originales antes de usar la opción de eliminación (-d).
• El modo detallado (-v) es útil para diagnosticar problemas o entender mejor el proceso de compresión.

Tip

Si eres usuario de Windows, puedes instalar ffmpeg y python manualmente o usando gestores de paquetes como Scoop. Una vez que hayas instalado un gestor de paquetes, solo debes ejecutar algo como scoop install python ffmpeg.

Tip

Los usuarios de Windows pueden ver un video tutorial en YouTube sobre el proceso de instalación [Aquí].

Contribuidores

Mira mis otros proyectos