Skip to main content

Edit videos with a text editor

Project description


Edit videos with vi or your favorite text editor.


Editing a video or audio file with this tool consists of three steps:

  • Run one command to transcribe the media you want to edit
  • Edit the text transcription file in vi or your favorite text editor
  • Run another command to cut the video

Example commands

To install this package, run:

pip install vivideo

To generate a trascription text file, you can run this command:

vivideo-transcribe -i samples/jfk.wav -t samples/jfk.txt

After you have edited the transcription (we recommend you save it with another name), run something like this:

vivideo-edit -i samples/jfk.wav -t samples/jfk.edited.txt -o samples/jfk.edited.wav --no-greedy

Vi-Video uses FFMpeg as audio and video processing tools. In order to execute the steps above, it is required to have FFMpeg library installed (read more).

You will also need to run pip install vosk to generate the transcriptions.


MVP aligns each word in the desired transcript to its first occurrance in the original transcription. It only looks for matches that occur after the last matched word/timestamp, so transpositions are not allowed.

To make the result seem nicer, it will include a margin before and after each cut, as in auto-editor. If the margin of one cut would overlap with the margin of the following cut, then we don't make a cut.

We will probably want to use something like Damerau–Levenshtein distance to find the best possible alignment between original string (transcription) and desired output string (edited script).

If the desired transcript contains words not in the original (inclusions), we could do overdub or speech synthesis with something like VALL-E.


This is the poor man's version of descript, which allows you to edit a video like it's a text document.

The best open source tool we could find that do something similar to this are auto-editor and videogrep

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vivideo-0.0.1.tar.gz (394.9 kB view hashes)

Uploaded source

Built Distribution

vivideo-0.0.1-py3-none-any.whl (7.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page