MoviePy

MoviePy (full

documentation

) is a Python

library for video editing: cutting, 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.

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 (or only

Python 3.4+ from v.1.0). Here it is in action in an IPython notebook:

Example

In this example we open a video file, select the subclip between t=50s and

t=60s, add a title at the center of the screen, and write the result to a new

file:

from moviepy.editor import *

video = VideoFileClip("myHolidays.mp4").subclip(50,60)

# Make the text. Many more options are available.

txt_clip = ( TextClip("My Holidays 2013",fontsize=70,color='white')

.set_position('center')

.set_duration(10) )

result = CompositeVideoClip([video, txt_clip]) # Overlay text on video

result.write_videofile("myHolidays_edited.webm",fps=25) # Many options...

Installation

MoviePy depends on the Python modules

Numpy

,

imageio

,

Decorator

, and

tqdm

, which will be automatically

installed during MoviePy's installation. The software FFMPEG should be

automatically downloaded/installed (by imageio) during your first use of

MoviePy (installation will take a few seconds). If you want to use a specific

version of FFMPEG, follow the instructions in

config_defaults.py

. In case of

trouble, provide feedback.

Installation by hand:

download the sources, either from

PyPI

or, if you want the development

version, from

GitHub

, unzip everything

into one folder, open a terminal and type:

$ (sudo) python setup.py install

Installation with pip:

if you have

pip

installed, just type this in a

terminal:

$ (sudo) pip install moviepy

If you have neither

setuptools

nor

ez_setup

installed, the command above

will fail. In this case type this before installing:

$ (sudo) pip install ez_setup

Optional but useful dependencies

You can install

moviepy

with all dependencies via:

$ (sudo) pip install moviepy[optional]

ImageMagick

is not strictly

required, but needed if you want to incorporate texts. It can also be used as

a backend for GIFs, though you can also create GIFs with MoviePy without

ImageMagick.

Once you have installed ImageMagick, it will be automatically detected by

MoviePy,

except on Windows!

Windows users, before installing MoviePy by

hand, need to edit

moviepy/config_defaults.py

to provide the path to the

ImageMagick binary, which is called convert. It should look like this:

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

PyGame

is needed for video and sound

previews (not relevant if you intend to work with MoviePy on a server but

essential for advanced video editing by hand).

For advanced image processing, you will need one or several of the following

packages:

The Python Imaging Library (PIL) or, even better, its branch

Pillow

.

Scipy

(for tracking, segmenting, etc.) can be used to resize video clips if PIL and OpenCV are not installed.

Scikit Image

may be needed for some advanced image manipulation.

OpenCV 2.4.6

or a more recent version (one that provides the package

cv2

) may be needed for some advanced image manipulation.

Once you have installed it, ImageMagick will be automatically detected by

MoviePy, (except for windows users and Ubuntu 16.04LTS users).

For Windows users, before installing MoviePy by hand, go into the

moviepy/config_defaults.py

file and provide the path to the ImageMagick

binary called

magick

. It should look like this:

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

If you are using an older version of ImageMagick, keep in mind the name of the

executable is not

magick.exe

but

convert.exe

. In that case, the

IMAGEMAGICK_BINARY property should be

C:\\Program

Files\\ImageMagick_VERSION\\convert.exe

For Ubuntu 16.04LTS users, after installing MoviePy on the terminal,

IMAGEMAGICK will not be detected by moviepy. This bug can be fixed. Modify the

file in this directory: /etc/ImageMagick-6/policy.xml, comment out the

statement

.

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 instance, using the method

clip.resize

requires that at least one of

Scipy, PIL, Pillow or OpenCV is installed.

Documentation

Running build_docs has additional dependencies that require installation.

$ (sudo) pip install moviepy[docs]

The documentation can be generated and viewed via:

$ python setup.py build_docs

You can pass additional arguments to the documentation build, such as clean

build:

$ python setup.py build_docs -E

More information is available from the

Sphinx

documentation.

New in 1.0.0: Progress bars and messages with Proglog

Non-backwards-compatible changes were introduced in 0.2.3.6 to manage progress

bars and messages using

Proglog

, which enables to display nice progress bars in the console

as well as in a Jupyter notebook or any user interface, like a website.

To display notebook friendly progress bars, first install IPyWidgets:

sudo pip install ipywidgets

sudo jupyter nbextension enable --py --sys-prefix widgetsnbextension

Then at the beginning of your notebook enter:

import proglog

proglog.notebook()

Have a look at the Proglog project page for more options.

Running Tests

The testing suite can be executed via:

$ python setup.py test

Running the test suite in this manner will install the testing dependencies.

If you opt to run the test suite manually, you can install the dependencies

via:

$ (sudo) pip install moviepy[test]

Contribute

MoviePy is 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.

Please read our

Contributing

Guidelines

for

more information about how to contribute!

You can also discuss the project on

Reddit

or

Gitter

. These are preferred over GitHub

issues for usage questions and examples.

We have a list of labels used in our

Label

Wiki

. The 'Pull Requests'

labels are well defined, and all PRs should fall under exactly one of these.

The 'Issues' labels are less precise, and may not be a complete list.

Maintainers

Zulko

(owner)

?tburrows13?

(https://github.com/tburrows13)

?earney?

(https://github.com/earney)

Kay

?kerstin?

(https://github.com/kerstin)

?mbeacom?

(https://github.com/mbeacom)

软件简介

MoviePy 是一个用于视频编辑的Python库：剪切，连接，标题插入，视频合成(也称为非线性编辑)，视频处理和创建自定义效果。

MoviePy 可以读写所有最常见的音频和视频格式，包括 GIF，并可以在Windows / Mac / Linux上运行，使用Python

2.7+和3.在IPython笔记本中。

例如：我们打开一个视频文件，在t = 50s和t = 60s之间选择子剪辑，在屏幕中心添加一个标题，并将结果写入一个新文件：

from moviepy.editor import *

video = VideoFileClip("myHolidays.mp4").subclip(50,60)

# Make the text. Many more options are available.

txt_clip = ( TextClip("My Holidays 2013",fontsize=70,color='white')

.set_position('center')

.set_duration(10) )

result = CompositeVideoClip([video, txt_clip]) # Overlay text on video

result.write_videofile("myHolidays_edited.webm",fps=25) # Many options...