Installa Cardloader e collega il tuo scanner per carte

Cardloader è un’applicazione desktop gratuita per Windows, macOS e Linux. L’installazione richiede un minuto; per scansionare in blocco con un Fujitsu/Ricoh fi-8170 basta un driver in più.

Scarica l’ultima versione Tutte le versioni

Guida rapida

Scarica. Scarica il programma di installazione per il tuo sistema dall’ultima release su GitHub.
Installa. Installa Cardloader e aprilo per la prima volta seguendo la guida per macOS, Windows o Linux.
Scegli un motore. Apri Settings e scarica il modello locale gratuito, oppure incolla il tuo token dell’API di Ximilar per riconoscimenti esatti, prezzi e gradazione.
Collega uno scanner. Opzionale: installa il driver e collega un fi-8170 o un altro scanner TWAIN o SANE, oppure usa una cartella monitorata (Watch folder).
Controlla le impostazioni di scansione. Scansiona fronte-retro dall’ADF a 600 dpi, con il rilevamento multi-alimentazione disattivato, in piccole pile.
Crea una sessione. Fai clic su New session, scegli una cartella o il tuo scanner, decidi come riconoscere e valutare le carte, poi fai clic su Create & run.
Controlla ed esporta. Guarda arrivare i risultati, correggi un riconoscimento con un clic ed esporta la sessione in CSV.

Passo 1

Scarica il programma per scansionare carte per Windows, Mac e Linux

Cardloader 0.1.0 è gratuito. Scarica il programma di installazione per il tuo sistema, poi segui la sua guida qui sotto:

Sistema	Download	Requisiti
macOS	.dmg	macOS 11 Big Sur o successivo, Mac con Apple silicon o Intel
Windows	.exe o .msi	Windows 10 o 11, 64 bit
Linux	.AppImage, .deb o .rpm	x86-64; il .deb richiede Ubuntu 22.04, Debian 12 o versioni successive

Le versioni precedenti e le note di rilascio sono nelle release su GitHub. I programmi di installazione vengono compilati dal codice open source con GitHub Actions.

macOS Windows Linux

Passo 2 · macOS

Installa Cardloader su Mac

Apri Cardloader_0.1.0_universal.dmg dalla cartella Download.
Nella finestra che compare, trascina Cardloader sulla cartella Applicazioni.
Apri Cardloader dalla cartella Applicazioni. La prima volta, macOS avvisa che non è stato possibile verificare che «Cardloader» non contenga malware: fai clic su Fine.
Apri Impostazioni di Sistema → Privacy e sicurezza, scorri in basso fino a Sicurezza e fai clic su Apri comunque accanto al messaggio su Cardloader.
Conferma con la password o con Touch ID, poi fai clic su Apri. Da quel momento Cardloader si apre come qualsiasi altra app, e puoi espellere l’immagine disco.

macOS lo chiede perché questa prima build non è ancora firmata con un certificato sviluppatore Apple. Su macOS 14 e versioni precedenti funziona anche fare clic destro sull’app e scegliere Apri. Nel Terminale, xattr -dr com.apple.quarantine /Applications/Cardloader.app fa la stessa cosa.

Passo 2 · Windows

Installa Cardloader su Windows

Esegui Cardloader_0.1.0_x64-setup.exe dalla cartella Download.
Se compare la finestra blu «PC protetto da Windows», fai clic su Ulteriori informazioni, poi su Esegui comunque.
Procedi con il programma di installazione. Installa Cardloader per il tuo account utente, senza diritti di amministratore.
Avvia Cardloader dal menu Start.

SmartScreen mostra l’avviso perché questa prima build non è ancora firmata. Se sul PC manca Microsoft Edge WebView2, il programma di installazione lo scarica (Windows 11 lo ha già). Il file .msi installa per tutti gli utenti e richiede i diritti di amministratore. L’helper TWAIN per lo scanner è incluso in entrambi.

Passo 2 · Linux

Installa Cardloader su Linux

Scegli un solo pacchetto. Apri un terminale nella cartella in cui l’hai scaricato:

Ubuntu, Debian, Linux Mint (.deb)

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

apt installa anche WebKitGTK, che serve a Cardloader. Avvia Cardloader dal menu delle applicazioni, oppure esegui 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

Qualsiasi distribuzione (AppImage)

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

Se non si avvia e nomina FUSE, installa libfuse2 (su Ubuntu 24.04, libfuse2t64).

Passo 3

