face_track/README.md

34 lines
1.1 KiB
Markdown

# Face Track
A very simple Python script that uses a not-at-all simple Python library to generate animated face meshes from video files.
Basic usage:
```bash
$ face_track.py path/to/video_file.mp4 path/to/output.mdd
```
This will create `output.mdd`, a Newtek MDD file. This file contains animated vertex data, which can be used to animate the face mesh in `face_mesh.obj` or `face_mesh.blend`. For example, by using the Mesh Cache modifier in Blender.
## Requirements
face_track.py requires the following:
- [Python 3](https://www.python.org)
- [Numpy](https://numpy.org)
- [OpenCV](https://opencv.org) and its Python bindings
- [Mediapipe](https://mediapipe.dev) and its Python bindings
## Support
This project is a quick hack held together by ducttape and glue, and is 100% unsupported. Issue reports and contributions are welcome, but we make no promises they will be acted upon.
If you would like to further develop this, we recommend forking it into a new project.
## License
All files in this project are licensed under [CC0](https://creativecommons.org/publicdomain/zero/1.0/). Please see LICENSE.md for details.