# Movis: Video Editing as a Code
[](https://www.python.org)
[](https://pypi.python.org/pypi/movis)
[](https://github.com/rezoo/movis)
[**Docs**](https://rezoo.github.io/movis/)
| [**Overview**](https://rezoo.github.io/movis/overview.html)
| [**Install Guide**](https://rezoo.github.io/movis/install.html)
| [**Examples**](https://github.com/rezoo/movis/tree/main/examples)
| [**API Reference**](https://rezoo.github.io/movis/reference/index.html)
| [**Contribution Guide**](https://rezoo.github.io/movis/contribution.html)
## ✅ What is Movis?
Movis is an engine written in Python, purposed for video production tasks.
This library allows users to generate various types of videos,
including but not limited to presentation videos, motion graphics,
shader art coding, and game commentary videos, through Python.
[](https://colab.research.google.com/github/rezoo/movis/blob/main/docs/Quickstart.ipynb)
## 🚀 Main Features
* Easy and intuitive video editing (including scene cut, transition, crop, concatenation, inserting images and texts, etc.)
* Layer transformation (position, scale, and rotation) with sub-pixel precision
* Support for a variety of Photoshop-level blending modes
* Keypoint and easing-based animation engine
* Nested compositions
* Inserting text layers containing multiple outlines
* Simple audio editing (including fade-in and fade-out effects)
* Support for a variety of video and audio formats using ffmpeg
* Layer effects (drop shadow, grow, blur, chromakey, etc.)
* Support for rendering at 1/2 quality and 1/4 quality for drafts
* Fast rendering using cache mechanism
* Adding user-defined layers, effects, and animations without using inheritance
## 💻 Installation
Movis is a pure Python library and can be installed via the [Python Package Index](https://pypi.org/):
```bash
$ pip install movis
```
We have confirmed that it works with Python 3.9 to 3.11.
## ⭐️ Code Overview
### Creating Video with Compositions
Similar to other video editing software,
Movis employs the concept of *"compositions"* as the fundamental unit for video editing.
Within a composition, users can include multiple layers and manipulate
these layers' attributes over a time scale to produce a video.
Effects can also be selectively applied to these layers as needed.
Here's some example code:
```python
import movis as mv
scene = mv.layer.Composition(size=(1920, 1080), duration=5.0)
scene.add_layer(mv.layer.Rectangle(scene.size, color='#fb4562')) # Set background
pos = scene.size[0] // 2, scene.size[1] // 2
scene.add_layer(
mv.layer.Text('Hello World!', font_size=256, font_family='Helvetica', color='#ffffff'),
name='text', # The layer item can be accessed by name
offset=1.0, # Show the text after one second
position=pos, # The layer is centered by default, but it can also be specified explicitly
anchor_point=(0.0, 0.0),
opacity=1.0, scale=1.0, rotation=0.0, # anchor point, opacity, scale, and rotation are also supported
blending_mode='normal') # Blending mode can be specified for each layer.
scene['text'].add_effect(mv.effect.DropShadow(offset=10.0)) # Multiple effects can be added.
scene['text'].scale.enable_motion().extend(
keyframes=[0.0, 1.0], values=[0.0, 1.0], easings=['ease_in_out'])
# Fade-in effect. It means that the text appears fully two seconds later.
scene['text'].opacity.enable_motion().extend([0.0, 1.0], [0.0, 1.0])
scene.write_video('output.mp4')
```
The composition can also be used as a layer.
By combining multiple compositions and layers, users can create complex videos.
```python
scene2 = mv.layer.Composition(scene.size, duration=scene.duration)
layer_item = scene2.add_layer(scene, name='scene')
# Equivalent to scene2['scene'].add_effect(...)
layer_item.add_effect(mv.effect.GaussianBlur(radius=10.0))
```
### Simple video processing
Of course, movis also supports simple video processing such as video merging and trimming.
#### concat
```python
intro = mv.layer.Video('intro.mp4')
title = mv.layer.Video('title.mp4')
chapter1 = mv.layer.Composition(size=(1920, 1080), duration=60.0)
...
scene = mv.concatenate([intro, title, chapter1, ...])
scene.write_video('output.mp4')
```
#### cutout
```python
raw_video = mv.layer.Video('video.mp4')
# select 0.0-1.0 secs and 2.0-3.0 secs, and concatenate them
scene = mv.trim(layer, start_times=[0.0, 2.0], end_times=[1.0, 3.0])
scene.write_video('output.mp4')
```
#### cropping
```python
layer = mv.layer.Image("image.png", duration=1.0)
# crop from x, y = (10, 20) with size w, h = (100, 200)
layer = mv.crop(layer, (10, 20, 100, 200))
```
#### fade-in / out
```python
layer = mv.layer.Video('video.mp4')
video1 = mv.fade_in(layer, 1.0) # fade-in for 1.0 secs
video2 = mv.fade_out(layer, 1.0) # fade-out for 1.0 secs
video3 = mv.fade_in_out(layer, 1.0, 2.0) # fade-in for 1.0 secs and fade-out for 2.0 secs
```
### Implementation of custom layers, effects, and animations
Movis is designed to make it easy for users to implement custom layers and effects.
This means that engineers can easily integrate their preferred visual effects and animations using Python.
For example, let's say you want to create a demo video using your own machine learning model for tasks
like anonymizing face images or segmenting videos.
With Movis, you can easily do this without the need for more complex languages like C++,
by directly using popular libraries such as [PyTorch](https://pytorch.org/) or [Jax](https://github.com/google/jax).
Additionally, for videos that make use of GPGPU like [shader art](https://www.shadertoy.com/),
you can implement these intuitively through Python libraries like [Jax](https://github.com/google/jax) or [cupy](https://cupy.dev/).
For example, to implement a user-defined layer, you only need to create a function that, given a time,
returns an `np.ndarray` with a shape of `(H, W, 4)` and dtype of `np.uint8` in RGBA order, or returns `None`.
```python
import numpy as np
import movis as mv
size = (640, 480)
def get_radial_gradient_image(time: float) -> np.ndarray:
center = np.array([size[1] // 2, size[0] // 2])
radius = min(size)
inds = np.mgrid[:size[1], :size[0]] - center[:, None, None]
r = np.sqrt((inds ** 2).sum(axis=0))
p = 255 - (np.clip(r / radius, 0, 1) * 255).astype(np.uint8)
img = np.zeros((size[1], size[0], 4), dtype=np.uint8)
img[:, :, :3] = p[:, :, None]
img[:, :, 3] = 255
return img
scene = mv.layer.Composition(size, duration=5.0)
scene.add_layer(get_radial_gradient_image)
scene.write_video('output.mp4')
```
If you want to specify the duration of a layer,
the `duration` property is required. Movis also offers caching features
to accelerate rendering. If you wish to speed up rendering for layers
where the frame remains static, you can implement the `get_key(time: float)` method:
```python
class RadialGradientLayer:
def __init__(self, size: tuple[int, int], duration: float):
self.size = size
self.duration = duration
self.center = np.array([size[1] // 2, size[0] // 2])
def get_key(self, time: float) -> Hashable:
# Returns 1 since the same image is always returned
return 1
def __call__(self, time: float) -> None | np.ndarray:
# ditto.
```
#### Custom effects
Effects for layers can also be implemented in a similar straightforward manner.
```python
import cv2
import movis as mv
import numpy as np
def apply_gaussian_blur(prev_image: np.ndarray, time: float) -> np.ndarray:
return cv2.GaussianBlur(prev_image, (7, 7), -1)
scene = mv.layer.Composition(size=(1920, 1080), duration=5.0)
scene.add_layer(mv.layer.Rectangle(scene.size, color='#fb4562'))
scene.add_layer(
mv.layer.Text('Hello World!', font_size=256, font_family='Helvetica', color='#ffffff'),
name='text')
scene['text'].add_effect(apply_gaussian_blur)
```
#### User-defined animations
Animation can be set up on a keyframe basis, but in some cases,
users may want to animate using user-defined functions.
movis provides methods to handle such situations as well.
```python
import movis as mv
import numpy as np
scene = mv.layer.Composition(size=(1920, 1080), duration=5.0)
scene.add_layer(
mv.layer.Text('Hello World!', font_size=256, font_family='Helvetica', color='#ffffff'),
name='text')
scene['text'].position.add_function(
lambda prev_value, time: prev_value + np.array([0, np.sin(time * 2 * np.pi) * 100]),
)
```
### Fast Prototyping on Jupyter Notebook
Jupyter notebooks are commonly used for data analysis that requires a lot of trial and error using Python.
Some methods for Jupyter notebooks are also included in movis to speed up the video production process.
For example, ``composition.render_and_play()`` is often used to
preview a section of a video within a Jupyter notebook.
```python
import movis as mv
scene = mv.layer.Composition(size=(1920, 1080), duration=10.0)
... # add layers and effects...
scene.render_and_play(
start_time=5.0, end_time=10.0, preview_level=2) # play the video from 5 to 10 seconds
```
This method has an argument called ``preview_level``.
For example, by setting it to 2, you can sacrifice video quality
by reducing the final resolution to 1/2 in exchange for faster rendering.
If you want to reduce the resolution when exporting videos or still images using
``composition.write_video()`` or similar methods,
you can use the syntax ``with composition.preview(level=2)``.
```python
import movis as mv
scene = mv.layer.Composition(size=(1920, 1080), duration=10.0)
... # add layers and effects...
with scene.preview(level=2):
scene.write_video('output.mp4') # The resolution of the output video is 1/2.
img = scene(5.0) # retrieve an image at t = 5.0
assert img.shape == (540, 960, 4)
```
Within this scope, the resolution of all videos and images will be reduced to 1/2.
This can be useful during the trial and error process.
## 📃 License
MIT License (see `LICENSE` for details).
Raw data
{
"_id": null,
"home_page": "https://github.com/rezoo/movis",
"name": "movis",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9.0",
"maintainer_email": "",
"keywords": "video video-processing video-editing",
"author": "Masaki Saito",
"author_email": "msaito@preferred.jp",
"download_url": "https://files.pythonhosted.org/packages/5e/59/61abb0eea8431a615498f8a604972a17ae06fee06eeb4fde4fd30519114e/movis-0.7.1.tar.gz",
"platform": null,
"description": "\n\n# Movis: Video Editing as a Code\n\n[](https://www.python.org)\n[](https://pypi.python.org/pypi/movis)\n[](https://github.com/rezoo/movis)\n\n\n\n[**Docs**](https://rezoo.github.io/movis/)\n| [**Overview**](https://rezoo.github.io/movis/overview.html)\n| [**Install Guide**](https://rezoo.github.io/movis/install.html)\n| [**Examples**](https://github.com/rezoo/movis/tree/main/examples)\n| [**API Reference**](https://rezoo.github.io/movis/reference/index.html)\n| [**Contribution Guide**](https://rezoo.github.io/movis/contribution.html)\n\n## \u2705 What is Movis?\n\nMovis is an engine written in Python, purposed for video production tasks.\nThis library allows users to generate various types of videos,\nincluding but not limited to presentation videos, motion graphics,\nshader art coding, and game commentary videos, through Python.\n\n[](https://colab.research.google.com/github/rezoo/movis/blob/main/docs/Quickstart.ipynb)\n\n## \ud83d\ude80 Main Features\n\n* Easy and intuitive video editing (including scene cut, transition, crop, concatenation, inserting images and texts, etc.)\n* Layer transformation (position, scale, and rotation) with sub-pixel precision\n* Support for a variety of Photoshop-level blending modes\n* Keypoint and easing-based animation engine\n* Nested compositions\n* Inserting text layers containing multiple outlines\n* Simple audio editing (including fade-in and fade-out effects)\n* Support for a variety of video and audio formats using ffmpeg\n* Layer effects (drop shadow, grow, blur, chromakey, etc.)\n* Support for rendering at 1/2 quality and 1/4 quality for drafts\n* Fast rendering using cache mechanism\n* Adding user-defined layers, effects, and animations without using inheritance\n\n## \ud83d\udcbb Installation\n\nMovis is a pure Python library and can be installed via the [Python Package Index](https://pypi.org/):\n\n```bash\n$ pip install movis\n```\n\nWe have confirmed that it works with Python 3.9 to 3.11.\n\n## \u2b50\ufe0f Code Overview\n\n### Creating Video with Compositions\n\nSimilar to other video editing software,\nMovis employs the concept of *\"compositions\"* as the fundamental unit for video editing.\nWithin a composition, users can include multiple layers and manipulate\nthese layers' attributes over a time scale to produce a video.\nEffects can also be selectively applied to these layers as needed.\n\nHere's some example code:\n\n```python\nimport movis as mv\n\nscene = mv.layer.Composition(size=(1920, 1080), duration=5.0)\nscene.add_layer(mv.layer.Rectangle(scene.size, color='#fb4562')) # Set background\n\npos = scene.size[0] // 2, scene.size[1] // 2\nscene.add_layer(\n mv.layer.Text('Hello World!', font_size=256, font_family='Helvetica', color='#ffffff'),\n name='text', # The layer item can be accessed by name\n offset=1.0, # Show the text after one second\n position=pos, # The layer is centered by default, but it can also be specified explicitly\n anchor_point=(0.0, 0.0),\n opacity=1.0, scale=1.0, rotation=0.0, # anchor point, opacity, scale, and rotation are also supported\n blending_mode='normal') # Blending mode can be specified for each layer.\nscene['text'].add_effect(mv.effect.DropShadow(offset=10.0)) # Multiple effects can be added.\nscene['text'].scale.enable_motion().extend(\n keyframes=[0.0, 1.0], values=[0.0, 1.0], easings=['ease_in_out'])\n# Fade-in effect. It means that the text appears fully two seconds later.\nscene['text'].opacity.enable_motion().extend([0.0, 1.0], [0.0, 1.0])\n\nscene.write_video('output.mp4')\n```\n\nThe composition can also be used as a layer.\nBy combining multiple compositions and layers, users can create complex videos.\n\n```python\nscene2 = mv.layer.Composition(scene.size, duration=scene.duration)\nlayer_item = scene2.add_layer(scene, name='scene')\n# Equivalent to scene2['scene'].add_effect(...)\nlayer_item.add_effect(mv.effect.GaussianBlur(radius=10.0))\n```\n\n### Simple video processing\n\nOf course, movis also supports simple video processing such as video merging and trimming.\n\n#### concat\n\n```python\nintro = mv.layer.Video('intro.mp4')\ntitle = mv.layer.Video('title.mp4')\nchapter1 = mv.layer.Composition(size=(1920, 1080), duration=60.0)\n...\nscene = mv.concatenate([intro, title, chapter1, ...])\nscene.write_video('output.mp4')\n```\n\n#### cutout\n\n```python\nraw_video = mv.layer.Video('video.mp4')\n# select 0.0-1.0 secs and 2.0-3.0 secs, and concatenate them\nscene = mv.trim(layer, start_times=[0.0, 2.0], end_times=[1.0, 3.0])\nscene.write_video('output.mp4')\n```\n\n#### cropping\n\n```python\nlayer = mv.layer.Image(\"image.png\", duration=1.0)\n# crop from x, y = (10, 20) with size w, h = (100, 200)\nlayer = mv.crop(layer, (10, 20, 100, 200))\n```\n\n#### fade-in / out\n\n```python\nlayer = mv.layer.Video('video.mp4')\nvideo1 = mv.fade_in(layer, 1.0) # fade-in for 1.0 secs\nvideo2 = mv.fade_out(layer, 1.0) # fade-out for 1.0 secs\nvideo3 = mv.fade_in_out(layer, 1.0, 2.0) # fade-in for 1.0 secs and fade-out for 2.0 secs\n```\n\n### Implementation of custom layers, effects, and animations\n\nMovis is designed to make it easy for users to implement custom layers and effects.\nThis means that engineers can easily integrate their preferred visual effects and animations using Python.\n\nFor example, let's say you want to create a demo video using your own machine learning model for tasks\nlike anonymizing face images or segmenting videos.\nWith Movis, you can easily do this without the need for more complex languages like C++,\nby directly using popular libraries such as [PyTorch](https://pytorch.org/) or [Jax](https://github.com/google/jax).\nAdditionally, for videos that make use of GPGPU like [shader art](https://www.shadertoy.com/),\nyou can implement these intuitively through Python libraries like [Jax](https://github.com/google/jax) or [cupy](https://cupy.dev/).\n\nFor example, to implement a user-defined layer, you only need to create a function that, given a time,\nreturns an `np.ndarray` with a shape of `(H, W, 4)` and dtype of `np.uint8` in RGBA order, or returns `None`.\n\n```python\nimport numpy as np\nimport movis as mv\n\nsize = (640, 480)\n\ndef get_radial_gradient_image(time: float) -> np.ndarray:\n center = np.array([size[1] // 2, size[0] // 2])\n radius = min(size)\n inds = np.mgrid[:size[1], :size[0]] - center[:, None, None]\n r = np.sqrt((inds ** 2).sum(axis=0))\n p = 255 - (np.clip(r / radius, 0, 1) * 255).astype(np.uint8)\n img = np.zeros((size[1], size[0], 4), dtype=np.uint8)\n img[:, :, :3] = p[:, :, None]\n img[:, :, 3] = 255\n return img\n\nscene = mv.layer.Composition(size, duration=5.0)\nscene.add_layer(get_radial_gradient_image)\nscene.write_video('output.mp4')\n```\n\nIf you want to specify the duration of a layer,\nthe `duration` property is required. Movis also offers caching features\nto accelerate rendering. If you wish to speed up rendering for layers\nwhere the frame remains static, you can implement the `get_key(time: float)` method:\n\n```python\nclass RadialGradientLayer:\n def __init__(self, size: tuple[int, int], duration: float):\n self.size = size\n self.duration = duration\n self.center = np.array([size[1] // 2, size[0] // 2])\n \n def get_key(self, time: float) -> Hashable:\n # Returns 1 since the same image is always returned\n return 1\n \n def __call__(self, time: float) -> None | np.ndarray:\n # ditto.\n```\n\n#### Custom effects\n\nEffects for layers can also be implemented in a similar straightforward manner.\n\n```python\nimport cv2\nimport movis as mv\nimport numpy as np\n\ndef apply_gaussian_blur(prev_image: np.ndarray, time: float) -> np.ndarray:\n return cv2.GaussianBlur(prev_image, (7, 7), -1)\n\nscene = mv.layer.Composition(size=(1920, 1080), duration=5.0)\nscene.add_layer(mv.layer.Rectangle(scene.size, color='#fb4562'))\nscene.add_layer(\n mv.layer.Text('Hello World!', font_size=256, font_family='Helvetica', color='#ffffff'),\n name='text')\nscene['text'].add_effect(apply_gaussian_blur)\n```\n\n#### User-defined animations\n\nAnimation can be set up on a keyframe basis, but in some cases,\nusers may want to animate using user-defined functions.\nmovis provides methods to handle such situations as well.\n\n```python\nimport movis as mv\nimport numpy as np\n\nscene = mv.layer.Composition(size=(1920, 1080), duration=5.0)\nscene.add_layer(\n mv.layer.Text('Hello World!', font_size=256, font_family='Helvetica', color='#ffffff'),\n name='text')\nscene['text'].position.add_function(\n lambda prev_value, time: prev_value + np.array([0, np.sin(time * 2 * np.pi) * 100]),\n)\n```\n\n### Fast Prototyping on Jupyter Notebook\n\nJupyter notebooks are commonly used for data analysis that requires a lot of trial and error using Python.\nSome methods for Jupyter notebooks are also included in movis to speed up the video production process.\n\nFor example, ``composition.render_and_play()`` is often used to\npreview a section of a video within a Jupyter notebook.\n\n```python\nimport movis as mv\n\nscene = mv.layer.Composition(size=(1920, 1080), duration=10.0)\n... # add layers and effects...\nscene.render_and_play(\n start_time=5.0, end_time=10.0, preview_level=2) # play the video from 5 to 10 seconds\n```\n\nThis method has an argument called ``preview_level``.\nFor example, by setting it to 2, you can sacrifice video quality\nby reducing the final resolution to 1/2 in exchange for faster rendering.\n\nIf you want to reduce the resolution when exporting videos or still images using\n``composition.write_video()`` or similar methods,\nyou can use the syntax ``with composition.preview(level=2)``.\n\n```python\nimport movis as mv\n\nscene = mv.layer.Composition(size=(1920, 1080), duration=10.0)\n... # add layers and effects...\nwith scene.preview(level=2):\n scene.write_video('output.mp4') # The resolution of the output video is 1/2.\n img = scene(5.0) # retrieve an image at t = 5.0\nassert img.shape == (540, 960, 4)\n```\n\nWithin this scope, the resolution of all videos and images will be reduced to 1/2.\nThis can be useful during the trial and error process.\n\n## \ud83d\udcc3 License\n\nMIT License (see `LICENSE` for details).\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A video editing library",
"version": "0.7.1",
"project_urls": {
"Homepage": "https://github.com/rezoo/movis",
"Source": "https://github.com/rezoo/movis"
},
"split_keywords": [
"video",
"video-processing",
"video-editing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7ab3fb2baaae993e57445d1175404852db89fbb868c4202e8b310fa49d278339",
"md5": "ad906f473e9f5867fd68d3621ec14609",
"sha256": "124b2f67e7a0c607f05d52c58fc3678118228ccba0fc6b31d2ac8c4d0e06ad4c"
},
"downloads": -1,
"filename": "movis-0.7.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ad906f473e9f5867fd68d3621ec14609",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9.0",
"size": 65481,
"upload_time": "2023-11-25T14:00:10",
"upload_time_iso_8601": "2023-11-25T14:00:10.317348Z",
"url": "https://files.pythonhosted.org/packages/7a/b3/fb2baaae993e57445d1175404852db89fbb868c4202e8b310fa49d278339/movis-0.7.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5e5961abb0eea8431a615498f8a604972a17ae06fee06eeb4fde4fd30519114e",
"md5": "e3caad0b7fb046370b04c1d40b552be7",
"sha256": "c70c42a0ac91583e655b8a8628259a3db6d8c99e93bab8887893129c8e997335"
},
"downloads": -1,
"filename": "movis-0.7.1.tar.gz",
"has_sig": false,
"md5_digest": "e3caad0b7fb046370b04c1d40b552be7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9.0",
"size": 63427,
"upload_time": "2023-11-25T14:00:13",
"upload_time_iso_8601": "2023-11-25T14:00:13.718689Z",
"url": "https://files.pythonhosted.org/packages/5e/59/61abb0eea8431a615498f8a604972a17ae06fee06eeb4fde4fd30519114e/movis-0.7.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-25 14:00:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rezoo",
"github_project": "movis",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": [
[
">=",
"1.18.1"
]
]
},
{
"name": "librosa",
"specs": [
[
">=",
"0.10.1"
]
]
},
{
"name": "Pillow",
"specs": [
[
">=",
"8.2.0"
]
]
},
{
"name": "imageio",
"specs": [
[
">=",
"2.31.1"
]
]
},
{
"name": "imageio-ffmpeg",
"specs": [
[
">=",
"0.4.8"
]
]
},
{
"name": "tqdm",
"specs": [
[
">=",
"4.46.0"
]
]
},
{
"name": "diskcache",
"specs": [
[
">=",
"5.6.1"
]
]
},
{
"name": "opencv-python",
"specs": [
[
">=",
"4.8.0"
]
]
},
{
"name": "PySide6",
"specs": [
[
">=",
"6.5.2"
]
]
}
],
"lcname": "movis"
}
JSON
