Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CrypticSignal/bitrate-plotter
Plots a graph showing the bitrate every second or the bitrate of every GOP, for an audio or video file.
https://github.com/CrypticSignal/bitrate-plotter
audio bitrate ffprobe gop graph matplotlib plot plotter python vbr video
Last synced: 2 months ago
JSON representation
Plots a graph showing the bitrate every second or the bitrate of every GOP, for an audio or video file.
- Host: GitHub
- URL: https://github.com/CrypticSignal/bitrate-plotter
- Owner: CrypticSignal
- Created: 2021-02-13T18:56:21.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-12T15:44:48.000Z (over 1 year ago)
- Last Synced: 2024-05-18T22:33:19.910Z (8 months ago)
- Topics: audio, bitrate, ffprobe, gop, graph, matplotlib, plot, plotter, python, vbr, video
- Language: Python
- Homepage:
- Size: 279 KB
- Stars: 23
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-video - bitrate-plotter - Plots a graph showing the bitrate every second or the bitrate of every GOP. (Analysis tools)
README
# Bitrate Plotter
A command line program that outputs one of the following:
**[1]** A graph showing the bitrate every second. The graph can be "filled" or "unfilled".
Unfilled graph example:
![Unfilled graph example]()
Filled graph example:
![Filled graph example]()
**[2]** Information about every Group of Pictures (GOP). You must use the `-gop` argument if this is what you are looking for. Only applicable if analysing a video file. Here's an example of the output:
```
Detected the following info about BigBuckBunny.mp4:
----------------------------------------------------
Duration: 596.474195s
Number of Frames: 14315
Framerate: 24.0 FPS
----------------------------------------------------
GOP Statistics:
GOP count: 266
Average number of packets per GOP: 53.8
GOP duration range: 0.500s to 2.500s
Average GOP duration: 2.242s
GOP size range: 0.54 to 9.09 Megabits
GOP bitrate range: 0.51 to 4.07 Mbps
Average GOP bitrate: 2.00 Mbps
✓ Average PTS interval matches expected frame rate
✓ PTS intervals are consistent
[Info] GOP durations are inconsistent:
Min GOP Duration: 0.5000006666665892
Max GOP Duration: 2.5000006666667027
```
# Requirements
- Python 3.7+
- FFprobe executable in your PATH.
- `pip install -r requirements.txt`
# Usage
You can find the output of `python main.py -h` below:
```
usage: main.py [-h] -f FILE_PATH [-dts] [-gop] [-g {filled,unfilled}] [-s STREAM_SPECIFIER]
options:
-h, --help show this help message and exit
-f, --file-path FILE_PATH
Enter the path of the file that you want to analyse.
If the path contains a space, it must be surrounded in double quotes.
Example: -f "C:/Users/H/Desktop/my file.mp4"
-dts Use DTS instead of PTS when calculating bitrates.
Only applicable if analysing a video file.
-gop Output information about every Group Of Pictures (GOP).
Only applicable if analysing a video file.
-g, --graph-type {filled,unfilled}
Specify the type of graph that should be created. The default graph type is "unfilled".
To see the difference between a filled and unfilled graph, check out the example graph files.
-s, --stream-specifier STREAM_SPECIFIER
Use FFmpeg stream specifier syntax to specify the audio/video stream that you want to analyse.
The defaults for audio and video files are a:0 and V:0, respectively.
Note that stream index starts at 0.
As an example, to target the 2nd audio stream: --stream-specifier a:1
```