Skip to main content

Video editing with Python

Project description

MoviePy (full documentation here) is a Python module for video editing: cuts, concatenations, title insertions, video compositing (a.k.a. non-linear editing), video processing, and creation of custom effects. See the gallery for some examples of use.

A typical MoviePy script looks like this:

from moviepy.editor import *

# Load myHolidays.mp4 and select the subclip 00:00:50 - 00:00:60
clip = VideoFileClip("myHolidays.mp4").subclip(50,60)

# Generate a 10-second centered text clip (many options available ! )
txt_clip = ( TextClip("My Holidays 2013",fontsize=70,color='white')
             .set_position('center')
             .set_duration(10) )

# Overlay the text clip above the first clip
final_clip = CompositeVideoClip([clip, txt_clip])

# write the result to a file in any format
final_clip.to_videofile("myHolidays_edited.webm",fps=25)

MoviePy can read and write all the most common audio and video formats, including GIF, and runs on Windows/Mac/Linux, with Python 2.7+ and 3.

Contribute !

MoviePy is an open-source software originally written by Zulko and released under the MIT licence. The project is hosted on Github , where everyone is welcome to contribute, ask for help or simply give feedback.

You can also discuss about the project on Reddit or on the mailing list moviepy@librelist.com .

Installation

Method with pip: if you have pip installed, just type this in a terminal (it will install ez_setup if you don’t already have it)

(sudo) pip install ez_setup moviepy

Method by hand: download the sources, either on PyPI or (if you want the development version) on Github, unzip everything in one folder, open a terminal and type

(sudo) python setup.py install

MoviePy depends on the Python modules Numpy, Decorator, and tqdm, which will be automatically installed during MoviePy’s installation. It should work on Windows/Mac/Linux, with Python 2.7+ and 3 ; if you have trouble installing MoviePy or one of its dependencies, please provide feedback !

Linking to ffmpeg

MoviePy requires a recent version of the software ffmpeg preferably downloaded directly from the ffmpeg website.

Installed ffmpeg: when you have installed ffmpeg, or (for linux users) when you have a ffmpeg binary in the /usr/bin folder, it will be detected automatically by MoviePy.

Non-installed ffmpeg: you can also simply place the ffmpeg binary somewhere on your computer and specify its path in the file moviepy/config_defaults.py before installing MoviePy by hand.

Linking to ImageMagick

ImageMagick is not strictly required, but some important features of MoviePy, like the creation of texts or animated GIFs, depend on it.

Once you have installed it, ImageMagick will be automatically detected by MoviePy, except on Windows !. Windows user, before installing MoviePy by hand, go into the moviepy/config_defaults.py file and provide the path to the ImageMagick binary called convert. It should look like this

IMAGEMAGICK_BINARY = "C:\\Program Files\\ImageMagick_VERSION\\convert.exe"

Other optional but useful dependencies

PyGame is needed for video and sound previews (useless if you intend to work with MoviePy on a server but really essential for advanced video editing by hand).

For advanced image processing you will need one or several of these packages. For instance using the method clip.resize requires that at least one of Scipy, PIL, Pillow or OpenCV are installed.

  • The Python Imaging Library (PIL) or, better, its branch Pillow .

  • Scipy (for tracking, segmenting, etc.), and can be used for resizing video clips if PIL and OpenCV aren’t installed on your computer.

  • Scikit Image may be needed for some advanced image manipulation.

  • OpenCV 2.4.6 (provides the package cv2) or more recent may be needed for some advanced image manipulation.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

moviepy-0.2.1.9.03.tar.gz (100.7 kB view details)

Uploaded Source

File details

Details for the file moviepy-0.2.1.9.03.tar.gz.

File metadata

File hashes

Hashes for moviepy-0.2.1.9.03.tar.gz
Algorithm Hash digest
SHA256 0280d0de841ec121105b4c1aff7f2435de9d520fe68c7833a37d6cdf531d2974
MD5 09773b2e831c99edbc4fe305b48c512c
BLAKE2b-256 266284431efcc877b5b00aca6dba1c3ab62bd524bd6f663828a504916a8ba21b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page