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)
| File | Size | Uploaded | |
|---|---|---|---|
| ffmpegp-1.30.tar.gz | 21.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|