Installing / Starting

The application as well as the present User Manual can be downloaded from the ArchEthno website.

Currently, the dictionary editor can be used on most 64bits Linux, Microsoft Windows 10/11 64bits and MacOS 10.10.5 and higher platforms.

Once downloaded, the zip file containing the application has to be extracted on the machine where it will be used on to ensure that the software is executable.

On Windows systems, the native unzipping method may encounter issues when unzipping. You may want to use third-party application to avoid issues. The unzip has been successfully tested with the 7Zip application.

Linux

Depending on your precise Linux distribution, double-clicking on the DictionaryEditor.sh file may launch the application correctly (see below for more details on Gnome environments).

To start the application, it is also possible to open a terminal and just execute ./DictionaryEditor.sh in the application directory.

On recent Linux distributions with Gnome, double-clicking on the DictionaryEditor.sh file displays the content of the file instead of launching it. You may modify this behavior by going to the file manager preferences and changing the way executable files are handled. On newer Gnome environments, you can only do Right-click  Run as program.

MacOS

To start the application, there are two possibilities:

  • Use the Terminal application: go to the application folder and execute the DictionaryEditor.sh file.

  • Launch without terminal:

    • right-click on the DictionaryEditor.sh file and select Open with  Others…​

    • in the window, in the lower part, in Activate, select All the applications and check the Always open with checkbox

    • select the "Terminal" application (usually found in the "Utility" folder)

    • the system may show a warning that the developer could not be identified, select the "Open" button

Anti-malware bypass

On newer macOS systems, the system anti-malware security may block the launching of the application. Showing messages such as "cannot verify the origin of 'java' program" with options to delete program or cancel operation.

Before following the instructions below, try to manually open once the Java execution environment. To do so, proceed to the dependencies/thirdparty/jre-21/bin folder and right-click on the java program and select Open. If no error pop-up appears and the terminal opens briefly, it means the opening was successful, you can now proceed with normal launch of the application. Otherwise, please follow the instructions below.

In this case, please follow these instructions for the first launch of the application:

  • Before trying to launch the application, please deactivate temporarily the anti-malware

    • Open the "Terminal" application

    • Enter the following command sudo spctl --master-disable

    • Your password is requested (beware the entered characters are hidden as a security measure)

  • Try to manually open the Java execution environment as explained above.

  • Now follow the instructions above to launch the application.

  • Then, once the application has opened successfully, re-activate the anti-malware protection:

    • In the terminal window, type the command sudo spctl --master-enable

    • Your password may be requested again

Windows

Double-clinking on the DictionaryEditor.bat will launch the application.

You can also open a command invite, go to the application folder and type DictionaryEditor.bat.