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.

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

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 user-level CLI tool (no manual virtualenv 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.