Installation

Downloads can be found on GitHub Releases. Platform-specific installation instructions are below:

Warning

These packages and installers have not yet been thoroughly tested on all platforms. Please create a bug report if you encounter any installation issues!

A DEB package is available for Debian, Ubuntu, and derivatives. Download naturtag.deb and run:

sudo dpkg -i naturtag.deb

An RPM package is available for Fedora, RHEL, and derivatives. Download naturtag.rpm and run:

sudo rpm -i naturtag.rpm

A pacman package is available for Arch Linux and derivatives. Download naturtag.pkg.tar.zst and run:

sudo pacman -U naturtag.pkg.tar.zst

For other Linux distributions, a portable AppImage is available. Download naturtag.AppImage and run:

chmod +x naturtag.AppImage
./naturtag.AppImage

Download naturtag.dmg, double-click the file, and drag to Applications to install.

If you see a Gatekeeper message “naturtag is damaged and can’t be opened”, run the following command to remove the quarantine flag:

xattr -dr com.apple.quarantine /Applications/naturtag.app

This is required because the app is not signed with a ($100/yr) Apple Developer ID certificate.

A Windows installer is available here: naturtag-installer.exe

If you see a Microsoft Defender message “SmartScreen prevented an unrecognized app from starting…”, click More info > Run anyway. This is required because the app is not signed with a (paid) code signing certificate.

Python package

You can also use naturtag as a plain python library, if you prefer:

  • First, install python 3.13 if you don’t have it yet.

  • It’s recommended to install into a virtual environment.

  • Install with pip:

    pip install naturtag

  • Or use uv to install as a CLI tool (no manual python installation or virtualenv setup required):

    uv tool install naturtag

Warning

The PyPI package is suitable for using the library and CLI; for the desktop application, it is highly recommended to use one of the platform-specific builds above.