Skip to main content
ffmpegp-logo

ffmpegp (short for "FFmpeg Plus") is a Python-based utility designed to simplify working with media files using ffprobe and ffmpeg. This tool lets you easily extract media details, format conversions, and advanced querying via JSON paths, providing a convenient and efficient interface.

Preview




Features

  • Media Metadata Extraction : Get detailed media information via ffprobe.
  • JSONPath Querying : Retrieve specific metadata using JSON path expressions.
  • Gradient Text : Colored gradient output for enhanced readability.
  • Progress Bar : Visual progress bar with customizable colors and time estimation.
  • File Size Conversion : Converts file size to human-readable formats.
  • Time Conversion : Converts media duration to seconds.
  • Enhanced Command Options : Supports various flags for different modes and output styles.

Prerequisites

Ensure ffmpeg and ffprobe are installed and accessible in your system's PATH. If either is missing, the script will display an error.

Installation

Install ffmpegp using pip:

pip install ffmpegp

Usage

Run the program as follows:

ffmpegp -i <file_path> [options]

Arguments

  • file_path: Path to the media file for which you want details.

Options

Option Description
--colored Enable gradient color output.
--log Display logs of the running process.
--stdout Print only plain text without any colored output.
--jq Query specific JSON data (e.g.,format.filename).
--dir Enable multi-file processing mode in a directory.
--format Set specific file format to find. (works with '--dir' tag) (default: all) (e.g., --format=mp4).

Example Commands

Get media details:

ffmpegp "video.mp4"

Get specific JSON data:

ffmpegp "video.mp4" --jq="format.filename"

Enable gradient color progress output:

ffmpegp -i "video.mp4" [options] --colored

Run in directory mode and select only (mp4) extension files and save files to "output" folder with same filename with diffrent file extension (mkv).:

ffmpegp -i "{}" <options> "/output/{}.mkv" --dir="./videos" --format="mp4"

Contributing

Contributions are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue or submit a pull request on GitHub.

License

This project is licensed under the GNU LESSER GENERAL PUBLIC LICENSE - see the LICENSE file for details.

Metadata

Release files for ffmpegp 1.30

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ffmpegp 1.30
File Size Uploaded
ffmpegp-1.30.tar.gz 21.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ffmpegp 1.30
File Interpreter ABI Platform
ffmpegp-1.30-py3-none-any.whl Python 3 none any Details

Total release size: 40.9 kB

Release files / ffmpegp-1.30.tar.gz

Download URL ffmpegp-1.30.tar.gz
Size 21.2 kB
Tags Source
SHA-256 checksum
How to use checksums
172fe4b68844b16210c0075a28baf769247f7ea9883285aeb6d060dec1f65401
BLAKE2b-256 checksum
How to use checksums
c10728a91e6478a9b88da3f1b1bdd65f93d6a261db10ba1b6717858fb0857ec7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release files / ffmpegp-1.30-py3-none-any.whl

Download URL ffmpegp-1.30-py3-none-any.whl
Size 19.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8fbe63fe21ca6331ee82532f9b7c647a827fec9a5fe5291f7eb22fe7c9aa66d4
BLAKE2b-256 checksum
How to use checksums
f259c10f8f83d0974462743857f0ab9f948dc384cb84431dc9d08af5dea76c8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.25

Release history Release notifications | RSS feed

This release

1.30 This release

2 release files

1.25

2 release files

1.22

2 release files

1.21

2 release files

1.14

2 release files

1.12

2 release files

1.1

2 release files

1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page