ffscale

ffscale

A CLI wrapping ffmpeg to upscale/downscale videos.

Goals

• Skip the file if the output already exists.
• Easily downscale videos into 720p.

Installation

ffmpeg

This CLI depends on ffmpeg: https://ffmpeg.org/

Make sure ffmpeg and ffprobe commands are available.

ffscale

npm install -g ffscale

Usage examples

# basic
ffscale --output output.mp4 --height 720 input.mp4

# glob input, non-video files are skipped automatically
ffscale --output output.mp4 --height 720 *

# use percentage
ffscale --output output.mp4 --height 50% input.mp4

# use --short-side instead of --height
ffscale --output output.mp4 --short-side 720 input.mp4

# upscale
ffscale --output output.mp4 --height 1080 --direction up input.mp4

# output to a different directory
ffscale --output "{dir}720/{name}{ext}" --height 720 input.mp4

# shorthand
ffscale -s 720 *

Full documentation: https://github.com/eight04/ffscale/blob/master/index.mjs#L12

Changelog

• 0.3.1 (Jan 28, 2025)

  • Fix: handle error with zip files.
  • Add: --delete option.

• 0.3.0 (May 3, 2024)

  • Change: skip .gif and .jpg files.

• 0.2.0 (May 1, 2024)

  • Change: now you can specify zero length to remove the video track.

• 0.1.2 (Mar 29, 2024)

  • Fix: detect videos by codec_type instead of bit_rate.

• 0.1.1 (Mar 18, 2024)

  • Fix: avoid odd dimensions.
  • Fix: overwrite empty files.
  • Fix: improve performance.

• 0.1.0 (Mar 4, 2024)

  • Initial release.