电影剪辑工具

.. image:: https://badge.fury.io/py/moviepy.svg :target: PyPI_ :alt: 在Python包索引上的MoviePy页面 .. image:: https://img.shields.io/gitter/room/movie-py/gitter?color=46BC99&logo=gitter :target: Gitter_ :alt: 在Gitter上讨论MoviePy .. image:: https://img.shields.io/github/actions/workflow/status/Zulko/moviepy/test_suite.yml?logo=github :target: https://github.com/Zulko/moviepy/actions/workflows/test_suite.yml :alt: 在GitHub Actions上的构建状态 .. image:: https://img.shields.io/coveralls/github/Zulko/moviepy/master?logo=coveralls :target: https://coveralls.io/github/Zulko/moviepy?branch=master :alt: 来自Coveralls.io的代码覆盖率

MoviePy (完整文档_) 是一个用于视频编辑的Python库:剪切、拼接、插入标题、视频合成(非线性编辑)、视频处理和创建自定义特效。请查看图库_了解一些使用示例。

MoviePy可以读取和写入所有常见的音频和视频格式,包括GIF,并可在Windows/Mac/Linux上运行,支持Python 3.6+。以下是在IPython笔记本中的演示:

.. image:: https://raw.githubusercontent.com/Zulko/moviepy/master/docs/demo_preview.jpeg :alt: [logo] :align: center

示例

在这个示例中,我们打开一个视频文件,选择50秒到60秒之间的片段,在屏幕中央添加一个标题,并将结果写入一个新文件:

.. code:: python

from moviepy import *

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

# 制作文本。还有更多选项可用。
txt_clip = ( TextClip("My Holidays 2013",fontsize=70,color='white')
             .with_position('center')
             .with_duration(10) )

result = CompositeVideoClip([video, txt_clip]) # 在视频上叠加文本
result.write_videofile("myHolidays_edited.webm",fps=25) # 许多选项...

注意: 这个示例使用了新的2.x API,对于当前在PyPI上的MoviePy 1.0.3,请参考这个代码片段 <https://gist.github.com/Zulko/57e6e50debef1834fb9b60700b1b9f99>_.

寻找维护者!

由于越来越多的人寻求支持(截至2021年1月共有270个待解决的问题!),而所有的MoviePy维护者似乎都很忙,我们很希望听到有兴趣提供帮助的开发人员,来解决一些问题(尤其是那些影响到你的问题)或审查拉取请求。如果你有兴趣,请开一个issue或直接与我们联系。谢谢!

安装

MoviePy需要依赖NumPy_、Imageio_、Decorator_和Proglog_这些Python模块,这些模块将在安装MoviePy时自动安装。FFMPEG软件在您第一次使用MoviePy时将自动下载/安装(安装过程将需要几秒钟)。如果您想使用特定版本的FFMPEG,请按照config_defaults.py中的说明操作。如果遇到任何问题,请提供反馈。

**手动安装:**从PyPI_下载源码,或者如果您想要开发版本,可以从GitHub_下载,将所有内容解压到一个文件夹中,然后在终端中输入:

.. code:: bash

$ (sudo) python setup.py install

**使用pip安装:**如果您安装了pip,只需在终端中输入:

.. code:: bash

$ (sudo) pip install moviepy

如果您既没有安装setuptools也没有安装ez_setup,上面的命令将会失败。在这种情况下,请先输入:

.. code:: bash

$ (sudo) pip install setuptools

可选但有用的依赖项


您可以通过以下方式安装带有所有依赖项的``moviepy``:

.. code:: bash

    $ (sudo) pip install moviepy[optional]

ImageMagick_虽然不是严格必需的,但如果您想要插入文本,它是需要的。它也可以用作GIF的后端,尽管您也可以在没有ImageMagick的情况下使用MoviePy创建GIF。

安装ImageMagick后,MoviePy将尝试自动检测其可执行文件的路径。如果失败,您仍然可以通过设置环境变量来配置它(请参阅文档)。

PyGame_用于视频和声音预览(如果您打算在服务器上使用MoviePy,这可能不太重要,但对于手动进行高级视频编辑来说至关重要)。

对于高级图像处理,您将需要以下一个或多个软件包:
以下是英文源文本的中文翻译:

- Python 图像处理库 (PIL) 或者其分支 Pillow。
- Scipy (用于跟踪、分割等) 可用于调整视频片段大小,如果没有安装 PIL 和 OpenCV。
- Scikit Image 可能需要用于一些高级图像处理。
- OpenCV 2.4.6 或更新版本(提供 cv2 包)可能需要用于一些高级图像处理。
- Matplotlib

例如,使用 `clip.resize` 方法需要至少安装 Scipy、PIL、Pillow 或 OpenCV 中的一个。

文档
-------------

生成文档有额外的依赖需要安装。

.. code:: bash

    $ (sudo) pip install moviepy[doc]

可以通过以下方式生成并查看文档:

.. code:: bash

    $ python setup.py build_docs

您可以传递额外的参数给文档构建,比如清理构建:

.. code:: bash

    $ python setup.py build_docs -E

更多信息请参考 Sphinx 文档。

1.0.0 新特性: 使用 Proglog 的进度条和消息
-------------------------------------------------------

1.0.0 版本中引入了不兼容的变更,用于使用 Proglog 管理进度条和消息,这可以在控制台以及 Jupyter 笔记本或任何用户界面(如网站)中显示漂亮的进度条。

要在笔记本中显示友好的进度条,首先需要安装 IPyWidgets:

.. code::

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

然后在笔记本开始时输入:

.. code:: python

    import proglog
    proglog.notebook()

请查看 Proglog 项目页面以了解更多选项。

贡献
----------

MoviePy 是由 Zulko 编写并在 MIT 许可下发布的开源软件。该项目托管在 GitHub 上,欢迎大家贡献、求助或提供反馈。请阅读我们的《贡献指南》以了解更多关于如何贡献的信息!

您也可以在 Reddit 或 Gitter 上讨论该项目。这些比 GitHub 问题更适合用于使用问题和示例。

维护者
-----------

- Zulko (所有者)
- @tburrows13
- @mgaitan
- @earney
- @mbeacom
- @overdrivr
- @keikoro
- @ryanfox
- @mondeja