
Product
A New Overview in our Dashboard
We redesigned Socket's first logged-in page to display rich and insightful visualizations about your repositories protected against supply chain threats.
pymediainfo is a wrapper for the MediaInfo library. It makes it easy to extract detailed information from multimedia files.
pymediainfo is compatible with the following:
Please note that, without the MediaInfo library, pymediainfo cannot parse media files. This severely limits its functionality, allowing it to process only pre-generated XML output from MediaInfo.
Packages are available for most major Linux distributions. They often depend on the MediaInfo library and are the preferred way to install pymediainfo on Linux, as they allow for independent updates to pymediainfo and the MediaInfo library itself.
If pymediainfo is not available for your Linux distribution, or if you're running macOS or Windows, you can install it from PyPI:
python -m pip install pymediainfo
Wheels containing a bundled version of the MediaInfo library are available for:
If you do not want to use the wheels (for instance if you want to use the system-wide MediaInfo library instead of the bundled one):
python -m pip install pymediainfo --no-binary pymediainfo
Here are a few examples demonstrating how to use pymediainfo.
The MediaInfo
class provides a parse()
method which takes paths as input and returns MediaInfo
objects.
from pymediainfo import MediaInfo
media_info = MediaInfo.parse("/home/user/image.jpg")
# Tracks can be accessed using the 'tracks' attribute or through shorthands
# such as 'image_tracks', 'audio_tracks', 'video_tracks', etc.
general_track = media_info.general_tracks[0]
image_track = media_info.image_tracks[0]
print(
f"{image_track.format} of {image_track.width}×{image_track.height} pixels"
f" and {general_track.file_size} bytes."
)
JPEG of 828×828 pixels and 19098 bytes.
In this example, we take advantage of the to_data()
method, which returns a dict
containing all
attributes from a MediaInfo
or Track
object. This makes it
easier to inspect tracks even when their attributes are unknown.
from pprint import pprint
from pymediainfo import MediaInfo
media_info = MediaInfo.parse("my_video_file.mp4")
for track in media_info.tracks:
if track.track_type == "Video":
print(f"Bit rate: {track.bit_rate}, Frame rate: {track.frame_rate}, Format: {track.format}")
print("Duration (raw value):", track.duration)
print("Duration (other values:")
pprint(track.other_duration)
elif track.track_type == "Audio":
print("Track data:")
pprint(track.to_data())
Bit rate: 3117597, Frame rate: 23.976, Format: AVC
Duration (raw value): 958
Duration (other values):
['958 ms',
'958 ms',
'958 ms',
'00:00:00.958',
'00:00:00;23',
'00:00:00.958 (00:00:00;23)']
Track data:
{'bit_rate': 236392,
'bit_rate_mode': 'VBR',
'channel_layout': 'L R',
'channel_positions': 'Front: L R',
'channel_s': 2,
'codec_id': 'mp4a-40-2',
'commercial_name': 'AAC',
'compression_mode': 'Lossy',
…
}
Since the attributes from a Track
are dynamically created during parsing, there isn't a firm definition
of what will be available at runtime.
In order to make consuming objects easier, the __getattribute__
method from Track
objects
has been overridden to return None
when a non-existent attribute is accessed, instead of raising AttributeError
.
from pymediainfo import MediaInfo
media_info = MediaInfo.parse("my_video_file.mp4")
for track in media_info.tracks:
if track.bit_rate is None:
print(f"{track.track_type} tracks do not have a bit rate associated with them")
else:
print(f"Track {track.track_id} of type {track.track_type} has a bit rate of {track.bit_rate} b/s")
General tracks do not have a bit rate associated with them
Track 1 of type Video has a bit rate of 4398075 b/s
Track 2 of type Audio has a bit rate of 131413 b/s
Menu tracks do not have a bit rate associated with them
pymediainfo relies on MediaInfo's OLDXML
output to create MediaInfo
objects.
It is possible to create a MediaInfo
object from an existing XML string. For
instance if someone sent you the output of mediainfo --output=OLDXML
, you can
call the MediaInfo
constructor directly.
from pymediainfo import MediaInfo
raw_xml_string = """<?xml version="1.0" encoding="UTF-8"?>
<Mediainfo version="24.11">
<File>
<track type="General">
<Complete_name>binary_file</Complete_name>
<File_size>1.00 Byte</File_size>
</track>
</File>
</Mediainfo>"""
media_info = MediaInfo(raw_xml_string)
print(f"File name is: {media_info.general_tracks[0].complete_name}")
File name is: binary_file
mediainfo
)If you want a text report, similar to what mediainfo my_video_file.mp4
outputs,
use the output="text"
argument with the parse()
method. In this case, it
will return a string, not a MediaInfo
object.
from pymediainfo import MediaInfo
# To mirror a simple call to "mediainfo" without the "--Full" or "-f" option, we
# set "full=False". Leaving it at the default of "full=True" would result in
# more verbose output.
print(MediaInfo.parse("my_video_file.mp4", output="text", full=False))
General
Complete name : my_video_file.mp4
Format : MPEG-4
Format profile : Base Media
[…]
For more detailed information, please refer to the reference documentation available at https://pymediainfo.readthedocs.io/.
For feature requests and bug reports, please use the GitHub issue tracker at https://github.com/sbraz/pymediainfo/issues.
If you have any questions, feel free to ask in the discussions at https://github.com/sbraz/pymediainfo/discussions.
FAQs
A Python wrapper for the MediaInfo library.
We found that pymediainfo demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
We redesigned Socket's first logged-in page to display rich and insightful visualizations about your repositories protected against supply chain threats.
Product
Automatically fix and test dependency updates with socket fix—a new CLI tool that turns CVE alerts into safe, automated upgrades.
Security News
CISA denies CVE funding issues amid backlash over a new CVE foundation formed by board members, raising concerns about transparency and program governance.