This page describes how to run the VHV website on your local computer rather than from Github pages.


Installing jekyll

Follow the instructions for installing Jekyll on the website and/or

Install git

To check if you have git installed, type on the command-line (terminal):

which git

which should reply with something like:


If you are using an MacOS computer and you do not have git, then install Homebrew. If you use Windows, then good luck—although Windows 10 now comes with a that you could try. If you do not have git on a linux/unix operating system, then try typing one of these:

apt-get install git-all
yum install git
dnf install git-all

See for more information.

Also, if you like GUIs, then read this link about

Download the website

After git is installed, you can download the VHV documentation website with the command:

git clone

This will download the website to the directory ./verovio-humdrum-viewer.

Running the website locally

Go into the verovio-humdrum-viewer directory (wherever you have stored it). Then type:


This will compile the website and allow your web browser to access the website from the address

If the serve script fails to run, then most likely you need to type the command the first time:

bundle install
VHV running on local webserver.
VHV running on local webserver.

Running the website offline

If you are not going to have access to the internet when accessing the website (such as working on a plane), then you can run the website in local-only mode by typing:


In order to use this script, you will first have to download the verovio-script.js file by going into the scripts/local directory and typing make in the terminal. This only has to be done once, but you can repeat the download to ensure that you have the most recent version of the verovio-toolkit.js file.