Authentification fails (Windows 10, TextGridLab < 3.1)

Major changes in Windows 10 require a change in the file textgridlab.ini. Find this file in your TextGridLab folder and replace the last line




After a restart of the TextGridLab this change will take effect.

TextGridLab did not start: an error occurred.

Please do not copy the TextGridLab folder to c:\Programs. TextGridLab must be able to write to its folder and if this folder is moved to Programs, Windows will forbid access. Please copy the folder to a location in the user directory and start TextGridLab from there.

Problems extracting the TextGridLab ZIP (Windows XP only)

When trying to extract the TextGridLab ZIP on Windows XP and the target directory has a relatively long overall path, Windows' built-in extractor might fail: The extraction wizard asks for a password, and extracting via drag&drop causes some files to be missing, e.g. textgridlab.exe. There are two alternate solutions:

  • use a better unzip tool, e.g., 7-Zip
  • extract to a shorter path, e.g., C:\TEMP

Advanced Unicode characters not displayed correctly (Windows XP only)

Unicode characters that are beyond the BMP (i.e., codepoints above 0xFFFF, like many musical symbols) are represented using so-called surrogate pairs, i.e. by two consecutive characters from special Unicode blocks. Windows XP does support rendering these characters, but the support is not enabled out of the box. Newer versions of Windows as well as MacOS X and Linux support surrogate pairs out of the box.

To enable support for advanced unicode characters on Windows XP you need to add a key to your registry:

  1. Download the file Unicode-Surrogate-Support.reg
  2. Double-click it and confirm the dialog box
  3. Restart your Windows.



Login dialog incorrectly says you are offline (Ubuntu)

Due to a bug in Ubuntu, the TextGridLab might not be able to establish a secure connection to our servers, resulting in the Login dialog incorrectly telling you you're offline. When this is the case, your Java certificate store is broken, which means Java programs on your system generally cannot establish secure connections – you will see that the keystore (the file /etc/ssl/certs/java/cacerts) on your system is empty (only 32 bytes long). To fix this, open a Terminal window and enter the following two commands:

sudo dpkg --purge --force-depends ca-certificates-java
sudo apt-get install ca-certificates-java

Then quit and re-start the TextGridLab and it will work.

Mac OS

Java version trouble

TextGridLab requires a Java version greater than 6. Unfortunately, Oracle's “regular” MacOS installer for Java 8 seems to install Java in a way such that it can be found only by web browsers. To have third-party applications like TextGridLab to find Java, you will have to install the JDK, the developers' version of Java.

Furthermore it is not possible to run the TextGridLab from within the MacOS X Download folder! Please move the to your application folder and try again.

GUI is not responsible on MacOS X

This only affects TextGridLab 3.2 or older. Please download the latest TextGridLab release from the TextGrid homepage.

Deploy a portable TextGridLab including Java

Sometimes it may be desireable to deploy the TextGridLab in a setting where there is no recent Java installed on the client computers – e.g., in a workshop situation. In this case it is possible to create a TextGridLab installation that includes its own JRE, e.g., on USB drives. To do so, put the JRE in a subdirectory named jre of the TextGridLab. The TextGridLab will automatically use this Java installation.

  • No labels