Chapter 5. Troubleshooting and maintenance

5.1. Installing Fanurio

5.1.1. Requirements

Fanurio runs on Windows (including Windows 10), Mac OS X (10.5 or later, including Mojave), Linux (including Debian-based distributions like Ubuntu) and other flavors of Unix.

Ubuntu (.deb installer)

Ubuntu comes installed with its own OpenJDK build but we recommend using Azul's Zulu OpenJDK version 8 instead. Follow these steps to install it after you open a Terminal window:

  1. Download the tar.gz file for Linux from Azul.

    This guide assumes the file is called zulu8.36.0.1-ca-jdk8.0.202-linux_x64.tar.gz but depending on which version you download, it may have a different name.


  2. Untar and copy it to /usr/lib/jvm/ where Java is installed.

    sudo tar -zxvf zulu8.36.0.1-ca-jdk8.0.202-linux_x64.tar.gz -C /usr/lib/jvm/

  3. Add the new Java installation to the Java alternative list.

    sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/zulu8.36.0.1-ca-jdk8.0.202-linux_x64/jre/bin/java 1

  4. Make the new Java installation the default one. Run the following command and choose the option that points to the new Java installation.

    sudo update-alternatives --config java

  5. Test it.

    java -version

5.1.2. Registering a license key

Here's what you need to do to register a license key:

  1. Save the license file you received by email (license.dat) on your Desktop.

    IMPORTANT: Don't try to open the license file as there is nothing meaningful there. Just save it on your computer. Fanurio knows how to read its contents.

  2. Make sure Fanurio is running. If it isn't, start it.

  3. If it asks you for a valid license file, click the Enter License button at the bottom. If it doesn't, go to Help » Enter License... to enter it. Once you click Enter License..., Fanurio will display the License Registration dialog.

  4. Click the Browse button to locate the license file on your Desktop.

  5. Enter the email address where you received the license file in the Email field.

  6. Click OK to register the license key.

5.1.3. The cross-platform version

The cross-platform version requires Java 6 or higher. If Java is not installed on your computer, you can download the latest version from

To install and run Fanurio from a USB stick, please follow these instructions:

  1. Get the cross-platform version (.tar.gz)

  2. Install it on the USB stick by unzipping it

  3. Start Fanurio from the stick by running:

    • fanuriolocal.applescript on Mac OS X

    • fanuriolocal.exe on Windows

    • on Linux and other flavors of Unix

Note: It's important to start Fanurio using the local scripts. The other scripts (without local in their name) will start Fanurio but will not keep the data on the stick.

5.1.4. Uninstalling Fanurio

Please follow these steps to uninstall Fanurio from your computer. If you've had problems using it, we would appreciate it if you could tell us more about it.

  • Mac OS X

    In the Finder sidebar, click Applications. Drag the app from the Applications folder to the Trash (located at the end of the Dock), then choose Finder > Empty Trash.

    If you change your mind, before emptying the Trash, select the app in the Trash, then choose File > Put Back.

    Learn more

  • Linux

    If you're using Ubuntu, open Ubuntu Software Center and search for fanurio. Then click the Remove button.

    On other Debian-based distributions, open a Terminal window and run the following command:

    sudo apt-get remove fanurio

    Learn more

  • Windows 10

    1. Open the Start menu.

    2. Click Settings.

    3. Click System on the Settings menu.

    4. Select Apps & features from the left pane.

    5. Select an app you wish to uninstall.

    6. Click the Uninstall button that appears. If it is grayed out, this is a system app you cannot remove.

    7. Click the Uninstall pop-up button to confirm.

    Learn more

  • Windows 8.1

    1. Point to the upper-right corner of the screen, move the mouse pointer down, and then click Search.

    2. Enter control panel in the search box, and then click Control Panel.

    3. Under View by:, select Large Icons, and then click Programs and features.

    4. Click the program, and then click Uninstall.

    5. Follow the instructions on the screen.

    Learn more

  • Windows 7 and Vista

    1. Open Programs and Features by clicking the Start button, clicking Control Panel, clicking Programs, and then clicking Programs and Features.

    2. Select a program, and then click Uninstall.

    Learn more

  • Windows XP

    1. Click Start, click Control Panel, and then double-click Add or Remove Programs.

    2. In the Currently installed programs box, click the program that you want to remove, and then click Remove.

    3. If you are prompted to confirm the removal of the program, click Yes.

    Learn more

  • Cross-platform

    Delete the fanurio folder. Please make sure you backup all data from the local subfolder first.