Installeer Cardloader en sluit je kaartscanner aan

Cardloader is een gratis desktop-app voor Windows, macOS en Linux. Installeren duurt een minuut; voor het scannen in bulk met een Fujitsu/Ricoh fi-8170 komt er nog één driver bij.

Download de nieuwste versie Alle releases

Snelstart

Downloaden. Download het installatiebestand voor je systeem uit de nieuwste release op GitHub.
Installeren. Installeer Cardloader en open het voor de eerste keer, volgens de handleiding voor macOS, Windows of Linux.
Kies een engine. Open Settings en download het gratis lokale model, of plak je Ximilar-API-token voor exacte matches, prijzen en grading.
Sluit een scanner aan. Optioneel: installeer de driver en sluit een fi-8170 of een andere TWAIN- of SANE-scanner aan, of gebruik een bewaakte map.
Controleer de scaninstellingen. Scan in ADF-duplex op 600 dpi, met multi-invoerdetectie uit, in kleine stapels.
Maak een sessie aan. Klik op New session, kies een map of je scanner, kies hoe de kaarten herkend en gegradet worden en klik op Create & run.
Controleren en exporteren. Zie de resultaten binnenkomen, verbeter een match met één klik en exporteer de sessie als CSV.

Stap 1

Download kaartscanner-software voor Windows, Mac en Linux

Cardloader 0.1.0 is gratis. Download het installatiebestand voor je systeem en volg daarna de handleiding hieronder:

Systeem	Download	Vereisten
macOS	.dmg	macOS 11 Big Sur of nieuwer, Apple silicon of Intel
Windows	.exe of .msi	Windows 10 of 11, 64-bit
Linux	.AppImage, .deb of .rpm	x86-64; de .deb vereist Ubuntu 22.04, Debian 12 of nieuwer

Oudere versies en de release notes staan bij de releases op GitHub. De installatiebestanden worden door GitHub Actions gebouwd uit de open-source code.

macOS Windows Linux

Stap 2 · macOS

Cardloader installeren op een Mac

Open Cardloader_0.1.0_universal.dmg vanuit je map Downloads.
Sleep in het venster dat verschijnt Cardloader naar de map Programma’s.
Open Cardloader vanuit de map Programma’s. De eerste keer meldt macOS dat niet kon worden geverifieerd dat “Cardloader” vrij is van malware: klik op Gereed.
Open Systeeminstellingen → Privacy en beveiliging, scrol omlaag naar Beveiliging en klik op Open toch naast de melding over Cardloader.
Bevestig met je wachtwoord of Touch ID en klik dan op Open. Vanaf nu start Cardloader zoals elke andere app, en kun je de schijfkopie uitwerpen.

macOS vraagt dit omdat deze vroege versie nog niet is ondertekend met een Apple-ontwikkelaarscertificaat. Op macOS 14 en ouder kun je ook met de rechtermuisknop op de app klikken en Open kiezen. In Terminal doet xattr -dr com.apple.quarantine /Applications/Cardloader.app hetzelfde.

Stap 2 · Windows

Cardloader installeren op Windows

Start Cardloader_0.1.0_x64-setup.exe vanuit je map Downloads.
Verschijnt het blauwe venster “Windows heeft uw pc beschermd”, klik dan op Meer informatie en daarna op Toch uitvoeren.
Doorloop het installatieprogramma. Het installeert Cardloader voor jouw gebruikersaccount, zonder beheerdersrechten.
Start Cardloader vanuit het menu Start.

SmartScreen waarschuwt omdat deze vroege versie nog geen codehandtekening heeft. Het installatieprogramma downloadt Microsoft Edge WebView2 als de pc het nog niet heeft (Windows 11 heeft het al). De .msi installeert voor alle gebruikers en vraagt beheerdersrechten. De TWAIN-helper voor de scanner zit in beide.

Stap 2 · Linux

Cardloader installeren op Linux

Kies één pakket. Open een terminal in de map waarin je het hebt gedownload:

Ubuntu, Debian, Linux Mint (.deb)

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

apt installeert ook WebKitGTK, dat Cardloader nodig heeft. Start Cardloader vanuit je applicatiemenu, of voer cardloader uit.

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

Elke distributie (AppImage)

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

Start het niet en wordt FUSE genoemd, installeer dan libfuse2 (op Ubuntu 24.04 libfuse2t64).

Stap 3

Stel het lokale AI-model of de Ximilar-API in

Gratis lokaal model (offline)

