able to run facewrap.exe in ubuntu using wine

README.md

@@ -4,28 +4,28 @@ This is the code repository implementing the paper:
 
 > **MakeItTalk: Speaker-Aware Talking-Head Animation**
 >
-> [Yang Zhou](https://people.umass.edu/~yangzhou), 
-> [Xintong Han](http://users.umiacs.umd.edu/~xintong/), 
-> [Eli Shechtman](https://research.adobe.com/person/eli-shechtman), 
-> [Jose Echevarria](http://www.jiechevarria.com) , 
-> [Evangelos Kalogerakis](https://people.cs.umass.edu/~kalo/), 
+> [Yang Zhou](https://people.umass.edu/~yangzhou),
+> [Xintong Han](http://users.umiacs.umd.edu/~xintong/),
+> [Eli Shechtman](https://research.adobe.com/person/eli-shechtman),
+> [Jose Echevarria](http://www.jiechevarria.com) ,
+> [Evangelos Kalogerakis](https://people.cs.umass.edu/~kalo/),
 > [Dingzeyu Li](https://dingzeyu.li)
 >
 > SIGGRAPH Asia 2020
 >
-> **Abstract** We present a method that generates expressive talking-head videos from a single facial image with audio as the only input. In contrast to previous attempts to learn direct mappings from audio to raw pixels for creating talking faces, our method first disentangles the content and speaker information in the input audio signal. The audio content robustly controls the motion of lips and nearby facial regions, while the speaker information determines the specifics of facial expressions and the rest of the talking-head dynamics. Another key component of our method is the prediction of facial landmarks reflecting the speaker-aware dynamics. Based on this intermediate representation, our method works with many portrait images in a single unified framework, including artistic paintings, sketches, 2D cartoon characters,  Japanese mangas, and stylized caricatures.
-In addition, our method generalizes well for faces and characters that were not observed during training. We present extensive quantitative and qualitative evaluation of our method, in addition to user studies, demonstrating generated talking-heads of significantly higher quality compared to prior state-of-the-art methods.
+> **Abstract** We present a method that generates expressive talking-head videos from a single facial image with audio as the only input. In contrast to previous attempts to learn direct mappings from audio to raw pixels for creating talking faces, our method first disentangles the content and speaker information in the input audio signal. The audio content robustly controls the motion of lips and nearby facial regions, while the speaker information determines the specifics of facial expressions and the rest of the talking-head dynamics. Another key component of our method is the prediction of facial landmarks reflecting the speaker-aware dynamics. Based on this intermediate representation, our method works with many portrait images in a single unified framework, including artistic paintings, sketches, 2D cartoon characters, Japanese mangas, and stylized caricatures.
+> In addition, our method generalizes well for faces and characters that were not observed during training. We present extensive quantitative and qualitative evaluation of our method, in addition to user studies, demonstrating generated talking-heads of significantly higher quality compared to prior state-of-the-art methods.
 >
-> [[Project page]](https://people.umass.edu/~yangzhou/MakeItTalk/) 
-> [[Paper]](https://people.umass.edu/~yangzhou/MakeItTalk/MakeItTalk_SIGGRAPH_Asia_Final_round-5.pdf) 
-> [[Video]](https://www.youtube.com/watch?v=OU6Ctzhpc6s) 
+> [[Project page]](https://people.umass.edu/~yangzhou/MakeItTalk/)
+> [[Paper]](https://people.umass.edu/~yangzhou/MakeItTalk/MakeItTalk_SIGGRAPH_Asia_Final_round-5.pdf)
+> [[Video]](https://www.youtube.com/watch?v=OU6Ctzhpc6s)
 > [[Arxiv]](https://arxiv.org/abs/2004.12992)
 > [[Colab Demo]](quick_demo.ipynb)
 > [[Colab Demo TDLR]](quick_demo_tdlr.ipynb)
 
 ![img](doc/teaser.png)
 
-Figure. Given an audio speech signal and a single portrait image   as input (left), our model generates speaker-aware talking-head animations (right). 
+Figure. Given an audio speech signal and a single portrait image as input (left), our model generates speaker-aware talking-head animations (right).
 Both the speech signal and the input face image are not observed during the model training process.
 Our method creates both non-photorealistic cartoon animations (top) and natural human face videos (bottom).
 
@@ -37,16 +37,28 @@ Our method creates both non-photorealistic cartoon animations (top) and natural
 - [ ] Customized puppet creating tool
 
 ## Requirements
+
 - Python environment 3.6
+
 ```
 conda create -n makeittalk_env python=3.6
 conda activate makeittalk_env
 ```
+
 - ffmpeg (https://ffmpeg.org/download.html)
+
 ```
 sudo apt-get install ffmpeg
 ```
+
+- For ubuntu user
+
+```
+sudo apt-get install wine-stable
+```
+
 - python packages
+
 ```
 pip install -r requirements.txt
 ```
@@ -55,74 +67,75 @@ pip install -r requirements.txt
 
 Download the following pre-trained models to `examples/ckpt` folder for testing your own animation.
 
-| Model |  Link to the model | 
-| :-------------: | :---------------: |
-| Voice Conversion  | [Link](https://drive.google.com/file/d/1ZiwPp_h62LtjU0DwpelLUoodKPR85K7x/view?usp=sharing)  |
-| Speech Content Module  | [Link](https://drive.google.com/file/d/1r3bfEvTVl6pCNw5xwUhEglwDHjWtAqQp/view?usp=sharing)  |
-| Speaker-aware Module  | [Link](https://drive.google.com/file/d/1rV0jkyDqPW-aDJcj7xSO6Zt1zSXqn1mu/view?usp=sharing)  |
-| Image2Image Translation Module  | [Link](https://drive.google.com/file/d/1i2LJXKp-yWKIEEgJ7C6cE3_2NirfY_0a/view?usp=sharing)  |
-| Non-photorealistic Warping (.exe)  | [Link](https://drive.google.com/file/d/1rlj0PAUMdX8TLuywsn6ds_G6L63nAu0P/view?usp=sharing)  |
+|               Model               |                                     Link to the model                                      |
+| :-------------------------------: | :----------------------------------------------------------------------------------------: |
+|         Voice Conversion          | [Link](https://drive.google.com/file/d/1ZiwPp_h62LtjU0DwpelLUoodKPR85K7x/view?usp=sharing) |
+|       Speech Content Module       | [Link](https://drive.google.com/file/d/1r3bfEvTVl6pCNw5xwUhEglwDHjWtAqQp/view?usp=sharing) |
+|       Speaker-aware Module        | [Link](https://drive.google.com/file/d/1rV0jkyDqPW-aDJcj7xSO6Zt1zSXqn1mu/view?usp=sharing) |
+|  Image2Image Translation Module   | [Link](https://drive.google.com/file/d/1i2LJXKp-yWKIEEgJ7C6cE3_2NirfY_0a/view?usp=sharing) |
+| Non-photorealistic Warping (.exe) | [Link](https://drive.google.com/file/d/1rlj0PAUMdX8TLuywsn6ds_G6L63nAu0P/view?usp=sharing) |
 
 ## Animate You Portraits!
 
 - Download pre-trained embedding [[here]](https://drive.google.com/file/d/18-0CYl5E6ungS3H4rRSHjfYvvm-WwjTI/view?usp=sharing) and save to `examples/dump` folder.
 
 ### _Nature Human Faces / Paintings_
 
-- crop your portrait image into size `256x256` and put it under `examples` folder with `.jpg` format. 
-Make sure the head is almost in the middle (check existing examples for a reference).
+- crop your portrait image into size `256x256` and put it under `examples` folder with `.jpg` format.
+  Make sure the head is almost in the middle (check existing examples for a reference).
 
 - put test audio files under `examples` folder as well with `.wav` format.
 
 - animate!
 
 ```
-python main_end2end.py --jpg <portrait_file>  
+python main_end2end.py --jpg <portrait_file>
 ```
 
-- use addition args `--amp_lip_x <x> --amp_lip_y <y> --amp_pos <pos>` 
-to amply lip motion (in x/y-axis direction) and head motion displacements, default values are `<x>=2., <y>=2., <pos>=.5`
-
+- use addition args `--amp_lip_x <x> --amp_lip_y <y> --amp_pos <pos>`
+  to amply lip motion (in x/y-axis direction) and head motion displacements, default values are `<x>=2., <y>=2., <pos>=.5`
 
-
-### _Cartoon Faces_ 
+### _Cartoon Faces_
 
 - put test audio files under `examples` folder as well with `.wav` format.
 
 - animate one of the existing puppets
 
-| Puppet Name |  wilk | roy | sketch | color | cartoonM | danbooru1 | 
-| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
-| Image  | ![img](examples_cartoon/wilk_fullbody.jpg)  | ![img](examples_cartoon/roy_full.png)  | ![img](examples_cartoon/sketch.png)  | ![img](examples_cartoon/color.jpg)  | ![img](examples_cartoon/cartoonM.png)  | ![img](examples_cartoon/danbooru1.jpg)  |
+| Puppet Name |                    wilk                    |                  roy                  |               sketch                |               color                |               cartoonM                |               danbooru1                |
+| :---------: | :----------------------------------------: | :-----------------------------------: | :---------------------------------: | :--------------------------------: | :-----------------------------------: | :------------------------------------: |
+|    Image    | ![img](examples_cartoon/wilk_fullbody.jpg) | ![img](examples_cartoon/roy_full.png) | ![img](examples_cartoon/sketch.png) | ![img](examples_cartoon/color.jpg) | ![img](examples_cartoon/cartoonM.png) | ![img](examples_cartoon/danbooru1.jpg) |
 
 ```
 python main_end2end_cartoon.py --jpg <cartoon_puppet_name_with_extension> --jpg_bg <puppet_background_with_extension>
 ```
 
 - `--jpg_bg` takes a same-size image as the background image to create the animation, such as the puppet's body, the overall fixed background image. If you want to use the background, make sure the puppet face image (i.e. `--jpg` image) is in `png` format and is transparent on the non-face area. If you don't need any background, please also create a same-size image (e.g. a pure white image) to hold the argument place.
 
-- use addition args `--amp_lip_x <x> --amp_lip_y <y> --amp_pos <pos>` 
-to amply lip motion (in x/y-axis direction) and head motion displacements, default values are `<x>=2., <y>=2., <pos>=.5`
+- use addition args `--amp_lip_x <x> --amp_lip_y <y> --amp_pos <pos>`
+  to amply lip motion (in x/y-axis direction) and head motion displacements, default values are `<x>=2., <y>=2., <pos>=.5`
 
 - create your own puppets (ToDo...)
 
 ## Train
 
 ### Train Voice Conversion Module
+
 Todo...
 
 ### Train Content Branch
+
 - Create dataset root directory `<root_dir>`
 
 - Dataset: Download preprocessed dataset [[here]](https://drive.google.com/drive/folders/1EwuAy3j1b9Zc1MsidUfxG_pJGc_cV60O?usp=sharing), and put it under `<root_dir>/dump`.
 
 - Train script: Run script below. Models will be saved in `<root_dir>/ckpt/<train_instance_name>`.
 
-    ```shell script
-    python main_train_content.py --train --write --root_dir <root_dir> --name <train_instance_name>
-    ```
-  
+  ```shell script
+  python main_train_content.py --train --write --root_dir <root_dir> --name <train_instance_name>
+  ```
+
 ### Train Speaker-Aware Branch
+
 Todo...
 
 ### Train Image-to-Image Translation
@@ -134,13 +147,12 @@ Todo...
 ## Acknowledgement
 
 We would like to thank Timothy Langlois for the narration, and
-[Kaizhi Qian](https://scholar.google.com/citations?user=uEpr4C4AAAAJ&hl=en) 
+[Kaizhi Qian](https://scholar.google.com/citations?user=uEpr4C4AAAAJ&hl=en)
 for the help with the [voice conversion module](https://auspicious3000.github.io/icassp-2020-demo/). We
 thank Daichi Ito for sharing the caricature image and Dave Werner
-for Wilk, the gruff but ultimately lovable puppet. 
+for Wilk, the gruff but ultimately lovable puppet.
 
 This research is partially funded by NSF (EAGER-1942069)
 and a gift from Adobe. Our experiments were performed in the
 UMass GPU cluster obtained under the Collaborative Fund managed
 by the MassTech Collaborative.
-