When you install Martus, all the language versions of the user guide and quick start guide that are currently available are installed in your Martus\Docs directory. If you used the Windows installer, links to these documents are also available by going to Start > Programs > Martus. They are also available at https://martus.org/resources/documentation.html, and you can visit this site to see whether new language versions are available.
To display your system specifications in Windows, go to Start > Programs > Accessories > System Tools > System Information.
To display your system specifications in Mac, go to the Apple menu > About this Mac > More info… > System report… > Hardware (this is the Hardware Overview).
Note: Linux does not fully support versions 5.1, 5.0, and 4.5 of Martus (there are several display issues, etc.). If you want to run Martus 5.1 on Linux, you need Java Runtime Environment (JRE) version 1.8.0_40 (sometimes called Java8) and graphic library gtk2 2.18+ (required for supporting JavaFX). For a fully supported version of Martus, download version 4.4 of Martus and refer to the version 4.3 Martus User Guide.
Download the Martus program and any new language packs from www.martus.org. Martus is continually improving; be sure to check for periodic upgrades available on the Martus website.
Make sure that Java 8 is installed so that Martus will run properly. You may already have this or an older version of Java, but if you do not, you can download it at the Oracle website.
Insert the Martus CD into your CD-ROM drive (or download the Martus .iso file from www.martus.org) and double-click it to find the DMG. Follow the DMG instructions above.
Note: If you are using a Martus Language Pack (e.g. Martus-en.mlp), please copy the mlp file to your Martus data folder. For instructions on how to access your Martus data folder, see Why can’t I find my Martus files on my Mac?
Note: Version 5.1 of Martus does not fully support Linux (there are several display issues, etc.). For a fully supported version of Martus, download version 4.4 of Martus and refer to the version 4.3 Martus User Guide.
The following instructions will install Martus within your user account only. No other Linux users on this machine will have access to Martus. If you want to install Martus publicly, so that any user on this computer can run it, please see Frequently Asked Questions. Most of the following must be done from a terminal command prompt.
java -version
Java must be installed and in your PATH for this to work.
You must have (or install) either Oracle’s official Java version 1.8.0_40 (sometimes called Java8). If possible, we recommend using the standard software installation tools from your operating system, such as yum/rpm or apt/deb. If you want to run Oracle's JRE but it is not available that way, you can download it directly from http://java.com/
Note: To run Martus, you only need to install the current version of Java Runtime Environment (JRE), not the larger Java Developer’s Kit (JDK).
mkdir -p < Martus Program Directory>
For example, if you wanted to install the Martus 4.0 into its data directory, you would type:
mkdir -p ~/.Martus
cd < Martus Program Directory>
For example, if you installed Martus into its data directory, you would type:
cd ~/.Martus
Change to the directory you created to install Martus into, extract the zip file contents there, and change to the directory that contains the actual application, by typing the following:
cd < Martus Program Directory>
unzip < Path to Zip File>
cd < Martus Version Directory>
For example, if you wanted to install the Martus 4.5 into its data directory, and the zip file was in ~/Downloads and named MartusClient- 4.5.zip, you would type:
cd ~/.Martus
unzip ~/Downloads/MartusClient- 4.5.zip
java -jar `pwd`/martus.jar
(You do not have to type out the name of the directory you are in, since `pwd` does that for you. )
echo java -jar martus.jar >martus
chmod +x martus
To start Martus in Linux, run a script you’ve created or type:
java -jar < Martus program directory>/martus.jar
By clicking the application we arrive at the sign in screen. Here we can choose a language. To open a new account we will click the link. The Wizard walks users through setting up an account in 6 steps:
This step can be skipped and completed from the open account. For detailed instructions see Sharing and Managing your Contacts. To add contacts in the Wizard:
Note: Key backup is extremely important. See Backing up your Key for more details.
Your account is now complete. For orientation to the main workspace see Getting to know the Martus Workspace or the Quickstart Guide.
The next time you open Martus, input your username and password in the Martus Sign In dialog box to access your account.
The Martus main page is slow to appear.
I'm running Martus, but I can’t find the Martus window. How can I find it?
When creating, editing or viewing a record with an attachment:
If the attachment is an image (e.g. photo or scanned document) of certain file types (i.e. jpg, png, gif), the image will be displayed as a thumbnail and in a View Attachment window. Other types of files will be opened outside of Martus by the program you have set on your computer to open that type of file.
For image attachments with associated geo-location meta-data, select Show on Map to view the location the image was taken on a map.
Note: Using the Show on Map function will bypass embedded Tor if you have it turned on.
When creating, editing or viewing a record with an attachment:
Selecting Save once you have created a record allows you modify the original record at a later time without creating a new version of that record. Once you edit and Save a record, you cannot restore the previous version of the record.
Versioning a record allows you to update information in the record but keep older versions intact, and prevents the earlier versions of the record from being edited. Versions of each record are connected, creating a new copy does not increase the total number of records (e.g., in searches).
Alternately, you can create a copy of a record to use as a starting point for a new record.
You can view any version of a record on your computer. However, you can only make changes to a new version.
Note: If you are allowed to retrieve records from a Contact and you didn’t have access to an earlier version of a Contact’s record, Martus will list the earlier version in the record details, but it won’t retrieve that version of the record to your computer.
To ensure that a record is never permanently deleted from the server, even if it is deleted from your local device, Martus offers the option to - individually or as a default - never delete records from your configured backup server.
Tip: Consider changing the title of the modified version of the record in a way that makes it clear that it contains corrected or additional information. For example, if the original versioned record is titled “Political leaders jailed,” you might title the modified version “Political leaders jailed – updated.”
To discard the information you’ve entered in a record, click Cancel. Martus alerts you that you’ll be deleting any unsaved information in the record, since it was last saved. Click Yes to discard the unsaved information permanently. (If you click Cancel when you’re modifying a record, the record will revert to the state it was in when you opened it).