{"id":15941448,"url":"https://github.com/ivansaul/cli-video-compressor","last_synced_at":"2025-09-03T16:31:18.482Z","repository":{"id":257812209,"uuid":"865703041","full_name":"ivansaul/CLI-Video-Compressor","owner":"ivansaul","description":"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.","archived":false,"fork":false,"pushed_at":"2024-10-10T08:33:13.000Z","size":341,"stargazers_count":20,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-17T16:12:01.667Z","etag":null,"topics":["cli","ffmpeg","python","script","video","video-compressor"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivansaul.png","metadata":{"files":{"readme":"README.es.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-01T01:31:17.000Z","updated_at":"2024-12-10T02:22:17.000Z","dependencies_parsed_at":"2024-10-06T06:59:39.786Z","dependency_job_id":"5c413cff-c83f-4539-bd31-12c448fcb897","html_url":"https://github.com/ivansaul/CLI-Video-Compressor","commit_stats":null,"previous_names":["ivansaul/cli-video-compressor"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivansaul%2FCLI-Video-Compressor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivansaul%2FCLI-Video-Compressor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivansaul%2FCLI-Video-Compressor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivansaul%2FCLI-Video-Compressor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivansaul","download_url":"https://codeload.github.com/ivansaul/CLI-Video-Compressor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231900365,"owners_count":18443175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","ffmpeg","python","script","video","video-compressor"],"created_at":"2024-10-07T07:04:19.929Z","updated_at":"2025-09-03T16:31:18.470Z","avatar_url":"https://github.com/ivansaul.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable MD033 MD036 MD041 MD045 MD046 --\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg width=\"200\" src=\"https://i.imgur.com/HeeZxH3.png\" alt=\"Coco Logo\"\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n\n\u003ch1 style=\"border-bottom: none\"\u003e\n    \u003cb\u003e\u003ca href=\"#\"\u003eCLI Video Compressor\u003c/a\u003e\u003c/b\u003e\n\u003c/h1\u003e\n\n***`Pack`*** es un compresor de videos CLI simple pero poderoso.\n\nReduce 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.\n\n![GitHub repo size](https://img.shields.io/github/repo-size/ivansaul/CLI-Video-Compressor)\n![GitHub stars](https://img.shields.io/github/stars/ivansaul/CLI-Video-Compressor)\n![GitHub forks](https://img.shields.io/github/forks/ivansaul/CLI-Video-Compressor)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n\u003ca href=\"https://discord.gg/tDvybtJ7y9\"\u003e\n    \u003cimg alt=\"Discord Server\" height=\"50\" src=\"https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg\"\u003e\n\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/ivansaul/CLI-Video-Compressor/blob/master/README.md\"\u003eEnglish\u003c/a\u003e\n    ｜\n    \u003ca href=\"https://github.com/ivansaul/CLI-Video-Compressor/blob/master/README.es.md\"\u003eEspañol\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n\n---\n\n![demo][demo]\n\n## Instalación | Actualización\n\nAsegú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.\n\n```console\npip install -U vidpack\n```\n\n\u003cdetails\u003e\n    \u003csummary\u003eRequisitos previos\u003c/summary\u003e\n\n    ```console\n    # MacOS\n    brew install ffmpeg\n\n    # Ubuntu\n    sudo apt install ffmpeg\n\n    # ArchLinux\n    sudo pacman -S ffmpeg\n\n    # Fedora\n    sudo dnf install ffmpeg\n    ```\n\n\u003c/details\u003e\n\n## Uso básico\n\nPara comprimir un video o varios videos, usa el comando `pack`, seguido del argumento de entrada requerido (un archivo o un directorio).\n\n```console\npack INPUT [OPTIONS]\n```\n\n\u003e [!NOTE]\n\u003e `INPUT`: Este es el archivo o directorio que deseas procesar. Si proporcionas un directorio, todos los videos dentro de él serán comprimidos.\n\n\u003c!-- --\u003e\n\u003e [!TIP]\n\u003e Para obtener ayuda adicional o ver todas las opciones disponibles, puedes usar el comando:\n\u003e\n\u003e ```console\n\u003e pack --help\n\u003e ```\n\n## Opciones\n\nPack ofrece varias opciones para personalizar el proceso de compresión:\n\n- `--output`, `-o`: Especifica el archivo de salida donde se guardará el video comprimido.\n- `--quality`, `-q`: Define el nivel de calidad del video (0-100). Valor predeterminado: 75.\n- `--overwrite`, `-w`: Sobrescribe el archivo de salida si ya existe.\n- `--codec`, `-c`: Especifica el codec de video a utilizar para la compresión. Valor predeterminado: `h264`. Solo se admiten codecs `h264` y `libx265`.\n- `--delete-original`, `-d`: Elimina el video original después de la compresión exitosa.\n\n\u003e [!IMPORTANT]\n\u003e 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.\n\n## Ejemplos de uso\n\nPara comprimir un video llamado `video.mp4`, simplemente ejecuta:\n\n```console\npack video.mp4\n```\n\nEste comando comprimirá `video.mp4` con los ajustes predeterminados (calidad: 75) y guardará el resultado como `video_compressed.mp4` en el mismo directorio.\n\n\u003cdetails\u003e\n    \u003csummary\u003eVer más ejemplos\u003c/summary\u003e\n\n### Especificar un archivo de salida\n\nSi deseas especificar el nombre o la ubicación del archivo comprimido:\n\n```console\npack video.mp4 --output compressed/small_video.mp4\n```\n\nEste comando comprimirá `video.mp4` y guardará el resultado como `small_video.mp4` en el directorio `compressed`.\n\n### Ajustar la calidad de la compresión\n\nPara comprimir un video con una calidad específica (por ejemplo, 60):\n\n``` console\npack video.mp4 -q 60\n```\n\nEsto comprimirá el video con menor calidad, resultando en un archivo más pequeño.\n\n### Comprimir todos los videos en un directorio\n\nPara comprimir todos los videos en un directorio:\n\n```console\npack /ruta/a/mis/videos\n```\n\nEste comando comprimirá todos los videos en el directorio especificado y guardará los resultados en el mismo directorio.\n\n### Sobrescribir archivos existentes\n\nSi deseas sobrescribir archivos comprimidos existentes:\n\n```console\npack video.mp4 --output output.mp4 --overwrite\n```\n\nEsto sobrescribirá el archivo `output.mp4` si ya existe.\n\n### Eliminar el archivo original después de la compresión\n\nPara eliminar el archivo de video original después de una compresión exitosa:\n\n```console\npack video.mp4 --delete-original\n```\n\nEl archivo original `video.mp4` será eliminado después de la compresión.\n\n### Especificar un codec de video\n\nPara comprimir un video con un codec de video específico (por ejemplo, libx265):\n\n```console\npack video.mp4 --codec libx265\n```\n\nEsto comprimirá el video con el codec libx265, resultando en un archivo más pequeño. Actualmente, solo se admiten los codecs `h264` y `libx265`.\n\n### Usar múltiples opciones\n\nPuedes combinar múltiples opciones en un solo comando:\n\n```console\npack video.mp4 -o compressed.mp4 -q 80 -w -d\n```\n\nEste 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.\n\n\u003c/details\u003e\n\n## Notas adicionales\n\n- 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.\n- Siempre es recomendable hacer una copia de seguridad de tus videos originales antes de usar la opción de eliminación (`-d`).\n\n\u003e [!TIP]\n\u003e Si eres usuario de Windows, puedes instalar `ffmpeg` y `python` manualmente o usando gestores de paquetes como [*`Scoop`*][scoop].\n\u003e Una vez que hayas instalado un gestor de paquetes, solo debes ejecutar algo como `scoop install python ffmpeg`.\n\n\u003c!-- --\u003e\n\u003e [!TIP]\n\u003e Los usuarios de Windows pueden ver un video tutorial en YouTube sobre el proceso de instalación [[Aquí]][demo-windows].\n\n## Contribuidores\n\n\u003ca href=\"https://github.com/ivansaul/CLI-Video-Compressor/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=ivansaul%2FCLI%2DVideo%2DCompressor\"/\u003e\n\u003c/a\u003e\n\n## Mira mis otros proyectos\n\n[![Bookmark Style Card](https://svg.bookmark.style/api?url=https://github.com/ivansaul/codigo_facilito_downloader\u0026mode=light\u0026style=horizontal)](https://github.com/ivansaul/codigo_facilito_downloader)\n[![Bookmark Style Card](https://svg.bookmark.style/api?url=https://github.com/ivansaul/personal-portfolio\u0026mode=light\u0026style=horizontal)](https://github.com/ivansaul/personal-portfolio)\n[![Bookmark Style Card](https://svg.bookmark.style/api?url=https://github.com/ivansaul/flutter_todo_app\u0026mode=light\u0026style=horizontal)](https://github.com/ivansaul/flutter_todo_app)\n\n[python]:https://www.python.org/downloads/\n[ffmpeg]:https://ffmpeg.org\n[demo]:https://github.com/user-attachments/assets/9c9c672a-bfa3-418a-b7d1-89f0e7751146\n[scoop]:https://scoop.sh\n[demo-windows]: https://youtu.be/w1Pba7Bu0ZQ\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivansaul%2Fcli-video-compressor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivansaul%2Fcli-video-compressor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivansaul%2Fcli-video-compressor/lists"}