Saturday, October 24, 2020

Vdx – An intuitive CLI for processing video, powered by FFmpeg

vdx

An intuitive CLI for processing video, powered by FFmpeg

Crop, trim, resize, reverse, rotate, strip audio, change the speed, change the frame rate, change the volume, convert to a different file format
Run multiple operations on multiple files concurrently

Quick start

$ npm install --global vdx

A variety of common video processing operations are supported:

$ vdx '*.mov' --crop 360,640    # Crop to width 360, height 640
$ vdx '*.mov' --format gif      # Convert to GIF
$ vdx '*.mov' --fps 12          # Set the frame rate to 12
$ vdx '*.mov' --no-audio        # Strip audio
$ vdx '*.mov' --resize 360,-1   # Resize to width 360, maintaining aspect ratio
$ vdx '*.mov' --reverse         # Reverse
$ vdx '*.mov' --rotate 90       # Rotate 90 degrees clockwise
$ vdx '*.mov' --speed 2         # Double the speed
$ vdx '*.mov' --trim 0:05,0:10  # Trim from time 0:05 to 0:10
$ vdx '*.mov' --volume 0.5      # Halve the volume

We can also run multiple operations all at once:

$ vdx '*.mov' --format gif --fps 12 --resize 360,640 --speed 2 --trim 0:05,0:10

By default, the processed files will be written to a directory called ./build. To change this, use the --output flag:

$ vdx '*.mov' --format gif --output './gifs'

By default, up to 3 input files will be processed concurrently. To change this, use the --parallel flag:

$ vdx '*.mov' --format gif --output './gifs' --parallel 5

Usage

Usage: vdx <pattern> [options]

<pattern>

Globs of input files to process.

[options]

Use the -d or --debug flag to print the underlying FFMpeg command that is being run.

-c, --crop [<x>,<y>,]<width>,<height>

# Crop to width 360, height 640
$ vdx '*.mov' --crop 360,640

# Crop to width 360, height 640, starting from coordinates (10, 20)
$ vdx '*.mov' --crop 10,20,360,640

-f, --format <format>

# Convert to GIF
$ vdx '*.mov' --format gif

-fp, --fps <fps>

# Set the frame rate to 12
$ vdx '*.mov' --fps 12

-na, --no-audio

# Strip audio
$ vdx '*.mov' --no-audio

-o, --output <directory>

<directory> defaults to './build'

# Write files to './gifs'
$ vdx '*.mov' --format gif --output './gifs'

-p, --parallel <concurrency>

<concurrency> defaults to 3

# Process up to 5 files concurrently
$ vdx '*.mov' --format gif --parallel 5

-r, --resize <width>,<height>

# Resize to width 360, height 640
$ vdx '*.mov' --resize 360,640

# Resize to width 360, maintaining the aspect ratio
$ vdx '*.mov' --resize 360,-1

# Resize to height 640, maintaining the aspect ratio
$ vdx '*.mov' --resize -1,640

-rv, --reverse

# Reverse
$ vdx '*.mov' --reverse

-ro, --rotate

# Rotate 90 degrees clockwise
$ vdx '*.mov' --rotate 90

# Rotate 90 degrees counter-clockwise
$ vdx '*.mov' --rotate -90

# Rotate 180 degrees
$ vdx '*.mov' --rotate 180

-s, --speed <speed>

# Halve the speed
$ vdx '*.mov' --speed 0.5

# Double the speed
$ vdx '*.mov' --speed 2

-t, --trim <start>[,<end>]

# Trim from time 0:05 to the end of the input file
$ vdx '*.mov' --trim 0:05

# Trim from time 0:05 to 0:10
$ vdx '*.mov' --trim 0:05,0:10

-vo, --volume <volume>

# Halve the volume
$ vdx '*.mov' --volume 0.5

# Double the volume
$ vdx '*.mov' --volume 2

Installation

$ npm install --global vdx

SymmetricalDataSecurity