The 'libs' subfolder contains the necessary libraries for all platforms. Currently supported are:

Windows 32/64 bit

Linux 32/64 bit

OSX 64 bit

Using a proxy server

When the program has started, click on the home menu button on the top left and select "Proxy settings...". In the following dialog you can set the proxy host, port, user name (optional) and password (optional). This is the recommended method for using a proxy server.

Alternatively, you can edit the start script (e.g. Transkribus.bat on Windows, Transkribus.sh on Linux) to include the environment variables for the proxy server:

However, editing this file will be necessary on each update of Transkribus.

Known Issues

Logging in to the Server is not possible via Transkribus, but on the website it works.

Solution: There is a known issue with specific versions of Java 7 (e.g. Java 7u25). You can check your installed version by opening a terminal/command line and entering "java -version". If you encounter this problem, try updating Java on your machine.

Logging in is prevented by the Firewall of your Internet Provider

Some IT departments are blocking the SSL port 443 and/or unknown applications via a firewall. Check with your IT department if that might be the case.

Norton Antivirus detects a threat and is blocking the zip file from being unpacked.

Solution: This is a false alarm which Norton gives when encountering software it is not familiar with (WS.Reputation.1). You should be able to restore the file from quarantine by following the instructions from the following resource [1].

Please click on the "Home" button (upper left corner), then "Install a specific version", select the newest version from "Releases" and tick the box beside "Download complete package".

Afterwards click on "Update" or "Replace". This way, the complete package is downloaded and the update should work.

Wrong JAVA Version on Mac

After opening the command file on the Mac, Transkribus says that there is a wrong Java version installed (1.6.0.65) instead of 1.7. However, there is the most current version of Java RE (1.8.0.66) installed.

The problem is that Java 1.6.0.65 is the default Java on the command line which the Transkribus.command uses. You can check the default version by opening the terminal and typing 'java -version'.

To solve the problem you can either download the latest jdk as a .tar.gz package from here: