Cardloader installieren und deinen Kartenscanner verbinden

Cardloader ist eine kostenlose Desktop-App für Windows, macOS und Linux. Die Installation dauert eine Minute; für das Scannen im Stapel mit einem Fujitsu/Ricoh fi-8170 kommt noch ein Treiber dazu.

Neueste Version herunterladen Alle Releases

Schnellstart

Herunterladen. Lade das Installationsprogramm für dein System aus dem neuesten GitHub-Release herunter.
Installieren. Installiere Cardloader und öffne es zum ersten Mal, wie in der Anleitung für macOS, Windows oder Linux beschrieben.
Erkennung wählen. Öffne Settings und lade das kostenlose lokale Modell herunter, oder füge deinen Ximilar-API-Token für exakte Treffer, Preise und Grading ein.
Scanner verbinden. Optional: Installiere den Treiber und verbinde einen fi-8170 oder einen anderen TWAIN- oder SANE-Scanner, oder nutze einen überwachten Ordner (Watch folder).
Scan-Einstellungen prüfen. Scanne in kleinen Stapeln duplex über den automatischen Dokumenteneinzug (ADF), mit 600 dpi und ausgeschalteter Mehrfacheinzugserkennung.
Session anlegen. Klicke auf New session, wähle einen Ordner oder deinen Scanner, lege fest, wie die Karten erkannt und bewertet werden, und klicke auf Create & run.
Prüfen und exportieren. Sieh zu, wie die Ergebnisse erscheinen, korrigiere einen Treffer mit einem Klick und exportiere die Session als CSV.

Schritt 1

Kartenscanner-Software für Windows, Mac und Linux herunterladen

Cardloader 0.1.0 ist kostenlos. Lade das Installationsprogramm für dein System herunter und folge dann der passenden Anleitung weiter unten:

System	Download	Voraussetzungen
macOS	.dmg	macOS 11 Big Sur oder neuer, Apple Silicon oder Intel
Windows	.exe oder .msi	Windows 10 oder 11, 64 Bit
Linux	.AppImage, .deb oder .rpm	x86-64; das .deb braucht Ubuntu 22.04, Debian 12 oder neuer

Ältere Versionen und die Versionshinweise findest du unter GitHub-Releases. Die Installationsprogramme baut GitHub Actions aus dem Open-Source-Code.

macOS Windows Linux

Schritt 2 · macOS

Cardloader auf dem Mac installieren

Öffne Cardloader_0.1.0_universal.dmg im Ordner „Downloads“.
Ziehe im Fenster, das sich öffnet, Cardloader auf den Ordner Programme.
Öffne Cardloader aus dem Ordner „Programme“. Beim ersten Mal meldet macOS, es könne nicht überprüfen, ob „Cardloader“ frei von Schadsoftware ist: Klicke auf Fertig.
Öffne Systemeinstellungen → Datenschutz & Sicherheit, scrolle nach unten zu Sicherheit und klicke neben der Meldung zu Cardloader auf Dennoch öffnen.
Bestätige mit deinem Passwort oder Touch ID und klicke dann auf Öffnen. Ab jetzt startet Cardloader wie jede andere App, und du kannst das Image auswerfen.

macOS fragt nach, weil dieser frühe Build noch nicht mit einem Apple-Entwicklerzertifikat signiert ist. Unter macOS 14 und älter klappt auch ein Rechtsklick auf die App und Öffnen. Im Terminal erledigt xattr -dr com.apple.quarantine /Applications/Cardloader.app dasselbe.

Schritt 2 · Windows

Cardloader unter Windows installieren

Führe Cardloader_0.1.0_x64-setup.exe aus dem Ordner „Downloads“ aus.
Erscheint das blaue Fenster „Der Computer wurde durch Windows geschützt“, klicke auf Weitere Informationen und dann auf Trotzdem ausführen.
Klicke dich durch das Installationsprogramm. Es installiert Cardloader für dein Benutzerkonto, ohne Administratorrechte.
Starte Cardloader über das Startmenü.

SmartScreen warnt, weil dieser frühe Build noch nicht codesigniert ist. Fehlt Microsoft Edge WebView2 auf dem PC, lädt das Installationsprogramm es herunter (Windows 11 bringt es schon mit). Die .msi installiert für alle Benutzer und braucht Administratorrechte. Der TWAIN-Helfer für den Scanner ist in beiden dabei.

Schritt 2 · Linux

Cardloader unter Linux installieren

Wähle eines der Pakete und öffne ein Terminal in dem Ordner, in den du es heruntergeladen hast:

Ubuntu, Debian, Linux Mint (.deb)

$ sudo apt install ./Cardloader_0.1.0_amd64.deb

apt installiert dabei auch WebKitGTK, das Cardloader braucht. Starte Cardloader über das Anwendungsmenü oder mit cardloader.

Fedora, openSUSE (.rpm)

$ sudo dnf install ./Cardloader-0.1.0-1.x86_64.rpm      # Fedora
$ sudo zypper install ./Cardloader-0.1.0-1.x86_64.rpm   # openSUSE

Jede Distribution (AppImage)

$ chmod +x Cardloader_0.1.0_amd64.AppImage
$ ./Cardloader_0.1.0_amd64.AppImage

