DataWarrior User Manual

Program Installation


Installing DataWarrior

DataWarrior installers are available for Linux, Macintosh and Windows. DataWarrior was written in Java and its complete source code is published under the GNU Public License. Installers for the three platforms, and the source code can be downloaded from www.openmolecules.org. The DataWarrior installation contains various example files and a complete user manual, which is accessible from within the application. In addition to the embedded documentation the user manual is also accessible online at www.openmolecules.org.

To install DataWarrior on Windows you need a working Java Runtime environment to be installed. If this is not the case, please download and install Java from the java.com website. Depending on the Java architecture (32- or 64-bit) you need to download the matching DataWarrior installer. The DataWarrior downlod page explains, how you can check, which Java architecture you have installed. To install DataWarrior itself just double click the downloaded datawarrior.msi file and follow the instructions. Anytime later you may traceless uninstall the program using the Control Panel.

To install DataWarrior on the Macintosh just double click the downloaded datawarrior.dmg file and drag the DataWarrior application icon onto the Application folder. In the unlikely case you want to de-install the software later, just drag the DataWarrior folder from the application folder into the trash.

To install DataWarrior on Linux unpack the downloaded datawarrior.tar.gz file to any location and run the install script with root privileges. To later uninstall DataWarrior you may run /opt/uninstall with root privileges.



Updating DataWarrior

In order to update an existing DataWarrior installation to a newer version, we recommend to uninstall the previous version as described above and then to install the new version. If you have saved or modified any files in the DataWarrior installation directory or any of its subfolders (e.g. 'reference', 'example', or the 'macro' folder), then you should copy these files to a safe place before uninstalling the outdated DataWarrior version.


Look & Feel

When DataWarrior launches for the first time, it uses the Graphite Look & Feel, which means that all user interface elements and the background are drawn in a dark grayish tone. This emphasises in particular color-rich views. Since aesthetic perception depends on the individuum, the Help menu allows to choose from a couple of different Look & Feels. The chosen Look & Feels is stored as part of DataWarrior's settings.

Three different Look & Feels on a Macintosh


Hi-Resolution Monitors

During recent years computer and monitor manufacturers have introduced monitors with substantially higher resolutions than what was common before. DataWarrior supports these monitors on all three platforms, but in a slightly different way, because high resolution monitors are handled differently on different operating systems. In general user interface elements as buttons, combo boxes and menu items are enlarged to make up for the smaller pixel size. Therefore, everything looks much sharper.

On Windows the enlargement factor can be defined for all applications in the in the Display Control Panel under Appearance and Personalization. Under some versions of Windows it is also necessary to disable DPI virtualization for the DataWarrior application. To do so, right-click the name of the DataWarrior executable file, click Properties, click the Compatibility tab, and then select the box labeled Disable display scaling on high DPI settings.

On Retina displays of the Macintosh this factor is predefined as 2.0. And on Linux it depends on the Linux dialect. Usually the scaling factor can be defined in the display settings dialog. On Ubuntu the relevant slider is called Scale for menu and title bars, which is recognized by DataWarrior. For Linux dialects without that setting, or if DataWarrior does not automatically recognize the setting, one may add an 'dpifactor' parameter to the script that launches DataWarrior ('/opt/datawarrior/datawarrior'). For instance to increase all user interface elements by 50% insert a dpifactor of 1.5 into the second line after the -X options. It looks then like:
java -Xms1000m -Xmx4000m -Ddpifactor=1.5 -Ddatapath=...