stef405 b5bb086439 Added code to raise exception with string - now reformatted for approval (#1952) 1 day ago
.github 86fd511fdb Fix CI. (#1943) 1 month ago
docs 57c279a30f Implement basic data model (#1076) 1 day ago
examples 46dca4adec change 'set_pos' to 'with_position' (#1836) 7 months ago
media a472c864d2 Take into account rotation metadata to define video size (#577) 2 years ago
moviepy b5bb086439 Added code to raise exception with string - now reformatted for approval (#1952) 1 day ago
scripts 6c272d88da Fix Windows CI (#1841) 7 months ago
tests b5bb086439 Added code to raise exception with string - now reformatted for approval (#1952) 1 day ago
.gitignore 282848aae9 Windows-based testing (#931) 4 years ago
.pre-commit-config.yaml 551e265f8b Upgrade tooling (#1770) 1 year ago
.readthedocs.yml fd71ed12f1 Add support for ReadTheDocs (#1328) 2 years ago 858bb81fba Raise `ValueError` if invalid arguments passed to `TextClip` (#1842) 7 months ago 8cc3eebb09 Setup 'isort' and 'pre-commit' (#1479) 2 years ago
Dockerfile c8d02deea7 Updated dockerfile to modify policy.xml in-place (#1304) 2 years ago
LICENCE.txt b074da58e7 Fix LICENCE.txt so that GitHub can auto-detect it 2 years ago 023c8b3e0e Remove '' (#1433) 2 years ago
README.rst 77d7165da4 Fix GitHub workflow badge (#1914) 3 months ago
appveyor.yml 552e94b710 Add fake appveyor workflow file (#1691) 1 year ago
setup.cfg 8908226264 Rewrite helpers as fixtures in tests (#1612) 2 years ago 86fd511fdb Fix CI. (#1943) 1 month ago



.. image::
:target: PyPI_
:alt: MoviePy page on the Python Package Index
.. image::
:target: Gitter_
:alt: Discuss MoviePy on Gitter
.. image::
:alt: Build status on gh-actions
.. image::
:alt: Code coverage from

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 3.6+. Here it is in action in an IPython notebook:

.. image::
:alt: [logo]
:align: center


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:

.. code:: python

from moviepy 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')
.with_duration(10) )

result = CompositeVideoClip([video, txt_clip]) # Overlay text on video
result.write_videofile("myHolidays_edited.webm",fps=25) # Many options...

*Note:* This example uses the new 2.x API, for MoviePy 1.0.3, currently on PyPI, see `this snippet `_.

Maintainers wanted!

As there are more and more people seeking support (270 open issues as of Jan. 2021!) and all the MoviePy maintainers seem busy, we'd love to hear about developers interested in giving a hand and solving some of the issues (especially the ones that affect you) or reviewing pull requests. Open an issue or contact us directly if you are interested. Thanks!


MoviePy depends on the Python modules NumPy_, Imageio_, Decorator_, and Proglog_, 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 ````. 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:

.. code:: bash

$ (sudo) python install

**Installation with pip:** if you have ``pip`` installed, just type this in a terminal:

.. code:: bash

$ (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:

.. code:: bash

$ (sudo) pip install setuptools

Optional but useful dependencies

You can install ``moviepy`` with all dependencies via:

.. code:: bash

$ (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, MoviePy will try to autodetect the path to its executable. If it fails, you can still configure it by setting environment variables (see the documentation).

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.
- `Matplotlib`_

For instance, using the method ``clip.resize`` requires that at least one of Scipy, PIL, Pillow or OpenCV is installed.


Building the documentation has additional dependencies that require installation.

.. code:: bash

$ (sudo) pip install moviepy[doc]

The documentation can be generated and viewed via:

.. code:: bash

$ python build_docs

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

.. code:: bash

$ python 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 1.0.0 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:

.. code::

sudo pip install ipywidgets
sudo jupyter nbextension enable --py --sys-prefix widgetsnbextension

Then at the beginning of your notebook enter:

.. code:: python

import proglog

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


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.


- Zulko_ (owner)
- `@tburrows13`_
- `@mgaitan`_
- `@earney`_
- `@mbeacom`_
- `@overdrivr`_
- `@keikoro`_
- `@ryanfox`_
- `@mondeja`_

.. MoviePy links
.. _gallery:
.. _documentation:
.. _`download MoviePy`:
.. _`Label Wiki`:
.. _Contributing Guidelines:

.. Websites, Platforms
.. _Reddit:
.. _PyPI:
.. _GitHub:
.. _Gitter:

.. Software, Tools, Libraries
.. _Pillow:
.. _Scipy:
.. _`OpenCV 2.4.6`:
.. _Pygame:
.. _Numpy:
.. _imageio:
.. _`Scikit Image`:
.. _Decorator:
.. _proglog:
.. _ffmpeg:
.. _ImageMagick:
.. _`Matplotlib`:
.. _`Sphinx`:

.. People
.. _Zulko:
.. _`@mgaitan`:
.. _`@tburrows13`:
.. _`@earney`:
.. _`@mbeacom`:
.. _`@overdrivr`:
.. _`@keikoro`:
.. _`@ryanfox`:
.. _`@mondeja`: