MotionDirector

KO | EN

gitlite — search

#python #react #ai #llm #golang #go #deep-learning #macos #java #windows #cli #vue #pytorch #mcp

(★ 1,048)

[ECCV 2024 Oral] MotionDirector: Motion Customization of Text-to-Video Diffusion Models.

File Explorer

Download Latest Version (.zip)

- - An_astronaut_is_lifting_weights_on_Mars_4K_high_quailty_highly_detailed_4008521.gif
  - An_astronaut_is_riding_a_bicycle_past_the_pyramids_Mars_4K_high_quailty_highly_detailed_5532778.gif
  - An_astronaut_is_riding_a_horse_on_Mars_4K_high_quailty_highly_detailed_1913261.gif
  - An_astronaut_is_skateboarding_on_Mars_6615212.gif
  - An_astronaut_is_standing_on_Mars_captured_with_an_orbit_cinematic_shot_7483453.gif
  - An_astronaut_is_walking_on_Mars_captured_with_a_follow_cinematic_shot_6191674.gif
  - An_astronaut_is_walking_on_Mars_captured_with_a_reverse_follow_cinematic_shot_1224445.gif
  - Astronaut_playing_golf_on_Mars_659514.gif
- - A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_dolly_zoom_4615820.gif
  - A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_dolly_zoom_9365597.gif
  - A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_zoom_in_1429227.gif
  - A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_zoom_in_991349.gif
  - A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_zoom_out_4971910.gif
  - A_lion_sitting_on_top_of_a_cliff_captured_with_a_dolly_zoom_1675932.gif
  - A_lion_sitting_on_top_of_a_cliff_captured_with_a_dolly_zoom_4114896.gif
  - A_lion_sitting_on_top_of_a_cliff_captured_with_a_zoom_in_487239.gif
  - A_lion_sitting_on_top_of_a_cliff_captured_with_a_zoom_out_1767994.gif
  - A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_dolly_zoom_2310805.gif
  - A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_dolly_zoom_7492004.gif
  - A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_zoom_in_1393184.gif
  - A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_zoom_out_8203639.gif
  - dolly_zoom_16.gif
  - zoom_in_16.gif
  - zoom_out_16.gif
- - A_Terracotta_Warrior_is_lifting_weights_in_front_of_the_Great_Wall_5635982.gif
  - A_Terracotta_Warrior_is_playing_golf_in_front_of_the_Great_Wall_5804477.gif
  - A_Terracotta_Warrior_is_riding_a_bicycle_past_an_ancient_Chinese_palace_166357.gif
  - A_Terracotta_Warrior_is_riding_a_horse_through_an_ancient_battlefield_1455028.gif
  - A_Terracotta_Warrior_is_skateboarding_9033688.gif
  - A_Terracotta_Warrior_is_walking_cross_the_ancient_army_captured_with_a_reverse_follow_cinematic_shot_653658.gif
  - reference_images.png
- - A_car_is_running_on_the_road_5057764.gif
  - A_car_is_running_on_the_road_covered_with_snow_4904543.gif
  - car-turn-original.gif
- - A_man_is_riding_a_bicycle_past_the_Eiffel_Tower_5419418.gif
  - A_panda_is_riding_a_bicycle_in_a_garden_2178639.gif
  - A_person_is_riding_a_bicycle_past_the_Eiffel_Tower_7192280.gif
  - An_alien_is_riding_a_bicycle_on_Mars_2390886.gif
  - reference_videos.gif
- - A_lion_is_running_past_the_pyramids_431554.gif
  - A_spaceship_is_flying_past_Mars_8808231.gif
  - A_tank_is_running_on_the_moon_8551187.gif
  - reference_video.gif
- config_multi_images.yaml
- config_multi_videos.yaml
- config_single_image.yaml
- config_single_video.yaml
- config_single_video_24.yaml
- unet_3d_blocks.py
- unet_3d_condition.py
- - stock-footage-cartoon-man-riding-a-bicycle-on-autumn-city-background-d-rendering-motion-graphic-animation.mp4
  - stock-footage-woman-riding-bike-on-city-paved-road-woman-bicycle-rider-have-a-ride-in-the-morning-empty-city.mp4
  - stock-footage-young-hipster-man-in-helmet-riding-fixed-gear-bicycle-in-the-city-during-autumn-morning-side-view.mp4
  - stock-footage-young-stylish-businessman-go-to-work-on-his-sport-retro-bike-in-sunny-day.mp4
- - car-turn-24.mp4
  - car-turn.mp4
- - car.jpg
- - 001.jpg
  - 002.jpg
  - 003.jpg
  - 004.jpg
  - 005.jpg
  - 006.jpg
  - 007.jpg
  - 008.jpg
- bucketing.py
- convert_diffusers_to_original_ms_text_to_video.py
- dataset.py
- ddim_utils.py
- extract_16frames.py
- lora.py
- lora_handler.py
LICENSE
MotionDirector_inference.py
MotionDirector_inference_multi.py
MotionDirector_train.py
README.md
requirements.txt

# Installation Guide

1. Get the code

git clone https://github.com/showlab/MotionDirector

Downloads the entire project code from GitHub to your computer.

cd MotionDirector

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install -r requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h2 align="center">MotionDirector: Motion Customization of Text-to-Video Diffusion Models</h2>
 
 <a href="https://ruizhaocv.github.io/">Rui Zhao</a>
 ·
 <a href="https://ycgu.site/">Yuchao Gu</a>
 ·
 <a href="https://zhangjiewu.github.io/">Jay Zhangjie Wu</a>
 ·
 <a href="https://junhaozhang98.github.io//">David Junhao Zhang</a>
 ·
 <a href="https://jia-wei-liu.github.io/">Jia-Wei Liu</a>
 ·
 <a href="https://weijiawu.github.io/">Weijia Wu</a>
 ·
 <a href="https://www.jussikeppo.com/">Jussi Keppo</a>
 ·
 <a href="https://sites.google.com/view/showlab">Mike Zheng Shou</a>
 
 
 <a href="https://arxiv.org/abs/2310.08465"><img src='https://img.shields.io/badge/arXiv-2310.08465-b31b1b.svg'></a>
 <a href='https://showlab.github.io/MotionDirector'><img src='https://img.shields.io/badge/Project_Page-MotionDirector-blue'></a>
 <a href='https://huggingface.co/spaces/ruizhaocv/MotionDirector'><img src='https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-yellow'></a>
 <a href='https://www.youtube.com/watch?v=Wq93zi8bE3U'><img src='https://img.shields.io/badge/Demo_Video-MotionDirector-red'></a>
 
 Show Lab, National University of Singapore

<img src="https://github.com/showlab/MotionDirector/blob/page/assets/teaser.gif" width="1080px"/> 
 
MotionDirector can customize text-to-video diffusion models to generate videos with desired motions.

## Task Definition
Motion Customization of Text-to-Video Diffusion Models: 
Given a set of video clips of the same motion concept, the task of **Motion Customization** is to adapt existing text-to-video diffusion
models to generate diverse videos with this motion.

## Demos
### Demo Video:
[![Demo Video of MotionDirector](https://res.cloudinary.com/marcomontalbano/image/upload/v1702612078/video_to_markdown/images/youtube--Wq93zi8bE3U-c05b58ac6eb4c4700831b2b3070cd403.jpg)](https://www.youtube.com/watch?v=Wq93zi8bE3U "Demo Video of MotionDirector")

### Customize both Appearance and Motion: <a name="Customize_both_Appearance_and_Motion"></a>
<table class="center"> 
<tr>
 <td style="text-align:center;">Reference images or videos</td>
 <td style="text-align:center;" colspan="3">Videos generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=assets/customized_appearance_results/reference_images.png></td>
 <td><img src=assets/customized_appearance_results/A_Terracotta_Warrior_is_riding_a_horse_through_an_ancient_battlefield_1455028.gif></td>
 <td><img src=assets/customized_appearance_results/A_Terracotta_Warrior_is_playing_golf_in_front_of_the_Great_Wall_5804477.gif></td>
 <td><img src=assets/customized_appearance_results/A_Terracotta_Warrior_is_walking_cross_the_ancient_army_captured_with_a_reverse_follow_cinematic_shot_653658.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">Reference images for appearance customization: "A Terracotta Warrior on a pure color background."</td>
 <td width=25% style="text-align:center;">"A Terracotta Warrior is riding a horse through an ancient battlefield." seed: 1455028</td>
 <td width=25% style="text-align:center;">"A Terracotta Warrior is playing golf in front of the Great Wall." seed: 5804477</td>
 <td width=25% style="text-align:center;">"A Terracotta Warrior is walking cross the ancient army captured with a reverse follow cinematic shot." seed: 653658</td>
</tr>
<tr>
 <td><img src=assets/multi_videos_results/reference_videos.gif></td>
 <td><img src=assets/customized_appearance_results/A_Terracotta_Warrior_is_riding_a_bicycle_past_an_ancient_Chinese_palace_166357.gif></td>
 <td><img src=assets/customized_appearance_results/A_Terracotta_Warrior_is_lifting_weights_in_front_of_the_Great_Wall_5635982.gif></td>
 <td><img src=assets/customized_appearance_results/A_Terracotta_Warrior_is_skateboarding_9033688.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">Reference videos for motion customization: "A person is riding a bicycle."</td>
 <td width=25% style="text-align:center;">"A Terracotta Warrior is riding a bicycle past an ancient Chinese palace." seed: 166357.</td>
 <td width=25% style="text-align:center;">"A Terracotta Warrior is lifting weights in front of the Great Wall." seed: 5635982</td>
 <td width=25% style="text-align:center;">"A Terracotta Warrior is skateboarding." seed: 9033688</td>
</tr>
</table>

## News
- [2024.02.03] [MotionDirector for AnimateDiff](https://github.com/ExponentialML/AnimateDiff-MotionDirector) is available. Thanks to [ExponentialML](https://github.com/ExponentialML).
- [2023.12.27] [MotionDirector with Customized Appearance](#motiondirector-with-customized-appearance-) released. Now, you can customize both appearance and motion in video generation.
- [2023.12.27] [MotionDirector for Image Animation](#motiondirector-for-image-animation-) released.
- [2023.12.23] MotionDirector has been featured in Hugging Face's '[Spaces of the Week](https://huggingface.co/spaces) 🔥' trending list! 
- [2023.12.13] Online gradio demo released @ [Hugging Face Spaces](https://huggingface.co/spaces/ruizhaocv/MotionDirector)! Welcome to try it.
- [2023.12.06] [MotionDirector for Sports](#motiondirector-for-sports-) released! Lifting weights, riding horse, palying golf, etc.
- [2023.12.05] [Colab demo](https://github.com/camenduru/MotionDirector-colab) is available. Thanks to [Camenduru](https://twitter.com/camenduru).
- [2023.12.04] [MotionDirector for Cinematic Shots](#motiondirector-for-cinematic-shots-) released. Now, you can make AI films with professional cinematic shots!
- [2023.12.02] Code and model weights released!
- [2023.10.12] Paper and project page released.

## ToDo
- [x] Gradio Demo
- [ ] More trained weights of MotionDirector

## Model List

| Type |                                                       Training Data                                                       |                                      Descriptions                                       | Link  |
| :---: |:-------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------:|:---:|
| MotionDirector for Sports   |                                              Multiple videos for each model.                                              | Learn motion concepts of sports, i.e. lifting weights, riding horse, palying golf, etc. | [Link](#motiondirector-for-sports-)  |
| MotionDirector for Cinematic Shots   |                                              A single video for each model.                                               |   Learn motion concepts of cinematic shots, i.e. dolly zoom, zoom in, zoom out, etc.    | [Link](#motiondirector-for-cinematic-shots-)  |
| MotionDirector for Image Animation   |                 A single image for spatial path. And a single video or multiple videos for temporal path.                 |                      Animate the given image with learned motions.                      | [Link](#motiondirector-for-image-animation-)  |
| MotionDirector with Customized Appearance  | A single image or multiple images for spatial path. And a single video or multiple videos for temporal path. |                Customize both appearance and motion in video generation.                | [Link](#motiondirector-with-customized-appearance-)  |

## Setup
### Requirements

```shell
# create virtual environment
conda create -n motiondirector python=3.8
conda activate motiondirector
# install packages
pip install -r requirements.txt
```

### Weights of Foundation Models
```shell
git lfs install
## You can choose the ModelScopeT2V or ZeroScope, etc., as the foundation model.
## ZeroScope
git clone https://huggingface.co/cerspense/zeroscope_v2_576w ./models/zeroscope_v2_576w/
## ModelScopeT2V
git clone https://huggingface.co/damo-vilab/text-to-video-ms-1.7b ./models/model_scope/
```
### Weights of trained MotionDirector <a name="download_weights"></a>
```shell
# Make sure you have git-lfs installed (https://git-lfs.com)
git lfs install
git clone https://huggingface.co/ruizhaocv/MotionDirector_weights ./outputs

# More and better trained MotionDirector are released at a new repo:
git clone https://huggingface.co/ruizhaocv/MotionDirector ./outputs
# The usage is slightly different, which will be updated later.
```

## Usage
### Training

#### Train MotionDirector on multiple videos:
```bash
python MotionDirector_train.py --config ./configs/config_multi_videos.yaml
```
#### Train MotionDirector on a single video:
```bash
python MotionDirector_train.py --config ./configs/config_single_video.yaml
```

Note:  
- Before running the above command, 
make sure you replace the path to foundational model weights and training data with your own in the config files `config_multi_videos.yaml` or `config_single_video.yaml`.
- Generally, training on multiple 16-frame videos usually takes `300~500` steps, about `9~16` minutes using one A5000 GPU. Training on a single video takes `50~150` steps, about `1.5~4.5` minutes using one A5000 GPU. The required VRAM for training is around `14GB`.
- Reduce `n_sample_frames` if your GPU memory is limited.
- Reduce the learning rate and increase the training steps for better performance.

### Inference
```bash
python MotionDirector_inference.py --model /path/to/the/foundation/model  --prompt "Your prompt" --checkpoint_folder /path/to/the/trained/MotionDirector --checkpoint_index 300 --noise_prior 0.
```
Note: 
- Replace `/path/to/the/foundation/model` with your own path to the foundation model, like ZeroScope.
- The value of `checkpoint_index` means the checkpoint saved at which the training step is selected.
- The value of `noise_prior` indicates how much the inversion noise of the reference video affects the generation. 
We recommend setting it to `0` for MotionDirector trained on multiple videos to achieve the highest diverse generation, while setting it to `0.1~0.5` for MotionDirector trained on a single video for faster convergence and better alignment with the reference video.

## Inference with pre-trained MotionDirector
All available weights are at official [Huggingface Repo](https://huggingface.co/ruizhaocv/MotionDirector_weights).
Run the [download command](#download_weights), the weights will be downloaded to the folder `outputs`, then run the following inference command to generate videos.

### MotionDirector trained on multiple videos:
```bash
python MotionDirector_inference.py --model /path/to/the/ZeroScope  --prompt "A person is riding a bicycle past the Eiffel Tower." --checkpoint_folder ./outputs/train/riding_bicycle/ --checkpoint_index 300 --noise_prior 0. --seed 7192280
```
Note:  
- Replace `/path/to/the/ZeroScope` with your own path to the foundation model, i.e. the ZeroScope.
- Change the `prompt` to generate different videos. 
- The `seed` is set to a random value by default. Set it to a specific value will obtain certain results, as provided in the table below.

Results:

<table class="center">
<tr>
 <td style="text-align:center;">Reference Videos</td>
 <td style="text-align:center;" colspan="3">Videos Generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=assets/multi_videos_results/reference_videos.gif></td>
 <td><img src=assets/multi_videos_results/A_person_is_riding_a_bicycle_past_the_Eiffel_Tower_7192280.gif></td>
 <td><img src=assets/multi_videos_results/A_panda_is_riding_a_bicycle_in_a_garden_2178639.gif></td> 
 <td><img src=assets/multi_videos_results/An_alien_is_riding_a_bicycle_on_Mars_2390886.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A person is riding a bicycle."</td>
 <td width=25% style="text-align:center;">"A person is riding a bicycle past the Eiffel Tower.” seed: 7192280</td>
 <td width=25% style="text-align:center;">"A panda is riding a bicycle in a garden." seed: <s>2178639</s> </td>
 <td width=25% style="text-align:center;">"An alien is riding a bicycle on Mars." seed: 2390886</td>
</table>

### MotionDirector trained on a single video:
16 frames:
```bash
python MotionDirector_inference.py --model /path/to/the/ZeroScope --prompt "A tank is running on the moon." --checkpoint_folder ./outputs/train/car_16/ --checkpoint_index 150 --noise_prior 0.5 --seed 8551187
```
<table class="center">
<tr>
 <td style="text-align:center;">Reference Video</td>
 <td style="text-align:center;" colspan="3">Videos Generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=assets/single_video_results/reference_video.gif></td>
 <td><img src=assets/single_video_results/A_tank_is_running_on_the_moon_8551187.gif></td>
 <td><img src=assets/single_video_results/A_lion_is_running_past_the_pyramids_431554.gif></td> 
 <td><img src=assets/single_video_results/A_spaceship_is_flying_past_Mars_8808231.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A car is running on the road."</td>
 <td width=25% style="text-align:center;">"A tank is running on the moon.” seed: 8551187</td>
 <td width=25% style="text-align:center;">"A lion is running past the pyramids." seed: 431554</td>
 <td width=25% style="text-align:center;">"A spaceship is flying past Mars." seed: 8808231</td>
</tr>
</table>

24 frames:
```bash
python MotionDirector_inference.py --model /path/to/the/ZeroScope --prompt "A truck is running past the Arc de Triomphe." --checkpoint_folder ./outputs/train/car_24/ --checkpoint_index 150 --noise_prior 0.5 --width 576 --height 320 --num-frames 24 --seed 34543
```
<table class="center">
<tr>
 <td style="text-align:center;">Reference Video</td>
 <td style="text-align:center;" colspan="3">Videos Generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=assets/single_video_results/24_frames/reference_video.gif></td>
 <td><img src=assets/single_video_results/24_frames/A_truck_is_running_past_the_Arc_de_Triomphe_34543.gif></td>
 <td><img src=assets/single_video_results/24_frames/An_elephant_is_running_in_a_forest_2171736.gif></td> 
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A car is running on the road."</td>
 <td width=25% style="text-align:center;">"A truck is running past the Arc de Triomphe.” seed: 34543</td>
 <td width=25% style="text-align:center;">"An elephant is running in a forest." seed: 2171736</td>
 </tr>
<tr>
 <td><img src=assets/single_video_results/24_frames/reference_video.gif></td>
 <td><img src=assets/single_video_results/24_frames/A_person_on_a_camel_is_running_past_the_pyramids_4904126.gif></td> 
 <td><img src=assets/single_video_results/24_frames/A_spacecraft_is_flying_past_the_Milky_Way_galaxy_3235677.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A car is running on the road."</td>
 <td width=25% style="text-align:center;">"A person on a camel is running past the pyramids." seed: 4904126</td>
 <td width=25% style="text-align:center;">"A spacecraft is flying past the Milky Way galaxy." seed: 3235677</td>
</tr>
</table>

## MotionDirector for Sports <a name="MotionDirector_for_Sports"></a>

```bash
python MotionDirector_inference.py --model /path/to/the/ZeroScope  --prompt "A panda is lifting weights in a garden." --checkpoint_folder ./outputs/train/lifting_weights/ --checkpoint_index 300 --noise_prior 0. --seed 9365597
```

<table class="center">
<tr>
 <td style="text-align:center;" colspan="4">Videos Generated by MotionDirector</td>
</tr>
<tr>
<td style="text-align:center;" colspan="2">Lifting Weights</td>
<td style="text-align:center;" colspan="2">Riding Bicycle</td>
</tr>
<tr>
 <td><img src=assets/sports_results/lifting_weights/A_panda_is_lifting_weights_in_a_garden_1699276.gif></td>
 <td><img src=assets/sports_results/lifting_weights/A_police_officer_is_lifting_weights_in_front_of_the_police_station_6804745.gif></td>
 <td><img src=assets/multi_videos_results/A_panda_is_riding_a_bicycle_in_a_garden_2178639.gif></td> 
 <td><img src=assets/multi_videos_results/An_alien_is_riding_a_bicycle_on_Mars_2390886.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;">"A panda is lifting weights in a garden.” seed: 1699276</td>
 <td width=25% style="text-align:center;">"A police officer is lifting weights in front of the police station.” seed: 6804745</td>
 <td width=25% style="text-align:center;">"A panda is riding a bicycle in a garden." seed: <s>2178639</s> </td>
 <td width=25% style="text-align:center;">"An alien is riding a bicycle on Mars." seed: 2390886</td>
</tr>
<tr>
<td style="text-align:center;" colspan="2">Riding Horse</td>
<td style="text-align:center;" colspan="2">Riding Horse</td>
</tr>
<tr>
 <td><img src=assets/sports_results/riding_horse/A_knight_riding_on_horseback_passing_by_a_castle_6491893.gif></td>
 <td><img src=assets/sports_results/riding_horse/A_man_riding_an_elephant_through_the_jungle_6230765.gif></td>
 <td><img src=assets/sports_results/riding_horse/A_girl_riding_a_unicorn_galloping_under_the_moonlight_6940542.gif></td>
 <td><img src=assets/sports_results/riding_horse/An_adventurer_riding_a_dinosaur_exploring_through_the_rainforest_6972276.gif></td> 
</tr>
<tr>
 <td width=25% style="text-align:center;">"A knight riding on horseback passing by a castle.” seed: 6491893</td>
 <td width=25% style="text-align:center;">"A man riding an elephant through the jungle.” seed: 6230765</td>
 <td width=25% style="text-align:center;">"A girl riding a unicorn galloping under the moonlight." seed: 6940542</td>
 <td width=25% style="text-align:center;">"An adventurer riding a dinosaur exploring through the rainforest." seed: 6972276</td>
</tr>
<tr>
<td style="text-align:center;" colspan="2">Skateboarding</td>
<td style="text-align:center;" colspan="2">Playing Golf</td>
</tr>
<tr>
 <td><img src=assets/sports_results/skateboarding/A_robot_is_skateboarding_in_a_cyberpunk_city_1020673.gif></td>
 <td><img src=assets/sports_results/skateboarding/A_teddy_bear_skateboarding_in_Times_Square_New_York_3306353.gif></td>
 <td><img src=assets/sports_results/playing_golf/A_man_is_playing_golf_in_front_of_the_White_House_8870450.gif></td> 
 <td><img src=assets/sports_results/playing_golf/A_monkey_is_playing_golf_on_a_field_full_of_flowers_2989633.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;">"A robot is skateboarding in a cyberpunk city.” seed: 1020673</td>
 <td width=25% style="text-align:center;">"A teddy bear skateboarding in Times Square New York.” seed: 3306353</td>
 <td width=25% style="text-align:center;">"A man is playing golf in front of the White House." seed: 8870450</td>
 <td width=25% style="text-align:center;">"A monkey is playing golf on a field full of flowers." seed: 2989633</td>
<tr>
</table>

More sports, to be continued ...

## MotionDirector for Cinematic Shots <a name="MotionDirector_for_Cinematic_Shots"></a>

### 1. Zoom
#### 1.1 Dolly Zoom (Hitchcockian Zoom)
```bash
python MotionDirector_inference.py --model /path/to/the/ZeroScope --prompt "A firefighter standing in front of a burning forest captured with a dolly zoom." --checkpoint_folder ./outputs/train/dolly_zoom/ --checkpoint_index 150 --noise_prior 0.5 --seed 9365597
```
<table class="center">
<tr>
 <td style="text-align:center;">Reference Video</td>
 <td style="text-align:center;" colspan="3">Videos Generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=assets/cinematic_shots_results/dolly_zoom_16.gif></td>
 <td><img src=assets/cinematic_shots_results/A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_dolly_zoom_9365597.gif></td>
 <td><img src=assets/cinematic_shots_results/A_lion_sitting_on_top_of_a_cliff_captured_with_a_dolly_zoom_1675932.gif></td> 
 <td><img src=assets/cinematic_shots_results/A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_dolly_zoom_2310805.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A man standing in room captured with a dolly zoom."</td>
 <td width=25% style="text-align:center;">"A firefighter standing in front of a burning forest captured with a dolly zoom." seed: 9365597 noise_prior: 0.5</td>
 <td width=25% style="text-align:center;">"A lion sitting on top of a cliff captured with a dolly zoom." seed: 1675932 noise_prior: 0.5</td>
 <td width=25% style="text-align:center;">"A Roman soldier standing in front of the Colosseum captured with a dolly zoom." seed: 2310805 noise_prior: 0.5 </td>
</tr>
<tr>
 <td><img src=assets/cinematic_shots_results/dolly_zoom_16.gif></td>
 <td><img src=assets/cinematic_shots_results/A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_dolly_zoom_4615820.gif></td>
 <td><img src=assets/cinematic_shots_results/A_lion_sitting_on_top_of_a_cliff_captured_with_a_dolly_zoom_4114896.gif></td> 
 <td><img src=assets/cinematic_shots_results/A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_dolly_zoom_7492004.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A man standing in room captured with a dolly zoom."</td>
 <td width=25% style="text-align:center;">"A firefighter standing in front of a burning forest captured with a dolly zoom." seed: 4615820 noise_prior: 0.3</td>
 <td width=25% style="text-align:center;">"A lion sitting on top of a cliff captured with a dolly zoom." seed: 4114896 noise_prior: 0.3</td>
 <td width=25% style="text-align:center;">"A Roman soldier standing in front of the Colosseum captured with a dolly zoom." seed: 7492004</td>
</tr>
</table>

#### 1.2 Zoom In
The reference video is shot with my own water cup. You can also pick up your cup or any other object to practice camera movements and turn it into imaginative videos. Create your AI films with customized camera movements!

```bash
python MotionDirector_inference.py --model /path/to/the/ZeroScope --prompt "A firefighter standing in front of a burning forest captured with a zoom in." --checkpoint_folder ./outputs/train/zoom_in/ --checkpoint_index 150 --noise_prior 0.3 --seed 1429227
```
<table class="center">
<tr>
 <td style="text-align:center;">Reference Video</td>
 <td style="text-align:center;" colspan="3">Videos Generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=assets/cinematic_shots_results/zoom_in_16.gif></td>
 <td><img src=assets/cinematic_shots_results/A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_zoom_in_1429227.gif></td>
 <td><img src=assets/cinematic_shots_results/A_lion_sitting_on_top_of_a_cliff_captured_with_a_zoom_in_487239.gif></td> 
 <td><img src=assets/cinematic_shots_results/A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_zoom_in_1393184.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A cup in a lab captured with a zoom in."</td>
 <td width=25% style="text-align:center;">"A firefighter standing in front of a burning forest captured with a zoom in." seed: 1429227</td>
 <td width=25% style="text-align:center;">"A lion sitting on top of a cliff captured with a zoom in." seed: 487239 </td>
 <td width=25% style="text-align:center;">"A Roman soldier standing in front of the Colosseum captured with a zoom in." seed: 1393184</td>
</tr>
</table>

#### 1.3 Zoom Out
```bash
python MotionDirector_inference.py --model /path/to/the/ZeroScope --prompt "A firefighter standing in front of a burning forest captured with a zoom out." --checkpoint_folder ./outputs/train/zoom_out/ --checkpoint_index 150 --noise_prior 0.3 --seed 4971910
```
<table class="center">
<tr>
 <td style="text-align:center;">Reference Video</td>
 <td style="text-align:center;" colspan="3">Videos Generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=assets/cinematic_shots_results/zoom_out_16.gif></td>
 <td><img src=assets/cinematic_shots_results/A_firefighter_standing_in_front_of_a_burning_forest_captured_with_a_zoom_out_4971910.gif></td>
 <td><img src=assets/cinematic_shots_results/A_lion_sitting_on_top_of_a_cliff_captured_with_a_zoom_out_1767994.gif></td> 
 <td><img src=assets/cinematic_shots_results/A_Roman_soldier_standing_in_front_of_the_Colosseum_captured_with_a_zoom_out_8203639.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A cup in a lab captured with a zoom out."</td>
 <td width=25% style="text-align:center;">"A firefighter standing in front of a burning forest captured with a zoom out." seed: 4971910</td>
 <td width=25% style="text-align:center;">"A lion sitting on top of a cliff captured with a zoom out." seed: 1767994 </td>
 <td width=25% style="text-align:center;">"A Roman soldier standing in front of the Colosseum captured with a zoom out." seed: 8203639</td>
</tr>
</table>

### 2. Advanced Cinematic Shots

<table class="center">
<tr>
<td style="text-align:center;" colspan="2">Follow</td>
<td style="text-align:center;" colspan="2">Reverse Follow</td>
</tr>
<tr>
 <td><img src=assets/cinematic_shots_results/more_results/A_fireman_is_walking_through_fire_captured_with_a_follow_cinematic_shot_4926511.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/A_spaceman_is_walking_on_the_moon_with_a_follow_cinematic_shot_7594623.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/A_fireman_is_walking_through_fire_captured_with_a_reverse_follow_cinematic_shot_9759630.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/A_spaceman_walking_on_the_moon_captured_with_a_reverse_follow_cinematic_shot_4539309.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;">"A fireman is walking through fire captured with a follow cinematic shot.” seed: 4926511</td>
 <td width=25% style="text-align:center;">"A spaceman is walking on the moon with a follow cinematic shot.” seed: 7594623</td>
 <td width=25% style="text-align:center;">"A fireman is walking through fire captured with a reverse follow cinematic shot.” seed: 9759630</td>
 <td width=25% style="text-align:center;">"A spaceman walking on the moon captured with a reverse follow cinematic shot." seed: 4539309</td>
</tr>
<tr>
<td style="text-align:center;" colspan="2">Chest Transition</td>
<td style="text-align:center;" colspan="2">Mini Jib Reveal: Foot-to-Head Shot</td>
</tr>
<tr>
 <td><img src=assets/cinematic_shots_results/more_results/A_fireman_is_walking_through_the_burning_forest_captured_with_a_chest_transition_cinematic_shot_5236349.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/An_ancient_Roman_soldier_walks_through_the_crowd_on_the_street_captured_with_a_chest_transition_cinematic_shot_3982271.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/An_ancient_Roman_soldier_walks_through_the_crowd_on_the_street_captured_with_a_mini_jib_reveal_cinematic_shot_654178.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/A_British_Redcoat_soldier_is_walking_through_the_mountains_captured_with_a_mini_jib_reveal_cinematic_shot_566917.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;">"A fireman is walking through the burning forest captured with a chest transition cinematic shot.” seed: 5236349</td>
 <td width=25% style="text-align:center;">"An ancient Roman soldier walks through the crowd on the street captured with a chest transition cinematic shot.” seed: 3982271</td>
 <td width=25% style="text-align:center;">"An ancient Roman soldier walks through the crowd on the street captured with a mini jib reveal cinematic shot.” seed: 654178</td>
 <td width=25% style="text-align:center;">"A British Redcoat soldier is walking through the mountains captured with a mini jib reveal cinematic shot." seed: 566917</td>
</tr>
<tr>
<td style="text-align:center;" colspan="2">Pull Back: Subject Enters form the Left</td>
<td style="text-align:center;" colspan="2">Orbit</td>
</tr>
<tr>
 <td><img src=assets/cinematic_shots_results/more_results/A_robot_looks_at_a_distant_cyberpunk_city_captured_with_a_pull_back_cinematic_shot_9342597.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/A_woman_looks_at_a_distant_erupting_volcano_captured_with_a_pull_back_cinematic_shot_4197508.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/A_fireman_in_the_burning_forest_captured_with_an_orbit_cinematic_shot_8450300.gif></td>
 <td><img src=assets/cinematic_shots_results/more_results/A_spaceman_on_the_moon_captured_with_an_orbit_cinematic_shot_5899496.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;">"A robot looks at a distant cyberpunk city captured with a pull back cinematic shot.” seed: 9342597</td>
 <td width=25% style="text-align:center;">"A woman looks at a distant erupting volcano captured with a pull back cinematic shot.” seed: 4197508</td>
 <td width=25% style="text-align:center;">"A fireman in the burning forest captured with an orbit cinematic shot.” seed: 8450300</td>
 <td width=25% style="text-align:center;">"A spaceman on the moon captured with an orbit cinematic shot." seed: 5899496</td>
</tr>
</table>

More Cinematic Shots, to be continued ....

## MotionDirector for Image Animation <a name="MotionDirector_for_Image_Animation"></a>
### Train
Train the spatial path with reference image.
```bash
python MotionDirector_train.py --config ./configs/config_single_image.yaml
```
Then train the temporal path to learn the motion in reference video.
```bash
python MotionDirector_train.py --config ./configs/config_single_video.yaml
```

### Inference
Inference with spatial path learned from reference image and temporal path learned form reference video.
```bash
python MotionDirector_inference_multi.py --model /path/to/the/foundation/model --prompt "Your prompt" --spatial_path_folder /path/to/the/trained/MotionDirector/spatial/lora/ --temporal_path_folder /path/to/the/trained/MotionDirector/temporal/lora/ --noise_prior 0.
```
### Example
Download the pre-trained weights.
```bash
git clone https://huggingface.co/ruizhaocv/MotionDirector ./outputs
```
Run the following command.
```bash
python MotionDirector_inference_multi.py --model /path/to/the/ZeroScope --prompt "A car is running on the road." --spatial_path_folder ./outputs/train/image_animation/train_2023-12-26T14-37-16/checkpoint-300/spatial/lora/ --temporal_path_folder ./outputs/train/image_animation/train_2023-12-26T13-08-20/checkpoint-300/temporal/lora/ --noise_prior 0.5 --seed 5057764
```
<table class="center">
<tr>
 <td style="text-align:center;">Reference Image</td>
 <td style="text-align:center;">Reference Video</td>
 <td style="text-align:center;" colspan="2">Videos Generated by MotionDirector</td>
</tr>
<tr>
 <td><img src=test_data/img_car/car.jpg></td>
 <td><img src=assets/image_animation_results/car-turn-original.gif></td>
 <td><img src=assets/image_animation_results/A_car_is_running_on_the_road_5057764.gif></td>
 <td><img src=assets/image_animation_results/A_car_is_running_on_the_road_covered_with_snow_4904543.gif></td> 
</tr>
<tr>
 <td width=25% style="text-align:center;color:gray;">"A car is running on the road."</td>
 <td width=25% style="text-align:center;color:gray;">"A car is running on the road."</td>
 <td width=25% style="text-align:center;">"A car is running on the road." seed: 5057764</td>
 <td width=25% style="text-align:center;">"A car is running on the road covered with snow." seed: 4904543</td>
</tr>
</table>

## MotionDirector with Customized Appearance <a name="MotionDirector_with_Customized_Appearance"></a>
### Train
Train the spatial path with reference images.
```bash
python MotionDirector_train.py --config ./configs/config_multi_images.yaml
```
Then train the temporal path to learn the motions in reference videos.
```bash
python MotionDirector_train.py --config ./configs/config_multi_videos.yaml
```

### Inference
Inference with spatial path learned from reference images and temporal path learned form reference videos.
```bash
python MotionDirector_inference_multi.py --model /path/to/the/foundation/model  --prompt "Your prompt" --spatial_path_folder /path/to/the/trained/MotionDirector/spatial/lora/ --temporal_path_folder /path/to/the/trained/MotionDirector/temporal/lora/ --noise_prior 0.
```
### Example
Download the pre-trained weights.
```bash
git clone https://huggingface.co/ruizhaocv/MotionDirector ./outputs
```
Run the following command.
```bash
python MotionDirector_inference_multi.py --model /path/to/the/ZeroScope  --prompt "A Terracotta Warrior is riding a horse through an ancient battlefield." --spatial_path_folder ./outputs/train/customized_appearance/terracotta_warrior/checkpoint-default/spatial/lora --temporal_path_folder ./outputs/train/riding_horse/checkpoint-default/temporal/lora/ --noise_prior 0. --seed 1455028
```
Results are shown in the [table](#customize-both-appearance-and-motion-).

## More results

If you have a more impressive MotionDirector or generated videos, please feel free to open an issue and share them with us. We would greatly appreciate it.
Improvements to the code are also highly welcome.

Please refer to [Project Page](https://showlab.github.io/MotionDirector) for more results.

### Astronaut's daily life on Mars:
<table class="center">
<tr>
 <td style="text-align:center;" colspan="4">Astronaut's daily life on Mars (Motion concepts learned by MotionDirector)</td>
</tr>
<tr>
<td style="text-align:center;">Lifting Weights</td>
<td style="text-align:center;">Playing Golf</td>
<td style="text-align:center;">Riding Horse</td>
<td style="text-align:center;">Riding Bicycle</td>
</tr>
<tr>
 <td><img src=assets/astronaut_mars/An_astronaut_is_lifting_weights_on_Mars_4K_high_quailty_highly_detailed_4008521.gif></td>
 <td><img src=assets/astronaut_mars/Astronaut_playing_golf_on_Mars_659514.gif></td>
 <td><img src=assets/astronaut_mars/An_astronaut_is_riding_a_horse_on_Mars_4K_high_quailty_highly_detailed_1913261.gif></td> 
 <td><img src=assets/astronaut_mars/An_astronaut_is_riding_a_bicycle_past_the_pyramids_Mars_4K_high_quailty_highly_detailed_5532778.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;">"An astronaut is lifting weights on Mars, 4K, high quailty, highly detailed.” seed: 4008521</td>
 <td width=25% style="text-align:center;">"Astronaut playing golf on Mars” seed: 659514</td>
 <td width=25% style="text-align:center;">"An astronaut is riding a horse on Mars, 4K, high quailty, highly detailed." seed: 1913261</td>
 <td width=25% style="text-align:center;">"An astronaut is riding a bicycle past the pyramids Mars, 4K, high quailty, highly detailed." seed: 5532778</td>
</tr>
<tr>
<td style="text-align:center;">Skateboarding</td>
<td style="text-align:center;">Cinematic Shot: "Reverse Follow"</td>
<td style="text-align:center;">Cinematic Shot: "Follow"</td>
<td style="text-align:center;">Cinematic Shot: "Orbit"</td>
</tr>
<tr>
 <td><img src=assets/astronaut_mars/An_astronaut_is_skateboarding_on_Mars_6615212.gif></td>
 <td><img src=assets/astronaut_mars/An_astronaut_is_walking_on_Mars_captured_with_a_reverse_follow_cinematic_shot_1224445.gif></td>
 <td><img src=assets/astronaut_mars/An_astronaut_is_walking_on_Mars_captured_with_a_follow_cinematic_shot_6191674.gif></td> 
 <td><img src=assets/astronaut_mars/An_astronaut_is_standing_on_Mars_captured_with_an_orbit_cinematic_shot_7483453.gif></td>
</tr>
<tr>
 <td width=25% style="text-align:center;">"An astronaut is skateboarding on Mars" seed: 6615212</td>
 <td width=25% style="text-align:center;">"An astronaut is walking on Mars captured with a reverse follow cinematic shot." seed: 1224445</td>
 <td width=25% style="text-align:center;">"An astronaut is walking on Mars captured with a follow cinematic shot." seed: 6191674</td>
 <td width=25% style="text-align:center;">"An astronaut is standing on Mars captured with an orbit cinematic shot." seed: 7483453</td>
<tr>
</table>

## Citation

```bibtex

@article{zhao2023motiondirector,
  title={MotionDirector: Motion Customization of Text-to-Video Diffusion Models},
  author={Zhao, Rui and Gu, Yuchao and Wu, Jay Zhangjie and Zhang, David Junhao and Liu, Jiawei and Wu, Weijia and Keppo, Jussi and Shou, Mike Zheng},
  journal={arXiv preprint arXiv:2310.08465},
  year={2023}
}

```

## Shoutouts

- This code builds on [diffusers](https://github.com/huggingface/diffusers), [Tune-a-video](https://github.com/showlab/Tune-A-Video) and [Text-To-Video-Finetuning](https://github.com/ExponentialML/Text-To-Video-Finetuning). Thanks for open-sourcing!
- Thanks to [camenduru](https://twitter.com/camenduru) for the [colab demo](https://github.com/camenduru/MotionDirector-colab).
- Thanks to [yhyu13](https://github.com/yhyu13) for the [Huggingface Repo](https://huggingface.co/Yhyu13/MotionDirector_LoRA).
- We would like to thank [AK(@_akhaliq)](https://twitter.com/_akhaliq?lang=en) and huggingface team for the help of setting up oneline gradio demo.
- Thanks to [MagicAnimate](https://github.com/magic-research/magic-animate/) for the gradio demo template.
- Thanks to [deepbeepmeep](https://github.com/deepbeepmeep), and [XiaominLi](https://github.com/XiaominLi1997) for improving the code.

MotionDirector

File Explorer

# Installation Guide

2. Python

Today's picks

Was this content helpful?

Recent Feedback

MotionDirector

File Explorer

# Installation Guide

2. Python

Today's picks

Was this content helpful?

Recent Feedback

Download README