Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ivansaul/cli-video-compressor
A simple yet powerful command-line application designed for compressing videos. You can reduce the size of your video files while maintaining acceptable quality, which is useful for sharing videos online or saving storage space.
https://github.com/ivansaul/cli-video-compressor
cli ffmpeg python script video video-compressor
Last synced: about 1 month ago
JSON representation
A simple yet powerful command-line application designed for compressing videos. You can reduce the size of your video files while maintaining acceptable quality, which is useful for sharing videos online or saving storage space.
- Host: GitHub
- URL: https://github.com/ivansaul/cli-video-compressor
- Owner: ivansaul
- License: mit
- Created: 2024-10-01T01:31:17.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2024-10-10T08:33:13.000Z (4 months ago)
- Last Synced: 2024-12-17T16:12:01.667Z (about 2 months ago)
- Topics: cli, ffmpeg, python, script, video, video-compressor
- Language: Python
- Homepage:
- Size: 333 KB
- Stars: 20
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.es.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
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.
[](https://opensource.org/licenses/MIT)
---
![demo][demo]
## Instalación | Actualización
Asegúrate de haber instalado [*`Python 3.10+`*][python] y [*`FFmpeg`*][ffmpeg]. La aplicación CLI usa `FFmpeg` internamente, así que asegúrate de tenerlo instalado y agregado a tu PATH.
```console
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).
```console
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:
>
> ```console
> 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:
```console
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:
```console
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):
``` console
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:
```console
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:
```console
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:
```console
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):
```console
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:
```console
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`*][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í]][demo-windows].
## Contribuidores
## Mira mis otros proyectos
[](https://github.com/ivansaul/codigo_facilito_downloader)
[](https://github.com/ivansaul/personal-portfolio)
[](https://github.com/ivansaul/flutter_todo_app)
[python]:https://www.python.org/downloads/
[ffmpeg]:https://ffmpeg.org
[demo]:https://github.com/user-attachments/assets/9c9c672a-bfa3-418a-b7d1-89f0e7751146
[scoop]:https://scoop.sh
[demo-windows]: https://youtu.be/w1Pba7Bu0ZQ