videolab 0.5.20

A CLI for video processing.

videolab

A CLI for video processing.

Installation

You can install videolab from source.

1. Clone the repository:

   git clone https://github.com/kianmeng/videolab.git
   cd videolab
   

2. Create a virtual environment and install the package:

   uv venv
   source .venv/bin/activate
   uv pip install -e .
   

Usage

Once installed, you can use the videolab command.

To see the help message:

videolab --help

usage: videolab [-h] [-V] [-v] {env,scrub,watermark} ...

A console program to manipulate videos.

website: https://github.com/kianmeng/videolab
changelog: https://github.com/kianmeng/videolab/blob/master/CHANGELOG.md
issues: https://github.com/kianmeng/videolab/issues

positional arguments:
  {env,scrub,watermark}
                        sub-command help
    env                 show environment information
    scrub               remove all metadata
    watermark           add a watermark to a video.

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -v, --verbose         enable verbose logging

videolab env

videolab env -h

usage: videolab env [-h]

options:
  -h, --help  show this help message and exit

videolab scrub

videolab scrub -h

usage: videolab scrub [-h] [--no-audio] input_file [output_file]

Removes all container-level and stream-level metadata from a video file by
remuxing it

positional arguments:
  input_file   Path to the input video file
  output_file  Path to save the scrubbed video file, defaults:
               '<input_file>_scrubbed.<ext>'

options:
  -h, --help   show this help message and exit
  --no-audio   Remove the audio from the video file

videolab watermark

videolab watermark -h

usage: videolab watermark [-h] --text TEXT [--font-size FONT_SIZE]
                          [--font-color FONT_COLOR]
                          [--position {top-left,top-right,bottom-left,bottom-right,center}]
                          [--margin MARGIN]
                          input_file [output_file]

Adds a watermark to a video file.

positional arguments:
  input_file            Path to the input video file
  output_file           Path to save the watermarked video file, defaults:
                        '<input_file>_watermarked.<ext>'

options:
  -h, --help            show this help message and exit
  --text TEXT           The text for the watermark
  --font-size FONT_SIZE
                        Font size for the watermark text. Defaults to 5% of
                        video height.
  --font-color FONT_COLOR
                        Font color in RGBA format (e.g., '255,255,255,128').
  --position {top-left,top-right,bottom-left,bottom-right,center}
                        Position of the watermark.
  --margin MARGIN       Margin from the edges of the video in pixels.

Contributing

Contributions are welcome! Please see the Contributing file for details on how to set up your development environment and submit pull requests.

License

This project is licensed under the GNU Affero General Public License v3.0 or later. See the License file for details.