GeoDMS on Linux - ObjectVision/GeoDMS GitHub Wiki

GeoDMS runs natively on Linux. Each release has a Linux build, the .l flavour, with both the GUI (GeoDmsGuiQt) and the command-line program GeoDMSRun. It is built and tested on Ubuntu 24.04 (x64). Wine is not needed.

download

The GeoDMS releases page offers two Linux packages per version:

GeoDms<version>.l-linux-x64.deb: a Debian package, for Ubuntu and other Debian-based distributions;
GeoDms<version>.l-linux-x64.tar.gz: a tarball with the same files, for other distributions or for an installation without root rights.

Next to the tarball are a .sha256 checksum and a .sha256.p7s signature. The file VERIFY.md in the tarball explains how to check them.

installing the Debian package

Install the package with apt, so that apt also installs the packages it depends on:

sudo apt install ./GeoDms20.28.0.l-linux-x64.deb

The filename differs per version. The package installs GeoDMS in /opt/ObjectVision/GeoDms<version>.l and adds GeoDMS .l to the applications menu of the desktop. Every version has the same package name, geodms, so installing a newer package replaces the older one. To keep two versions side by side, use the tarball for one of them.

The package depends on a few X11 libraries for the GUI (libxcb-* and libxkbcommon-x11-0) and on python3 with python3-psutil for the supplied command-line utilities. Qt itself is part of the package.

installing the tarball

Extract the tarball in any folder:

tar -xzf GeoDms20.28.0.l-linux-x64.tar.gz

This creates a folder GeoDms<version>.l-linux-x64 with the same tree as the Debian package. The programs are in its subfolder opt/ObjectVision/GeoDms<version>.l, and they run from there; you can also move that subfolder elsewhere. The desktop entry under usr/share/applications points to /opt/ObjectVision/..., so it only works when you copy the tree to /. Install the X11 libraries named above if the GUI does not start.

running GeoDMS

Start the GUI from the applications menu, or with the geodms launcher in the installation folder:

/opt/ObjectVision/GeoDms20.28.0.l/geodms <path>/config.dms

Run a configuration without the GUI with GeoDmsRun:

/opt/ObjectVision/GeoDms20.28.0.l/GeoDmsRun <path>/config.dms <item>

The arguments are the same as on Windows, see Command line options and User Guide GeoDMS RUN. The only difference is that options start with - instead of /, for instance -L<LogFile>.

settings and folders

There is no registry on Linux. GeoDMS keeps the settings of the GUI options dialogs in ~/.config/geodms/geodms.ini (or under $XDG_CONFIG_HOME/geodms when that variable is set).

Without a setting, the LocalData folder is /tmp/geodms/LocalData and the SourceData folder is /tmp/geodms/SourceData. Set your own folders in the Local machine Options dialog; see Folders and Placeholders for what they are used for. Use forward slashes in paths in a configuration, as they work on both systems.

not on Linux

The Linux build does not include the geodms Python extension; see Installation Instructions.