Metadata-Version: 2.1
Name: pytoon
Version: 1.0.1
Summary: A Python library for lip-syncing cartoons to voice recordings.
Home-page: https://github.com/lukerbs/apple
Author: Luke Kerbs
License: UNKNOWN
Keywords: animation,forced alignment,lip-sync,audio forced alignment,phoneme,generate subtitles
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

# PyToon
## Overview 
PyToon is a Python based animation library for animating characters and their mouth movements. This tools uses machine learning based audio analysis techiques to automatically lip-sync animated character mouth mouth movements to a given audio recording of someone talking.

[Example Output Video](https://youtu.be/fX2loRnr7II)

## Features
- Automatically create cartoon animated lip-sync videos from just an audio file.
- Programmatically generate videos.

## Getting Started 
1. Clone the repo to your computer
2. Create a virtual environment: `python3 -m venv venv`
3. Activate your virtual environment: `source venv/bin/activate`
4. Install requirements: `pip3 install -r requirements.txt`

## Usage
- For usage example see `test.py` in the root directory of the repository. 
- Basic Usage:

```
from apple.animator import animate

animate(
    audio_file="speech.mp3", # input audio
    txt_file="speech.txt", # audio transcript
    video_path="final.mp4", # output video path
)
```

## Acknowledgements
This project uses character images created by [lazykh](https://github.com/carykh/lazykh).