Open Settings → Identification → Local model, accepteer de licentie van het model en klik op downloaden. Het is ongeveer 330 MB, en de download kun je pauzeren en hervatten. Nieuwe sessies herkennen kaarten daarna op je computer, zonder account en zonder internet.

Ximilar-API (optioneel)

Voor exacte matches over varianten heen, betrouwbaarheidsscores, prijzen en grading kopieer je je API-token uit de Ximilar App, plak je het in Settings en klik je op Test connection. Het token wordt bewaard in de sleutelhanger van je systeem.

Voor de herkenning van verzamelobjecten heb je een Business-abonnement of proefperiode bij Ximilar nodig. Elke kaart kost API-credits: één aanroep per herkenning (twee in de modus Auto) plus één per grading. Zie de prijzen van Ximilar.

Stap 4

Sluit een Fujitsu/Ricoh fi-8170-scanner aan

Cardloader stuurt de RICOH (voorheen Fujitsu) fi-8170 rechtstreeks aan, en elke TWAIN 2.x-scanner met documentinvoer op Windows of SANE-scanner op macOS en Linux. Sluit de scanner aan via USB en installeer de driver voor je systeem:

Systeem	Wat je installeert	Hoe Cardloader ermee praat
Windows	PaperStream IP (TWAIN) voor de fi-8170	Meegeleverde TWAIN-helper, in een eigen proces, zodat een vastgelopen driver de app nooit bevriest
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (of het SANE-pakket van je distributie); optioneel de driver `pfufs` van RICOH	SANE `scanimage`

Om de scanner buiten Cardloader te testen, voer je scanimage -L uit op macOS of Linux, of open je hem in PaperStream Capture op Windows.
De netwerkpoort van de fi-8170 werkt alleen via PaperStream op Windows; de scanner ondersteunt geen eSCL/AirScan.
ScanSnap en andere scanners: ScanSnap-modellen hebben geen TWAIN-driver. Laat hun eigen software in een map opslaan en maak een sessie van het type Watch folder aan; Cardloader analyseert elke afbeelding zodra die binnenkomt.

Stap 5

Verzamelkaarten in bulk scannen: aanbevolen instellingen

De standaard scaninstellingen van Cardloader zijn afgestemd op verzamelkaarten van het standaardformaat 63 × 88 mm:

ADF-duplex, zodat de voor- en achterkant van elke kaart in één doorgang worden gescand en gekoppeld.
600 dpi, in kleur: genoeg voor kaartnummers en grading.
Scangebied van 66 × 92 mm, iets groter dan de kaart, zodat de randen nooit worden afgesneden.
Multi-invoerdetectie uit: stijve kaarten geven anders onterecht een multi-invoerfout.
Begin met kleine stapels van ongeveer 10 kaarten, en voer geen kaarten in sleeves of toploaders in.

Voor ontwikkelaars

Bouwen uit de broncode

Je hebt Rust nodig, Node.js 22 of nieuwer, de vereisten van Tauri voor je systeem, en CMake met Clang om llama.cpp te compileren voor het lokale model.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # app starten met hot reload
$ just install   # lokaal bouwen en installeren

just is optioneel; een Makefile heeft dezelfde targets. Om zonder het lokale model te bouwen, voer je cargo build --no-default-features uit in src-tauri/. Meer in de README.

Naslag

Cardloader bijwerken of verwijderen

Om bij te werken download je de nieuwe versie en installeer je die op dezelfde manier, over de oude heen. Je sessies, instellingen, API-token en gedownloade modellen blijven bewaard.

Systeem	Verwijderen
macOS	Sleep Cardloader van Programma’s naar de prullenmand.
Windows	Instellingen → Apps → Geïnstalleerde apps, dan Verwijderen in het menu ⋯ van Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader`, of verwijder de AppImage.

Bij het verwijderen gaat alleen de app weg. Je sessies blijven in de gegevensmap hieronder staan tot je die zelf verwijdert.

Naslag

Waar Cardloader je gegevens bewaart

Sessies, miniaturen, scans en grading-overlays blijven op je computer. Originele afbeeldingen in mapsessies worden nooit gewijzigd of verplaatst, en het verwijderen van een sessie wist alleen de bestanden die Cardloader zelf heeft aangemaakt.

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

Begin gratis met het scannen van je kaarten

Download Cardloader voor Windows, macOS of Linux, kies een map of je scanner en laat binnen een paar minuten je eerste stapel herkennen. Geen abonnement, geen account.

Cardloader downloaden Geef een ster op GitHub