ffpb-rs
[](https://github.com/clitic/ffpb-rs/releases)
[](https://crates.io/ffpb)
[](https://crates.io/crates/ffpb)
[](https://github.com/clitic/ffpb-rs/actions)
[](https://docs.rs/ffpb)
[](https://crates.io/crates/ffpb)
[](https://github.com/clitic/ffpb-rs)
`ffpb` is a modern, cli progress bar for ffmpeg. It was originally inspired from [althonos/ffpb](https://github.com/althonos/ffpb). It seamlessly wraps your `ffmpeg` commands, parses the `-progress` output, and replaces ffmpeg's standard console spam with a clean, dynamic, and beautiful progress bar featuring an adaptive ETA and real-time encoding statistics.
## Features
- **Drop-in Replacement**: Simply replace `ffmpeg` with `ffpb` in your existing `ffmpeg` commands. No complex configurations needed.
- **Beautiful UI**: Modern, true-color gradient progress bar that adapts to your terminal size.
- **Real-Time Stats**: Displays frames, fps, q-value, size, elapsed time, ETA, bitrate, and speed.
- **Smart Duration Parsing**: Automatically parses `-t`, `-to`, and `-ss` flags to accurately compute the effective encoding duration.
## Installation
### Dependencies
- [ffmpeg](https://www.ffmpeg.org/download.html) is a free, open-source command-line software framework used for handling multimedia files.
### Pre-built Binaries
Visit the [releases page](https://github.com/clitic/ffpb-rs/releases) for pre-built binaries. Extract the binary and add its path to your system's `PATH`.
### Install via Cargo
You can also install ffpb using cargo.
```bash
cargo install ffpb
```
## Usage
```
ffmpeg with a progress bar.
Usage: ffpb [ffmpeg arguments...]
Options:
--clean Only show progress bar, suppress ffmpeg output
-h, --help Show this help
-V, --version Show ffpb version
Examples:
ffpb -i input.mp4 -c:v libx264 output.mp4
ffpb -ss 10 -to 20 -i input.mp4 output.mp4
ffpb -y -i input.mp4 -c:a aac output.m4a
All other arguments are forwarded directly to ffmpeg.
```
## Library
Add this to your Cargo.toml file.
```toml
[dependencies]
ffpb = "0.2.1"
```
Or add from command line.
```bash
cargo add ffpb
```
See [docs](https://docs.rs/ffpb) and [examples](https://github.com/clitic/ffpb-rs/blob/main/examples) to
know how to use it.
## Donate
This project is developed and maintained in my free time. Donations help cover development time, testing, and future improvements. If this tool saved you time or helped your workflow, consider supporting it.
## License
Dual Licensed
- [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0) ([LICENSE-APACHE](LICENSE-APACHE))
- [MIT license](https://opensource.org/licenses/MIT) ([LICENSE-MIT](LICENSE-MIT))
