Digital Lith Tutorial - Install and First Run


Welcome to a series of posts about digital lith. This is in addition to the documentation you can find on the digital lith page: Click!

This is the first episode and we are going to start with the installation of the program and the first steps. There will be more post dealing with all aspects of the program.

To install digital lith you first need to make sure that there is an actual Java runtime environment installed on your computer. You can download and install it from here: Java Runtime

Note: There is already one install option for Mac OS X which has the Java runtime bundled. This means a way bigger download, but in case you do not have Java installed you would anyway download Java. So in this case this would be the most comfortable solution for you.

Since there are many people who want to avoid Java running in their browser: The Java Runtime you install is not meant to run in your browser at all. It is an environment that will execute the digital lith program on your local machine. If you do not want to have Java on your computer you will not be able to run digital lith.

Now once Java is installed on your machine go to the digital lith page and download the program. Use the version most suitable to your operating system. You will be able to run the generic unix version on any operating system, but if you are on Windows or Mac OS X it is just more convenient to install the packages meant for these OS.

For Windows and Mac OS just unpack the zip file (if your browser is not doing it automatically anyway) which will leave you with a single executable which you can put wherever appropriate. On a Mac just move it into the Applications folder.

On Unix things are a little bit more complicated. Here you have to unpack the archive where you want the program to reside. This will create a directory digilith which contains all the bits needed. To run the program, open a Terminal window, set the JAVA_HOME environment variable to point to your Java installation and the DIGITAL_LITH_HOME environment variable to point to the digilith directory created when unpacking the archive. To start the program run $DIGITAL_LITH_HOME/

In case you are running the Gnome desktop, best would be to install the program into /usr/local/digilith and then add the file /usr/local/digilith/DigitalLithProcessing.desktop to your Gnome Launch Bar to run the program with a simple mouse click.

Now that you managed the stormy waters of installing the program let us start the program and do some basic setup of preferences.

After clicking the program icon or running the program from a Terminal window what you are going to see is something like this:

Digital Lith on First Run

We do not care about all these elements you see in this window for now but do some basic setup of preferences. How that is done is described in the next post about Preferences: Click!