Install

Downloads and system requirements are on the download page. This page covers what happens after you unpack.

Windows

The Microsoft Store build installs like any Store app and updates itself.

The portable zip installs nothing. Unpack it wherever you like:

HippoDatamus.exe            the desktop application
hippodatamus-cli.exe        the command-line tool
LICENSE.txt
THIRD-PARTY-NOTICES.txt
samples\                    runnable examples

Windows shows a SmartScreen warning the first time you run the portable build - see the note on the download page for why, and how to get past it.

To use the command-line tool from anywhere, add the folder to your PATH.

Linux

tar xzf HippoDatamus-{{ generated.version }}-linux-x64.tar.gz -C ~/hippodatamus
cd ~/hippodatamus
./hippodatamus-cli --version

The tarball preserves the executable bit. If you moved the files some other way and get "permission denied":

chmod +x HippoDatamus hippodatamus-cli

For a menu entry, copy hippodatamus.desktop to ~/.local/share/applications/ and correct the Exec and Icon paths to wherever you unpacked.

Verify it works

hippodatamus-cli --config samples/customers.yaml

That writes samples/customers.csv - 1,000 rows. Because the sample fixes its seed, your file is byte-identical to everyone else's.

Where it keeps things

One preferences file, under your home directory, holding window size and your favourite column types. Nothing else is written outside the folder you chose and the output paths you ask for.

Uninstalling the portable build is deleting the folder.