Make gallery fixes go live on github.io web-site.

.gitignore

@@ -0,0 +1,61 @@
+*.py[cod]
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+*.tar.gz
+dist
+build
+eggs
+.eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+__pycache__
+.cache/
+
+# Sublime
+.sublime-project
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.tox
+nosetests.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# Temp files
+*~
+
+# Pipy codes
+.pypirc
+
+# Mac
+.DS_Store
+
+# JetBrains
+.idea
+
+# Tests
+tests/media
+media/
+
+# Documentation
+docs/build/

.travis.yml

@@ -0,0 +1,48 @@
+dist: trusty
+sudo: required
+language: python
+cache: pip
+python:
+  - "2.7"
+  - "3.3"
+  - "3.4"
+  - "3.5"
+  - "3.6"
+
+before_install:
+  - sudo add-apt-repository -y ppa:kirillshkrogalev/ffmpeg-next
+  - sudo apt-get -y -qq update
+  - sudo apt-get install -y -qq ffmpeg
+  - mkdir media
+
+  # Ensure PIP is up-to-date to avoid warnings.
+  - python -m pip install --upgrade pip
+  # Ensure setuptools is up-to-date to avoid environment_markers bug.
+  - pip install --upgrade setuptools
+  # The default py that is installed is too old on some platforms, leading to version conflicts
+  - pip install --upgrade py pytest
+
+install:
+  - echo "No install action required. Implicitly performed by the testing."
+  - pip install flake8
+
+before_script:
+  # stop the build if there are Python syntax errors or undefined names
+  - flake8 . --count --select=E901,E999,F821,F822,F823 --show-source --statistics --exit-zero
+  # exit-zero treats all errors as warnings.  The GitHub editor is 127 chars wide
+  - flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+script:
+  - python setup.py test --pytest-args "tests/ --doctest-modules -v --cov moviepy --cov-report term-missing"
+  # Now the *code* is tested, let's check that the setup is compatible with PIP without falling over.
+  - pip install -e .
+  - pip install -e .[optional]
+  - pip install -e .[test]
+  # Only test doc generation on latest. Doesn't work on some earlier versions (3.3), but doesn't matter.
+  - if [[ $TRAVIS_PYTHON_VERSION == '3.6' ]]; then pip install -e .[doc]; fi
+
+after_success:
+  - coveralls
+
+matrix:
+    fast_finish: true

Dockerfile

@@ -0,0 +1,32 @@
+FROM python:3
+
+# Install numpy using system package manager
+RUN apt-get -y update && apt-get -y install libav-tools imagemagick libopencv-dev python-opencv
+
+# Install some special fonts we use in testing, etc..
+RUN apt-get -y install fonts-liberation
+
+RUN apt-get install -y locales && \
+    locale-gen C.UTF-8 && \
+    /usr/sbin/update-locale LANG=C.UTF-8
+
+ENV LC_ALL C.UTF-8
+
+# do we need all of these, maybe remove some of them?
+RUN pip install imageio numpy scipy matplotlib pandas sympy nose decorator tqdm pillow pytest requests
+
+# install scikit-image after the other deps, it doesn't cause errors this way.
+RUN pip install scikit-image sklearn
+
+ADD . /var/src/moviepy/
+#RUN git clone https://github.com/Zulko/moviepy.git /var/src/moviepy
+RUN cd /var/src/moviepy/ && python setup.py install
+
+# install ffmpeg from imageio.
+RUN python -c "import imageio; imageio.plugins.ffmpeg.download()"
+
+#add soft link so that ffmpeg can executed (like usual) from command line
+RUN ln -s /root/.imageio/ffmpeg/ffmpeg.linux64 /usr/bin/ffmpeg
+
+# modify ImageMagick policy file so that Textclips work correctly.
+RUN cat /etc/ImageMagick-6/policy.xml | sed 's/none/read,write/g'> /etc/ImageMagick-6/policy.xml 

LICENCE.txt

@@ -0,0 +1,25 @@
+The MIT License (MIT)
+[OSI Approved License]
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Zulko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

MANIFEST.in

@@ -0,0 +1,4 @@
+include *.txt
+recursive-include docs *
+include *.rst
+include ez_setup.py

README.rst

@@ -0,0 +1,182 @@
+MoviePy
+=======
+
+.. image:: https://badge.fury.io/py/moviepy.svg
+    :target: PyPI_
+    :alt: MoviePy page on the Python Package Index
+.. image:: https://badges.gitter.im/movie-py/gitter.png
+    :target: Gitter_
+    :alt: Discuss MoviePy on Gitter
+.. image:: https://travis-ci.org/Zulko/moviepy.svg?branch=master
+    :target: https://travis-ci.org/Zulko/moviepy
+    :alt: Build status on travis-ci
+
+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. Here it is in action in an IPython notebook:
+
+.. image:: https://github.com/raw/Zulko/moviepy/master/docs/demo_preview.jpeg
+    :alt: [logo]
+    :align: center
+
+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:
+
+.. code:: python
+
+    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.
+- `Matplotlib`_
+
+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 <!-- <policy domain="path" rights="none" pattern="@*" /> -->.
+
+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.
+
+
+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.
+
+You can also discuss the project on Reddit_ (preferred over GitHub issues for usage/examples), Gitter_ or the mailing list moviepy@librelist.com.
+
+We have a list of tags used in our `Tag Wiki`_. The 'Pull Requests' tags are well defined, and all PRs should fall under exactly one of these.  The 'Issues' tags are less precise, and may not be a complete list.
+
+
+Maintainers
+-----------
+
+- Zulko_ (owner)
+
+- `@tburrows13`_
+- `@earney`_
+- Kay `@kerstin`_
+- `@mbeacom`_
+
+
+.. MoviePy links
+.. _gallery: http://zulko.github.io/moviepy/gallery.html
+.. _documentation: http://zulko.github.io/moviepy/
+.. _`download MoviePy`: https://github.com/Zulko/moviepy
+.. _`Tag Wiki`: https://github.com/Zulko/moviepy/wiki/Tag-Wiki
+
+.. Websites, Platforms
+.. _Reddit: http://www.reddit.com/r/moviepy/
+.. _PyPI: https://pypi.python.org/pypi/moviepy
+.. _GitHub: https://github.com/Zulko/moviepy
+.. _Gitter: https://gitter.im/movie-py/Lobby
+
+.. Software, Tools, Libraries
+.. _Pillow: http://pillow.readthedocs.org/en/latest/
+.. _Scipy: http://www.scipy.org/
+.. _`OpenCV 2.4.6`: http://sourceforge.net/projects/opencvlibrary/files/
+.. _Pygame: http://www.pygame.org/download.shtml
+.. _Numpy: http://www.scipy.org/install.html
+.. _imageio: http://imageio.github.io/
+.. _`Scikit Image`: http://scikit-image.org/download.html
+.. _Decorator: https://pypi.python.org/pypi/decorator
+.. _tqdm: https://github.com/noamraph/tqdm
+.. _ffmpeg: http://www.ffmpeg.org/download.html
+.. _ImageMagick: http://www.imagemagick.org/script/index.php
+.. _`Matplotlib`: https://matplotlib.org/
+.. _`Sphinx`: http://www.sphinx-doc.org/en/master/setuptools.html
+
+.. People
+.. _Zulko: https://github.com/Zulko
+.. _`@tburrows13`: https://github.com/tburrows13
+.. _`@earney`: https://github.com/earney
+.. _`@kerstin`: https://github.com/kerstin
+.. _`@mbeacom`: https://github.com/mbeacom