Getting Started

This document is designed to be a basic introduction to Improviz.

Ideally it should get you up and running and familiar with some of the basic concepts.


If you’re reading this then we’ll assume you have downloaded and un-archived the release for your system.

If you get a white screen appearing in the top-left then things are looking good.

Depending on the system you’re running on, you may get a prompt asking Do you want the application “improviz” to accept incoming network connections? This is because Improviz runs an HTTP service that’s used for communications between the program and the editor, so you need to allow this.

If you don’t get a screen appearing, then please raise an issue on the repository and include any error messages that may have been printed out in the console.


Once Improviz is running, you need to send code for it to run. The simplest way to do this to test is to use the (very basic) built in editor.

Open your browser and go to http://localhost:3000/editor, then try entering the following. Indentation is done using a single tab.

background(255, 0, 0)

fill(0, 255, 255)
10 times
	rotate(time, 3, time)

You should see ten light-blue cubes rotating on a red background, with the black and yellow text in the top left.


The built in editor is fine for quick tests, but it’s much nicer to work with one that’s a bit more friendly.

There are better clients available for Vim and Atom. There is a very basic client available for Emacs.


If you downloaded the release archive, then you should find there’s a documentation folder with a number of files in it. This should cover everything you need to get going.

You can also find the same documents available on the Improviz website.