Getting started on Windows

1. Click the download button below.
2. If Edge shows a warning, click the … menu next to the file name in the download bar and choose Keep, then Keep anyway.
3. Run the installer. If Windows Defender SmartScreen appears, click More info, then Run anyway.

Getting started on macOS

1. Click the download button below.
2. Open the .dmg file and drag Saguinus into your Applications folder.
3. In Applications, right-click Saguinus and choose Open. Do not double-click it yet.
4. A dialog will warn about an unidentified developer — click Open.
5. If macOS asks for your password, enter it and click Allow.
6. Saguinus is now approved on your Mac. You can open it normally by double-clicking from now on.

Getting started on Linux (AppImage)

1. Click the download button below.
2. Open a terminal in the folder where you saved the file, then make it executable and run it:

   chmod +x Saguinus-X.Y.Z.AppImage
   ./Saguinus-X.Y.Z.AppImage

   Alternatively, right-click the file → Properties → Permissions → tick Allow executing as program, then double-click it.

The AppImage installs nothing system-wide and won't add an entry to your app menu. If you want those, use the .deb package instead.

Getting started on Linux (.deb)

Recommended for Debian, Ubuntu, Linux Mint, Pop!_OS, and other Debian-based systems.

1. Click the download button below.
2. Install the package:

   sudo dpkg -i Saguinus-X.Y.Z.deb

   On Ubuntu, Mint, and similar, you can also double-click the .deb in your file manager to install it directly.
3. Saguinus will appear in your application menu. .md files can be opened with it via right-click → Open With.

To update: download the new .deb and run the same dpkg -i command — it replaces the installed version in place.