Skip to main content

A cython implementation of an ffmpeg based player.

Project description

FFPyPlayer is a python binding for the FFmpeg library for playing and writing media files.

For more information: http://matham.github.io/ffpyplayer/index.html

To install: http://matham.github.io/ffpyplayer/installation.html

TravisCI status Appveyor status Supported Python versions Latest Version on PyPI

Warning

Although the ffpyplayer source code is licensed under the LGPL, the ffpyplayer wheels for Windows and linux on PYPI are distributed under the GPL because the included FFmpeg binaries were compiled with GPL options.

If you want to use it under the LGPL you need to compile FFmpeg yourself with the correct options.

Similarly, the wheels bundle openssl for online camera support. However, releases are not made for every openssl release, so it is recommended that you compile ffpyplayer yourself if security is a issue.

Usage example

Playing a file:

>>> from ffpyplayer.player import MediaPlayer
>>> import time

>>> player = MediaPlayer(filename)
>>> val = ''
>>> while val != 'eof':
...     frame, val = player.get_frame()
...     if val != 'eof' and frame is not None:
...         img, t = frame
...         # display img

Writing a video file:

>>> from ffpyplayer.writer import MediaWriter
>>> from ffpyplayer.pic import Image

>>> w, h = 640, 480
>>> # write at 5 fps.
>>> out_opts = {'pix_fmt_in':'rgb24', 'width_in':w, 'height_in':h,
...     'codec':'rawvideo', 'frame_rate':(5, 1)}
>>> writer = MediaWriter('output.avi', [out_opts])

>>> # Construct image
>>> size = w * h * 3
>>> buf = bytearray([int(x * 255 / size) for x in range(size)])
>>> img = Image(plane_buffers=[buf], pix_fmt='rgb24', size=(w, h))

>>> for i in range(20):
...     writer.write_frame(img=img, pts=i / 5., stream=0)

Converting images:

>>> from ffpyplayer.pic import Image, SWScale
>>> w, h = 500, 100
>>> size = w * h * 3
>>> buf = bytearray([int(x * 255 / size) for x in range(size)])

>>> img = Image(plane_buffers=[buf], pix_fmt='rgb24', size=(w, h))
>>> sws = SWScale(w, h, img.get_pixel_format(), ofmt='yuv420p')

>>> img2 = sws.scale(img)
>>> img2.get_pixel_format()
'yuv420p'
>>> planes = img2.to_bytearray()
>>> map(len, planes)
[50000, 12500, 12500, 0]

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ffpyplayer, version 4.0.1
Filename, size File type Python version Upload date Hashes
Filename, size ffpyplayer-4.0.1-cp27-cp27m-manylinux1_i686.whl (17.9 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp27-cp27m-manylinux1_x86_64.whl (18.8 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp27-cp27mu-manylinux1_i686.whl (17.9 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp27-cp27mu-manylinux1_x86_64.whl (18.8 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp27-cp27m-win32.whl (17.7 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp27-cp27m-win_amd64.whl (19.5 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp33-cp33m-manylinux1_i686.whl (18.0 MB) File type Wheel Python version cp33 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp33-cp33m-manylinux1_x86_64.whl (18.8 MB) File type Wheel Python version cp33 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp34-cp34m-manylinux1_i686.whl (18.1 MB) File type Wheel Python version cp34 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp34-cp34m-manylinux1_x86_64.whl (18.9 MB) File type Wheel Python version cp34 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp34-cp34m-win32.whl (17.7 MB) File type Wheel Python version cp34 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp34-cp34m-win_amd64.whl (19.5 MB) File type Wheel Python version cp34 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp35-cp35m-manylinux1_i686.whl (18.0 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp35-cp35m-manylinux1_x86_64.whl (18.9 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp35-cp35m-win32.whl (17.6 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp35-cp35m-win_amd64.whl (19.3 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp36-cp36m-manylinux1_i686.whl (18.1 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp36-cp36m-manylinux1_x86_64.whl (18.9 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp36-cp36m-win32.whl (17.6 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size ffpyplayer-4.0.1-cp36-cp36m-win_amd64.whl (19.3 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size ffpyplayer-4.0.1.tar.gz (711.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page