Configura il modello di IA locale o l’API di Ximilar

Modello locale gratuito (offline)

Apri Settings → Identification → Local model, accetta la licenza del modello e avvia il download. Pesa circa 330 MB e si può mettere in pausa e riprendere. Da quel momento le nuove sessioni riconoscono le carte sul tuo computer, senza account e senza internet.

API di Ximilar (opzionale)

Per riconoscimenti esatti anche tra le varianti, livelli di affidabilità, prezzi e gradazione, copia il tuo token API dalla Ximilar App, incollalo in Settings e fai clic su Test connection. Il token viene conservato nel portachiavi di sistema.

Il riconoscimento dei collezionabili richiede un piano Business di Ximilar o una prova. Ogni carta consuma crediti API: una chiamata per riconoscimento (due in modalità Auto) più una per la gradazione. Vedi i prezzi di Ximilar.

Passo 4

Collega uno scanner Fujitsu / Ricoh fi-8170

Cardloader comanda direttamente il RICOH (ex Fujitsu) fi-8170, così come qualsiasi scanner TWAIN 2.x con alimentatore automatico su Windows o scanner SANE su macOS e Linux. Collega lo scanner via USB e installa il driver per il tuo sistema:

Sistema	Cosa installare	Come lo comanda Cardloader
Windows	PaperStream IP (TWAIN) per il fi-8170	Helper TWAIN incluso, in un processo separato: un driver bloccato non blocca mai l’applicazione
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (o il pacchetto SANE della tua distribuzione); in più, se vuoi, il driver `pfufs` di RICOH	SANE `scanimage`

Per provare lo scanner fuori da Cardloader, esegui scanimage -L su macOS o Linux, oppure aprilo in PaperStream Capture su Windows.
La porta di rete del fi-8170 funziona solo tramite PaperStream su Windows; lo scanner non supporta eSCL/AirScan.
ScanSnap e altri scanner: gli ScanSnap non hanno un driver TWAIN. Lascia che il loro programma salvi in una cartella e crea una sessione Watch folder (cartella monitorata): Cardloader analizza ogni immagine appena arriva.

Passo 5

Come scansionare carte in blocco: impostazioni consigliate

Le impostazioni predefinite dello scanner in Cardloader sono pensate per le carte collezionabili standard da 63 × 88 mm:

Fronte-retro dall’ADF, così fronte e retro di ogni carta vengono scansionati e abbinati in una sola passata.
600 dpi, a colori, quanto basta per i numeri delle carte e per la gradazione.
Area di 66 × 92 mm, un po’ più grande della carta, così i bordi non vengono mai tagliati.
Rilevamento multi-alimentazione disattivato: le carte rigide fanno scattare falsi allarmi di multi-alimentazione.
Inizia con piccole pile di circa 10 carte, e non inserire carte imbustate o in toploader.

Per sviluppatori

Compilare dal codice sorgente

Ti servono Rust, Node.js 22 o successivo, i prerequisiti di Tauri per il tuo sistema, e CMake con Clang per compilare llama.cpp per il modello locale.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # avvia l’app con ricaricamento a caldo
$ just install   # compila e installa in locale

just è facoltativo: un Makefile ha gli stessi target. Per compilare senza il modello locale, esegui cargo build --no-default-features in src-tauri/. Altri dettagli nel README.

Riferimento

Aggiorna o disinstalla Cardloader

Per aggiornare, scarica la nuova versione e installala allo stesso modo, sopra la vecchia. Sessioni, impostazioni, token API e modelli scaricati restano al loro posto.

Sistema	Disinstallare
macOS	Trascina Cardloader dalla cartella Applicazioni al Cestino.
Windows	Impostazioni → App → App installate, poi Disinstalla nel menu ⋯ di Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader` oppure elimina l’AppImage.

La disinstallazione rimuove solo l’app. Le tue sessioni restano nella cartella dei dati qui sotto finché non la elimini.

Riferimento

Dove Cardloader salva i tuoi dati

Sessioni, miniature, scansioni e immagini di gradazione restano sul tuo computer. Le immagini originali delle sessioni da cartella non vengono mai modificate né spostate, ed eliminare una sessione rimuove solo i file creati da Cardloader.

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

Inizia a scansionare le tue carte gratis

Scarica Cardloader per Windows, macOS o Linux, puntalo su una cartella o sul tuo scanner e riconosci il primo lotto in pochi minuti. Senza abbonamento, senza account.

Scarica Cardloader Metti una stella su GitHub