ffmpegp is an enhanced version of FFmpeg, offering additional features and functionalities to extend its powerful media processing capabilities.
Project description
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.
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
| Specify file format when using --dir
(default: all). |
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ffmpegp-1.0.tar.gz
.
File metadata
- Download URL: ffmpegp-1.0.tar.gz
- Upload date:
- Size: 20.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3da5fbae905909b719af48e84fbf3d291150631713787cd54f28385abae5ac69 |
|
MD5 | ba9656937120438fbf0eaa7b0f885a6a |
|
BLAKE2b-256 | dd6bc70825dc0c415d8b84ae1b42d1f73bad3d485a04257ac7d19d597cee0d0e |
File details
Details for the file ffmpegp-1.0-py3-none-any.whl
.
File metadata
- Download URL: ffmpegp-1.0-py3-none-any.whl
- Upload date:
- Size: 18.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | beb2786bcfb0f16204a57bbd9f3aaa3a665b37c08727d9f980d8e2796325cc52 |
|
MD5 | 7ac70fc6e8357e11a7c1300d8064e17c |
|
BLAKE2b-256 | 845f01def708ba54700339da3819ea324568149e1a07b8cc5a66da0547c83e03 |