Installation

Download the appropriate package from the download page.

Download for your operating system

From 0.16.0 there is one download per system, always including STEP preview. The file name has no -STEP suffix. The package is larger than the former standard variant. If you use that variant, you receive the new package with your next in-app update.

Platform	Download
Windows	3MF-Katalog-Manager-0.16.0-Windows-x64.msi
macOS	3MF-Katalog-Manager-0.16.0-macOS-universal.dmg
Linux	3MF-Katalog-Manager-0.16.0-Linux-x86_64.AppImage

Windows

1. Download the .msi installer.
2. Run it and follow the installation steps.
3. Open 3MF Katalog Manager.

SmartScreen

The package is unsigned. SmartScreen may warn on first launch. After checking that you have the official download, use More info → Run anyway to continue.

macOS

1. Open the downloaded .dmg file.
2. Drag the app into Applications.
3. Open it from there.

Gatekeeper

The macOS package is also unsigned. The user guide describes Right-click → Open, then confirming the dialog, for the first launch.

If macOS reports that the app is “damaged”, the guide gives this command after moving the verified official download into Applications:

xattr -cr "/Applications/3MF Katalog Manager.app"

Linux

1. Download the .AppImage file.
2. Make it executable using Right-click → Properties.
3. Double-click to launch it.

Show in the start menu (from 0.16.1)

On the first start the app asks once whether it should appear in the start menu (“Yes”, “Not now”, “Never ask”). You can switch this later under Settings → General. The app only creates its own launcher file and icons in your user folder and never overwrites entries of other programs (for example AppImageLauncher). Depending on your desktop, the entry may only show up in the menu after you log in again.

Alternatively, in a terminal (replace the example name with the actual file name):

chmod +x "3MF-Katalog-Manager-0.16.0-Linux-x86_64.AppImage"
./3MF-Katalog-Manager-0.16.0-Linux-x86_64.AppImage

The app does not start? FUSE 2 is often missing

AppImages need the FUSE 2 library. Newer systems do not include it, for example Linux Mint 22 and Ubuntu 24.04. The app then does not start, and the terminal shows a message about libfuse.so.2. Install the library once:

# Linux Mint 22, Ubuntu 24.04 and systems based on them
sudo apt install libfuse2t64

# Older versions (Mint 21, Ubuntu 22.04)
sudo apt install libfuse2

# Arch Linux and CachyOS
sudo pacman -S fuse2

Without installing anything, the app also starts this way; it unpacks itself on launch:

./3MF-Katalog-Manager-0.16.0-Linux-x86_64.AppImage --appimage-extract-and-run

Next step

Set up your catalog and import your first models.

Why does my antivirus show a warning?

Antivirus programs such as Avast or AVG sometimes block new, unsigned programs as a precaution. You can check the file on VirusTotal first. Restore it from quarantine and add the installation folder as an exception.

Some antivirus programs, such as Kaspersky, can also raise a false alarm during an in-app update. Allow 3MF Katalog Manager in the antivirus program if this happens.

Uninstalling

Uninstalling removes the program, but deliberately keeps your catalog, settings and logs — so a reinstall or a manual update doesn’t lose anything. To remove everything, delete these folders afterwards (Settings → Info → “Open data folder” / “Open log folder” shows them while the app is still installed):

• Windows: %APPDATA%\com.thebexxs.mfkatalogmanager and %LOCALAPPDATA%\com.thebexxs.mfkatalogmanager (logs and interface cache)
• macOS: ~/Library/Application Support/com.thebexxs.mfkatalogmanager, ~/Library/Logs/com.thebexxs.mfkatalogmanager and, if present, ~/Library/Caches/com.thebexxs.mfkatalogmanager and ~/Library/WebKit/com.thebexxs.mfkatalogmanager
• Linux: ~/.local/share/com.thebexxs.mfkatalogmanager (catalog, settings, logs) and, if present, ~/.cache/com.thebexxs.mfkatalogmanager

Your model files themselves are never touched — they stay in your catalog folder.

Alternative: Docker container

From 0.16.0, you can run the app on a server and use it through your browser. The Docker version is functional, but may still be unstable. The Docker guide covers installation, home-network access, uploads and backups.