Skip to content
Charley3dPublic

About

Lip Sync 2D for free in Blender

Resources

Stars

63 stars

Watchers

3 watching

Forks

Repository files navigation

🗣️ Blender Lip Sync Addon

Official Documentation: https://docs.cgpoly.io

A Blender addon for automatic lip-syncing based on audio input.
Cross-platform (Windows, macOS, Linux), works out of the box with ~25 languages.

⚡ Just install it from Blender’s Add-ons panel and you’re ready to go!

Video Demo

NewShapeKeysFeature.mp4
DemoLipSync-v2-scene-only.mp4

Animated Platformer Character by Quaternius

Wall Art 06 by Jarlan Perez CC-BY via Poly Pizza


✨ Features

  • 🎤 Converts voice audio into animated mouth shapes
  • Interpolates between Shape Key to give natural lips motion
  • 🖼️ Projects a viseme spritesheet onto your character’s face (one spritesheet is shipped with the add-on, but you can use your own)
  • 🧠 Uses offline speech recognition (Vosk + Phonemizer + eSpeak)
  • 🖥️ Fully supported on Windows, macOS and Linux
  • 🔜 Future upgrade: Pose-based animation for facial rigs

📦 Installation

  1. Open Blender.
  2. Go to Edit > Preferences > Get Extensions.
  3. Look for Lip Sync
  4. Install it – done!

When you select a Language Model for the first time, Model file is downloaded and cached for future uses (~40Mo, depending on the language).

🛠️ How to Use (Spritesheet)

  1. Import or create a 3D character.
  2. Add your movie / sound clip in Video Sequencer
  3. Go to the Lip Sync tab in the N-panel.
  4. Select your Language among 30 available languages.
  5. Click Add Spritesheet on Selection
  6. Click Set Mouth Area from Edit Mode
  7. Click Analyze Audio and wait few seconds – your character now speaks!

🚧 Roadmap

  • Sprite-based viseme projection
  • Timeline keyframe baking
  • Shapekey-based viseme support
  • Pose-based animation

🐞 Known Issues

  • Characters require no rotation and applied Scale

🧩 Compatibility

  • Blender 4.4+
  • Works on Windows, macOS, and Linux

🤝 Contribute

Found a bug or want to help improve the addon?
Open an issue or submit a pull request – contributions are welcome!

📜 License

This project is licensed under the GNU General Public License v3.0 or later.


Made with ❤️ by Charley 3D

About

Lip Sync 2D for free in Blender

Resources

Stars

63 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages