Installation

Lade die passende Ausgabe von der Downloadseite herunter.

Download für dein Betriebssystem

Ab 0.16.0 gibt es einen Download pro System, immer mit STEP-Vorschau. Der Dateiname hat keinen -STEP-Zusatz. Das Paket ist größer als die frühere Standard-Variante. Wenn du diese bisher nutzt, erhältst du die neue Ausgabe über das nächste Update aus der App.

Plattform	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. Lade den .msi-Installer herunter.
2. Starte ihn und folge der Installation.
3. Öffne den 3MF Katalog Manager.

SmartScreen

Das Paket ist unsigniert. Beim ersten Start kann SmartScreen warnen. Wenn du den offiziellen Download geprüft hast, kannst du über Weitere Informationen → Trotzdem ausführen fortfahren.

macOS

1. Öffne die heruntergeladene .dmg-Datei.
2. Ziehe die App in den Programme-Ordner.
3. Öffne die App dort.

Gatekeeper

Auch das macOS-Paket ist unsigniert. Das Handbuch beschreibt Rechtsklick → Öffnen mit anschließender Bestätigung für den ersten Start.

Meldet macOS die App als „beschädigt“, nennt das Handbuch nach dem Verschieben in den Programme-Ordner diesen Befehl für den geprüften offiziellen Download:

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

Linux

1. Lade die .AppImage-Datei herunter.
2. Mache sie per Rechtsklick → Eigenschaften ausführbar.
3. Starte sie per Doppelklick.

Im Startmenü anzeigen (ab 0.16.1)

Beim ersten Start fragt die App einmal, ob sie sich im Startmenü anzeigen soll („Ja“, „Nicht jetzt“, „Nie fragen“). Später lässt sich das unter Einstellungen → Allgemein ein- und ausschalten. Die App legt dafür nur eine eigene Starter-Datei und ihre Symbole in deinem Benutzerordner an und überschreibt nie Einträge anderer Programme (zum Beispiel AppImageLauncher). Der Eintrag erscheint je nach Desktop erst nach dem nächsten Anmelden im Menü.

Alternativ im Terminal (ersetze den Beispielnamen durch den tatsächlichen Dateinamen):

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

Die App startet nicht? Dann fehlt oft FUSE 2

AppImages brauchen die Bibliothek FUSE 2. Neuere Systeme bringen sie nicht mit, zum Beispiel Linux Mint 22 und Ubuntu 24.04. Dann startet die App nicht, und im Terminal erscheint eine Meldung zu libfuse.so.2. Installiere die Bibliothek einmalig:

# Linux Mint 22, Ubuntu 24.04 und darauf aufbauende Systeme
sudo apt install libfuse2t64

# Ältere Versionen (Mint 21, Ubuntu 22.04)
sudo apt install libfuse2

# Arch Linux und CachyOS
sudo pacman -S fuse2

Ohne Installation startet die App auch so, sie entpackt sich dann beim Start selbst:

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

Weiter geht’s

Richte deinen Katalog ein und importiere die ersten Modelle.

Warum warnt mein Virenscanner?

Virenschutzprogramme wie Avast oder AVG blockieren neue, unsignierte Programme manchmal vorsorglich. Du kannst die Datei zunächst auf VirusTotal prüfen. Stelle sie aus der Quarantäne wieder her und füge den Installationsordner als Ausnahme hinzu.

Auch während eines Updates aus der App können manche Virenschutzprogramme, etwa Kaspersky, einen Fehlalarm auslösen. Erlaube dann den 3MF Katalog Manager im Virenschutzprogramm.

Deinstallieren

Beim Deinstallieren wird das Programm entfernt, Katalog, Einstellungen und Logs bleiben aber absichtlich erhalten – so geht bei einer Neuinstallation oder einem Update von Hand nichts verloren. Willst du alles loswerden, lösch danach diese Ordner (solange die App noch installiert ist, zeigt Einstellungen → Info → „Datenordner öffnen“ / „Log-Ordner öffnen“ sie dir):

• Windows: %APPDATA%\com.thebexxs.mfkatalogmanager und %LOCALAPPDATA%\com.thebexxs.mfkatalogmanager (Logs und Zwischenspeicher der Oberfläche)
• macOS: ~/Library/Application Support/com.thebexxs.mfkatalogmanager, ~/Library/Logs/com.thebexxs.mfkatalogmanager und, falls vorhanden, ~/Library/Caches/com.thebexxs.mfkatalogmanager und ~/Library/WebKit/com.thebexxs.mfkatalogmanager
• Linux: ~/.local/share/com.thebexxs.mfkatalogmanager (Katalog, Einstellungen, Logs) und, falls vorhanden, ~/.cache/com.thebexxs.mfkatalogmanager

Deine Modelldateien selbst werden nie angefasst – sie bleiben in deinem Katalog-Ordner.

Alternativ: als Docker-Container

Ab 0.16.0 kannst du die App auf einem Server betreiben und im Browser bedienen. Die Docker-Version ist funktionsfähig, aber möglicherweise noch instabil. Die Docker-Anleitung beschreibt Installation, Heimnetz-Zugriff, Uploads und Sicherungen.