Skip to content

sidneys/ffmpeg-progressbar-cli

Repository files navigation

ffmpeg-progressbar-cli npm


ffmpeg-progressbar-cli is a colored progress bar for FFmpeg.
Simply use ffmpeg-bar instead of ffmpeg.

Contents

  1. Installation
  2. Usage
  3. Configuration
  4. Requirements
  5. Compatibility
  6. Contribute
  7. Author

Installation

$ npm install --global ffmpeg-progressbar-cli

Usage

The installation process adds the ffmpeg-bar command to your system.
This is a transparent wrapper, passing all commands to ffmpeg.

To use it, simply launch ffmpeg-bar instead of ffmpeg, or replace ffmpeg with ffmpeg-bar inside your scripts.

As long as no errors are encountered, the output of ffmpeg-bar will consist of a progress bar, the estimated time until process completion and a percentage.

Examples
$> ffmpeg-bar -i input.mp4 output.avi
$> ffmpeg-bar -i input.avi -b:v 64k -bufsize 64k output.avi
$> ffmpeg-bar -i in.mkv -map_metadata:s:a 0:g out.mkv

Configuration

For configuration purposes, ffmpeg-progressbar-cli exposes these environmental variables:

BAR_FILENAME_LENGTH

The maximum number of characters of the filename label displayed next to the progress bar beam (default: 20)

Example
$> BAR_FILENAME_LENGTH=7 ffmpeg-bar -i in.mp4 output.mp4
BAR_BEAM_RATIO

The share of (available) horizontal display real estate the progress bar beam should occupy (default: 0.75)

Example
$> BAR_BAR_SIZE_RATIO=0.5 ffmpeg-bar -i in.mp4 output.mp4

Requirements

Compatibility

Tested on

  • macOS 10.13, 10.14 Beta
  • Windows 10 1803
  • Ubuntu 18.04

Contribute Contributors Wanted

Read the contribution documentation.

License

MIT

Author

sidneys 2018