rhubarb-lip-sync/rhubarb-for-vegas
Daniel Wolf 7c49f76efe Use Gradle conventions through base plugin 2019-08-03 22:31:06 +02:00
..
.gitignore Restructure files and migrate to Gradle-based build 2019-08-03 22:17:02 +02:00
Debug Rhubarb.cs Restructure files and migrate to Gradle-based build 2019-08-03 22:17:02 +02:00
Debug Rhubarb.cs.config Restructure files and migrate to Gradle-based build 2019-08-03 22:17:02 +02:00
Import Rhubarb.cs Restructure files and migrate to Gradle-based build 2019-08-03 22:17:02 +02:00
Import Rhubarb.cs.config Restructure files and migrate to Gradle-based build 2019-08-03 22:17:02 +02:00
README.adoc Restructure files and migrate to Gradle-based build 2019-08-03 22:17:02 +02:00
build.gradle.kts Use Gradle conventions through base plugin 2019-08-03 22:31:06 +02:00

README.adoc

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

= Scripts for Magix Vegas

If you own a copy of http://www.vegascreativesoftware.com/[Magix Vegas] (previously Sony Vegas), you can use this script to visualize Rhubarb Lip Syncs output on the timeline. This can be useful for creating lip-synced videos or for debugging.

== Installation

Copy (or symlink) the files in this directory to `<Vegas installation directory>\Script Menu`. When you restart Vegas, youll find two new menu items:

* _Tools > Scripting > Import Rhubarb:_ This will create a new Vegas project and add two tracks: a video track with a visualization of Rhubarb Lip Syncs output and an audio track with the original recording.
* _Tools > Scripting > Debug Rhubarb:_ This will create markers or regions on the timeline visualizing Rhubarb Lip Syncs internal data from a log file. You can obtain a log file by redirecting `+stdout+`. Ive written this script mainly as a debugging aid for myself; feel free to contact me if youre interested and need a more thorough explanation.

== How to perform lip sync

You cannot perform lip sync directly from the Vegas scripts. Instead, run Rhubarb Lip Sync from the command line, specifying the XML output format.

== How to create an animation

Select _Tools > Scripting > Import Rhubarb_. Fill in at least the following fields:

* One image file: You need a set of image files, one for each mouth shapes. All image files should have the same size and should end with "`-<mouth shape>`", for instance _alison-a.png_, _alison-b.png_, and so on. Click the "`...`" button at the right of this field and select one of these image files. The script will automatically find the other image files.
* XML file: Click the "`...`" button at the right of this field and select the XML file created by Rhubarb Lip Sync.

Click _OK_ to create the animation.