Getting Started - zward/Amua GitHub Wiki

Getting started is easy!

Follow the steps below to download and open Amua. There are also some online tutorials to help get you started.

  • Make sure Java is installed on your computer (1.8 or later). (It probably already is.)
  • Download Amua (latest release: 0.3.4). Copy the jar to a directory where you can easily find it.

Windows

  • Double-click on the jar to start the program.

Mac

  • Double-click on the jar. You will probably get a message that says: "Amua.jar can't be opened because it is from an unidentified developer". Go to: System Preferences -> Security & Privacy, and click Open Anyway.

You have a couple options to start the program on a Mac:

  1. Just double-click on the jar. This will start the program, but you will get the Java icon in the dock.
  2. If you want the Amua icon to show up in the dock (some people care about these things), do the following:
  • Get the icon and put it in the same directory as Amua.jar
  • Create a launch script:
    • Open TextEdit and create a new file in the same directory as the jar
    • Convert it to plain text by clicking Format > Make Plain Text.
    • Enter the following lines:
#!/bin/sh
cd `dirname $0`
java -Xdock:name=Amua -Xdock:icon=logo_48.png -jar Amua_0.3.4.jar

  • Save it as 'LaunchAmua.command'

  • Next you need to set 'execute' on the launch script. Go to the terminal and navigate to the directory with the command file. Enter chmod u+x LaunchAmua.command

  • Now you can double-click "LaunchAmua.command" to start the program. You should see the Amua icon in the dock now. (Note: The dock application name still says 'java' for some versions of Mac OS)