Startet es nicht und ist von FUSE die Rede, installiere libfuse2 (unter Ubuntu 24.04 libfuse2t64).

Schritt 3

Lokale KI oder die Ximilar-API einrichten

Kostenloses lokales Modell (offline)

Öffne Settings → Identification → Local model, akzeptiere die Lizenz des Modells und starte den Download. Er ist rund 330 MB groß und lässt sich pausieren und fortsetzen. Neue Sessions erkennen Karten danach auf deinem Rechner, ohne Konto und ohne Internet.

Ximilar-API (optional)

Für exakte Treffer auch bei Varianten, Konfidenzwerte, Preise und Grading kopierst du deinen API-Token aus der Ximilar App, fügst ihn unter Settings ein und klickst auf Test connection. Der Token wird im Schlüsselbund deines Systems gespeichert.

Für die Erkennung von Sammlerstücken brauchst du einen Ximilar Business-Tarif oder eine Testphase. Jede Karte kostet API-Credits: ein Aufruf pro Erkennung (zwei im Modus Auto) plus einer pro Grading. Siehe Ximilar-Preise.

Schritt 4

Einen Fujitsu/Ricoh fi-8170 verbinden

Cardloader steuert den RICOH (ehemals Fujitsu) fi-8170 direkt, dazu unter Windows jeden TWAIN-2.x-Scanner mit Dokumenteneinzug und unter macOS und Linux jeden SANE-Scanner. Schließe den Scanner per USB an und installiere den Treiber für dein System:

System	Was du installierst	Wie Cardloader mit ihm spricht
Windows	PaperStream IP (TWAIN) für den fi-8170	Mitgelieferter TWAIN-Helfer in einem eigenen Prozess, damit ein hängender Treiber nie die App einfriert
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (oder das SANE-Paket deiner Distribution); optional der RICOH-Treiber `pfufs`	SANE `scanimage`

Um den Scanner außerhalb von Cardloader zu prüfen, führe unter macOS oder Linux scanimage -L aus oder öffne ihn unter Windows in PaperStream Capture.
Der Netzwerkanschluss des fi-8170 funktioniert nur über PaperStream unter Windows; eSCL/AirScan beherrscht der Scanner nicht.
ScanSnap und andere Scanner: ScanSnap-Modelle haben keinen TWAIN-Treiber. Lass ihre eigene Software in einen Ordner speichern und lege eine Session mit Watch folder (überwachter Ordner) an; Cardloader analysiert jedes Bild, sobald es ankommt.

Schritt 5

Sammelkarten im Stapel scannen: empfohlene Einstellungen

Die Scanner-Voreinstellungen von Cardloader sind auf Sammelkarten im Standardformat 63 × 88 mm abgestimmt:

Duplex über den automatischen Dokumenteneinzug (ADF), damit Vorder- und Rückseite jeder Karte in einem Durchgang gescannt und zugeordnet werden.
600 dpi in Farbe, genug für Kartennummern und Grading.
Scanbereich 66 × 92 mm, etwas größer als die Karte, damit die Kanten nie abgeschnitten werden.
Mehrfacheinzugserkennung aus: Bei steifen Karten meldet der Scanner sonst fälschlich einen Mehrfacheinzug.
Fang mit kleinen Stapeln von etwa 10 Karten an und lass Karten in Sleeves oder Toploadern draußen.

Für Entwickler

Aus dem Quellcode bauen

Du brauchst Rust, Node.js 22 oder neuer, die Tauri-Voraussetzungen für dein System sowie CMake mit Clang, um llama.cpp für das lokale Modell zu kompilieren.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # App mit Hot Reload starten
$ just install   # bauen und lokal installieren

just ist optional; ein Makefile hat dieselben Ziele. Ohne lokales Modell baust du mit cargo build --no-default-features in src-tauri/. Mehr im README.

Nachschlagen

Cardloader aktualisieren oder deinstallieren

Für ein Update lädst du die neue Version herunter und installierst sie genauso über die alte. Deine Sessions, Einstellungen, der API-Token und heruntergeladene Modelle bleiben erhalten.

System	Deinstallieren
macOS	Ziehe Cardloader aus dem Ordner „Programme“ in den Papierkorb.
Windows	Einstellungen → Apps → Installierte Apps, dann im Menü ⋯ von Cardloader auf Deinstallieren klicken.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader` oder das AppImage löschen.

Beim Deinstallieren wird nur die App entfernt. Deine Sessions bleiben im Datenordner unten, bis du ihn löschst.

Nachschlagen

Wo Cardloader deine Daten speichert

Sessions, Vorschaubilder, Scans und Grading-Overlays bleiben auf deinem Rechner. Originalbilder in Ordner-Sessions werden nie verändert oder verschoben, und beim Löschen einer Session werden nur die Dateien entfernt, die Cardloader selbst angelegt hat.

System	Ordner
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

Scanne deine Karten kostenlos

Lade Cardloader für Windows, macOS oder Linux herunter, wähle einen Ordner oder deinen Scanner und lass deinen ersten Stapel in wenigen Minuten erkennen. Ohne Abo, ohne Konto.

Cardloader herunterladen Auf GitHub einen Stern geben