Skip to content

ffmpeg-media-type is a Python library that utilizes FFmpeg to detect various media file information, such as duration, width, and height. This library provides an easy-to-use interface for extracting essential details from media files by leveraging the powerful capabilities of FFmpeg.

License

Notifications You must be signed in to change notification settings

livingbio/ffmpeg-media-type

Repository files navigation

ffmpeg-media-type

ffmpeg-media-type is a Python library that utilizes FFmpeg to detect various media file information, such as duration, width, and height. This library provides an easy-to-use interface for extracting essential details from media files by leveraging the powerful capabilities of FFmpeg.

CI codecov pypi downloads versions license Checked with mypy Code style: black Imports: isort

Table of Contents

Installation

You can install ffmpeg-media-type via pip:

pip install ffmpeg-media-type

Note: FFmpeg must be installed on your system for this library to function correctly. Make sure you have FFmpeg installed and added to your system's PATH.

Usage

To use ffmpeg-media-type, first import the library:

import ffmpeg_media_type

Detecting Media File Information

To detect media file information, use the detect function, providing the path to the media file as a parameter:

media_info = ffmpeg_media_type.detect('https://raw.githubusercontent.com/livingbio/ffmpeg-media-type/main/docs/media/overlay.png')
media_info
MediaInfo(type='image', width=163, height=117, duration=None, format='png_pipe', size=2212, suggest_ext='png')

The detect function returns a model containing the following information:

  • type: The type of media file (e.g. video, audio, image, etc.).
  • duration: The duration of the media file in seconds.
  • width: The width of the media file in pixels.
  • height: The height of the media file in pixels.
  • format: The format of the media file (e.g. mp4, mp3, png, etc.).
  • size: The size of the media file in bytes.
  • suggest_ext: The suggested file extension for the media file (e.g. mp4, mp3, png, etc.).

Here's an example of how to access these details:

duration = media_info.duration
width = media_info.width
height = media_info.height

Example

import ffmpeg_media_type

# Specify the path to the media file
file_path = 'https://raw.githubusercontent.com/livingbio/ffmpeg-media-type/main/docs/media/SampleVideo_1280x720_1mb.mp4'

# Detect media file information
media_info = ffmpeg_media_type.detect(file_path)

# Extract information from the media_info dictionary
duration = media_info.duration
width = media_info.width
height = media_info.height

# Print the extracted information
print(f"Duration: {duration} seconds")
print(f"Width: {width} pixels")
print(f"Height: {height} pixels")
Duration: 5.312 seconds
Width: 1280 pixels
Height: 720 pixels

Enhancing Accuracy in Guessing Media File Extensions with FFmpeg

  • Typically, the media file's extension is utilized to determine its file type. Nevertheless, this approach may not always yield accurate results. For instance, a file bearing the .mp4 extension could, in reality, be an audio file.
  • The ffmpeg-media-type tool enhances the precision of media file extension guessing by leveraging the built-in format functionality of FFmpeg through the command ffmpeg -formats.

check cache for details.

Access ffprobe output

If you need to access the raw ffprobe output, you can use the ffprobe function:

ffprobe_output = ffmpeg_media_type.ffprobe('https://raw.githubusercontent.com/livingbio/ffmpeg-media-type/main/docs/media/SampleVideo_1280x720_1mb.mp4')

ffprobe_output
FFProbeInfo(format=FFProbeFormat(filename='https://raw.githubusercontent.com/livingbio/ffmpeg-media-type/main/docs/media/SampleVideo_1280x720_1mb.mp4', duration='5.312000', format_name='mov,mp4,m4a,3gp,3g2,mj2', format_long_name='QuickTime / MOV', start_time='0.000000', size='1055736', probe_score=100), streams=(FFProbeStream(index=0, width=1280, height=720, codec_type='video', codec_name='h264', codec_long_name='H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10', profile='Main', pix_fmt='yuv420p', r_frame_rate='25/1', tags=FFProbeStreamTags(rotate=0)), FFProbeStream(index=1, width=None, height=None, codec_type='audio', codec_name='aac', codec_long_name='AAC (Advanced Audio Coding)', profile='LC', pix_fmt=None, r_frame_rate='0/0', tags=FFProbeStreamTags(rotate=0))))

Contributing

Contributions are welcome! If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub repository. If you would like to contribute code, please fork the repository and submit a pull request.

Before submitting a pull request, make sure to run the tests using the following command:

poetry install --with dev
py.test src

Please ensure that your code follows the established coding style and passes all tests.

License

This project is licensed under the MIT License. See the LICENSE file for more information.

About

ffmpeg-media-type is a Python library that utilizes FFmpeg to detect various media file information, such as duration, width, and height. This library provides an easy-to-use interface for extracting essential details from media files by leveraging the powerful capabilities of FFmpeg.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published