Skip to content

Repository files navigation

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

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

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

TravisCI statusAppveyor statusSupported Python versionsLatest 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:

>>>fromffpyplayer.playerimportMediaPlayer>>>importtime>>>player=MediaPlayer(filename)
>>>val=''>>>whileval!='eof':
... frame, val=player.get_frame()
... ifval!='eof'andframeisnotNone:
... img, t=frame
... # display img

Writing a video file:

>>>fromffpyplayer.writerimportMediaWriter>>>fromffpyplayer.picimportImage>>>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) forxinrange(size)])
>>>img=Image(plane_buffers=[buf], pix_fmt='rgb24', size=(w, h))
>>>foriinrange(20):
... writer.write_frame(img=img, pts=i/5., stream=0)

Converting images:

>>>fromffpyplayer.picimportImage, SWScale>>>w, h=500, 100>>>size=w*h*3>>>buf=bytearray([int(x*255/size) forxinrange(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()
>>> [len(plane) forplaneinplanes]
[50000, 12500, 12500, 0]

About

A cython implementation of an ffmpeg based player.

Topics

Resources

Stars

146 stars

Watchers

15 watching

Forks

Releases

Packages

Used by

Contributors

Languages