Skip to main content

Convert git commit history, to a animated beautiful coding video.

Project description


Converts git commit history, to a beautiful animated coding video.


  1. Install Silicon with brew install silicon or cargo install silicon)
  2. Install FFmpeg
  3. Run pip install videogit


  • Make sure you cd to the root directory containing your git repo. ( You should be able to run git commands like git status )
  • run videogit -l to view a list of your commits
  • pick and copy the hash of your starting commit, if you do not specify final commit hash, videogit will just make the video from your starting hash to the latest commit
  • run videogit <starting_commmit_hash_here> or videogit <starting_commmit_hash_here> <final_commit_hash_here> filling in the starting and ending hashes
  • run videogit -h for a full list of options

Example Usage

  • videogit ba12dc8 -wpm 60 -r 24 -f test.cpp include/test.h

    Creates a 24 fps video from the commit ba12dc8 to the HEAD, at a typing speed of 60 wpm, for files main.y, test.cpp, and include/test.h

  • videogit 5f7198d a06dcff -o output-dir

    Creates a video from commit 5f7198d to commit a06dcff, for all files changed over that period, and outputs the videos to output-dir

Example Videos

All Options

                            -------- VideoGit --------                          

usage: [-h] [-l] [-f FILES [FILES ...]] [-d GIT_REPO_DIRECTORY]
                   [-w WPM] [-r FRAME_RATE] [-o OUTPUT_DIR] [-u UP_DOWN_SPACE]
                   [-m MAX_LINE_LENGTH] [-v]
                   inital_commit [final_commit]

VideoGit by shahanneda ( Converts git commits, to a
beautiful animated video. To get started type videogit -l,

positional arguments:
  inital_commit         the hash of the commit to start the video at
  final_commit          the hash of the commit to end the video at, if not
                        specified will use the HEAD (default: the most recent

optional arguments:
  -h, --help            show this help message and exit
  -l, --list-git-commits
                        list your recent commits and hashes (default: None)
  -f FILES [FILES ...], --files FILES [FILES ...]
                        a list of specific files to make the video, if not set
                        will try to to make the video for all changed files,
                        example: videogit <hash> -f file1.cpp
                        file2.cpp) (default: None)
  -d GIT_REPO_DIRECTORY, --git-repo-directory GIT_REPO_DIRECTORY
                        the repo of your project, only needs to be set if it
                        is diffrent than the current working directory
                        (default: current directory)
  -w WPM, --wpm WPM     the speed of the video in words per minute (default:
  -r FRAME_RATE, --frame-rate FRAME_RATE
                        the framerate of the output video (default: 30)
  -o OUTPUT_DIR, --output-dir OUTPUT_DIR
                        the directory of the output videos (default: current
  -u UP_DOWN_SPACE, --up-down-space UP_DOWN_SPACE
                        how many lines above and below the current editing
                        line to include in the video (default: 20)
  -m MAX_LINE_LENGTH, --max_line_length MAX_LINE_LENGTH
                        the maximum line length in chars before wrapping the
                        text (default: 200)
  -v, --verbose         print any errors or logging information (default:

Project details

Download files

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

Files for VideoGit, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size VideoGit-0.1.0-py3-none-any.whl (10.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size VideoGit-0.1.0.tar.gz (8.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page