Installer Cardloader et connecter votre scanner de cartes

Cardloader est une application de bureau gratuite pour Windows, macOS et Linux. L’installation prend une minute ; pour scanner en masse avec un Fujitsu/Ricoh fi-8170, il suffit d’un pilote de plus.

Télécharger la dernière version Toutes les versions

Démarrage rapide

Télécharger. Téléchargez l’installateur pour votre système depuis la dernière release GitHub.
Installer. Installez Cardloader et ouvrez-le une première fois en suivant le guide pour macOS, Windows ou Linux.
Choisir un moteur. Ouvrez Settings et téléchargez le modèle local gratuit, ou collez votre jeton API Ximilar pour des identifications exactes, les prix et la gradation.
Connecter un scanner. Optionnel : installez le pilote et connectez un fi-8170 ou un autre scanner TWAIN ou SANE, ou utilisez un dossier surveillé (Watch folder).
Vérifier les réglages de scan. Scannez en recto verso via le chargeur automatique (ADF) à 600 dpi, avec la détection d’alimentation multiple désactivée, par petites piles.
Créer une session. Cliquez sur New session, choisissez un dossier ou votre scanner, indiquez comment identifier et grader les cartes, puis cliquez sur Create & run.
Vérifier et exporter. Regardez les résultats arriver, corrigez une identification en un clic et exportez la session en CSV.

Étape 1

Télécharger le logiciel de scan de cartes pour Windows, Mac et Linux

Cardloader 0.1.0 est gratuit. Téléchargez l’installateur pour votre système, puis suivez le guide correspondant ci-dessous :

Système	Téléchargement	Configuration requise
macOS	.dmg	macOS 11 Big Sur ou version ultérieure, Mac Apple silicon ou Intel
Windows	.exe ou .msi	Windows 10 ou 11, 64 bits
Linux	.AppImage, .deb ou .rpm	x86-64 ; le .deb nécessite Ubuntu 22.04, Debian 12 ou plus récent

Les versions précédentes et les notes de version se trouvent dans les releases GitHub. Les installateurs sont compilés à partir du code open source par GitHub Actions.

macOS Windows Linux

Étape 2 · macOS

Installer Cardloader sur Mac

Ouvrez Cardloader_0.1.0_universal.dmg depuis votre dossier Téléchargements.
Dans la fenêtre qui s’affiche, faites glisser Cardloader sur le dossier Applications.
Ouvrez Cardloader depuis le dossier Applications. La première fois, macOS indique qu’il n’a pas pu vérifier que « Cardloader » ne contient pas de logiciel malveillant : cliquez sur OK.
Ouvrez Réglages Système → Confidentialité et sécurité, faites défiler jusqu’à Sécurité et cliquez sur Ouvrir quand même à côté du message concernant Cardloader.
Confirmez avec votre mot de passe ou Touch ID, puis cliquez sur Ouvrir. Désormais, Cardloader s’ouvre comme n’importe quelle autre application, et vous pouvez éjecter l’image disque.

macOS vous le demande parce que cette première version n’est pas encore signée avec un certificat de développeur Apple. Sur macOS 14 et versions antérieures, un clic droit sur l’application puis Ouvrir fonctionne aussi. Dans Terminal, xattr -dr com.apple.quarantine /Applications/Cardloader.app fait la même chose.

Étape 2 · Windows

Installer Cardloader sous Windows

Lancez Cardloader_0.1.0_x64-setup.exe depuis votre dossier Téléchargements.
Si une fenêtre bleue « Windows a protégé votre ordinateur » s’affiche, cliquez sur Informations complémentaires, puis sur Exécuter quand même.
Suivez les étapes de l’installateur. Il installe Cardloader pour votre compte utilisateur, sans droits d’administrateur.
Lancez Cardloader depuis le menu Démarrer.

SmartScreen affiche cet avertissement parce que cette première version n’est pas encore signée. L’installateur télécharge Microsoft Edge WebView2 si le PC ne l’a pas encore (Windows 11 l’a déjà). Le .msi installe l’application pour tous les utilisateurs et nécessite des droits d’administrateur. L’assistant TWAIN pour le scanner est inclus dans les deux.

Étape 2 · Linux

Installer Cardloader sous Linux

Choisissez un seul paquet. Ouvrez un terminal dans le dossier où vous l’avez téléchargé :

Ubuntu, Debian, Linux Mint (.deb)

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

apt installe aussi WebKitGTK, dont Cardloader a besoin. Lancez Cardloader depuis le menu des applications, ou avec 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

Toutes les distributions (AppImage)

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

S’il ne démarre pas et mentionne FUSE, installez libfuse2 (sur Ubuntu 24.04, libfuse2t64).

Étape 3

Configurer le modèle d’IA local ou l’API Ximilar

Modèle local gratuit (hors ligne)

Ouvrez Settings → Identification → Local model, acceptez la licence du modèle et lancez le téléchargement. Il pèse environ 330 Mo et peut être mis en pause et repris. Les nouvelles sessions identifient alors les cartes sur votre ordinateur, sans compte ni connexion internet.

API Ximilar (optionnelle)

Pour des identifications exactes, versions comprises, des niveaux de confiance, les prix et la gradation, copiez votre jeton API depuis l’app Ximilar, collez-le dans Settings et cliquez sur Test connection. Le jeton est conservé dans le trousseau de votre système.

La reconnaissance d’objets de collection nécessite une offre Business Ximilar ou un essai. Chaque carte consomme des crédits API : un appel par identification (deux en mode Auto), plus un par gradation. Voir les tarifs Ximilar.

Étape 4

Connecter un scanner Fujitsu / Ricoh fi-8170

Cardloader pilote directement le RICOH (anciennement Fujitsu) fi-8170, ainsi que tout scanner TWAIN 2.x avec chargeur de documents sous Windows et tout scanner SANE sous macOS et Linux. Branchez le scanner en USB et installez le pilote pour votre système :

Système	À installer	Comment Cardloader communique avec lui
Windows	PaperStream IP (TWAIN) pour le fi-8170	Assistant TWAIN fourni, dans son propre processus : un pilote bloqué ne fige jamais l’application
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (ou le paquet SANE de votre distribution) ; éventuellement le pilote `pfufs` de RICOH	SANE `scanimage`

Pour tester le scanner en dehors de Cardloader, lancez scanimage -L sous macOS ou Linux, ou ouvrez-le dans PaperStream Capture sous Windows.
Le port réseau du fi-8170 ne fonctionne qu’avec PaperStream sous Windows ; le scanner ne prend pas en charge eSCL/AirScan.
ScanSnap et autres scanners : les ScanSnap n’ont pas de pilote TWAIN. Laissez leur propre logiciel enregistrer dans un dossier et créez une session Watch folder (dossier surveillé) ; Cardloader analyse chaque image dès qu’elle arrive.

Étape 5

Comment scanner ses cartes en masse : les réglages recommandés

Les réglages par défaut du scanner dans Cardloader sont pensés pour les cartes à collectionner standard de 63 × 88 mm :

Recto verso via le chargeur automatique (ADF), pour scanner et apparier le recto et le verso de chaque carte en un seul passage.
600 dpi, en couleur, assez pour lire les numéros de carte et évaluer l’état.
Cadre de 66 × 92 mm, un peu plus grand que la carte, pour ne jamais rogner les bords.
Détection d’alimentation multiple désactivée : les cartes rigides déclenchent de fausses erreurs.
Commencez par de petites piles d’une dizaine de cartes, et ne passez ni cartes sous sleeve ni toploaders.

Pour les développeurs

Compiler depuis les sources

Il vous faut Rust, Node.js 22 ou plus récent, les prérequis de Tauri pour votre système, et CMake avec Clang pour compiler llama.cpp pour le modèle local.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # lance l’application avec rechargement à chaud
$ just install   # compile et installe en local

just est optionnel ; un Makefile propose les mêmes cibles. Pour compiler sans le modèle local, lancez cargo build --no-default-features dans src-tauri/. Plus de détails dans le README.

Référence

Mettre à jour ou désinstaller Cardloader

Pour mettre à jour, téléchargez la nouvelle version et installez-la de la même façon, par-dessus l’ancienne. Vos sessions, vos réglages, votre jeton API et les modèles téléchargés sont conservés.

Système	Désinstaller
macOS	Faites glisser Cardloader du dossier Applications vers la Corbeille.
Windows	Paramètres → Applications → Applications installées, puis Désinstaller dans le menu ⋯ de Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader`, ou supprimez l’AppImage.

La désinstallation ne supprime que l’application. Vos sessions restent dans le dossier de données ci-dessous tant que vous ne le supprimez pas.

Référence

Où Cardloader conserve vos données

Les sessions, miniatures, scans et visuels de gradation restent sur votre ordinateur. Les images d’origine des sessions de dossier ne sont jamais modifiées ni déplacées, et supprimer une session n’efface que les fichiers créés par Cardloader.

Système	Dossier
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

Scannez vos cartes gratuitement

Téléchargez Cardloader pour Windows, macOS ou Linux, indiquez-lui un dossier ou votre scanner, et identifiez votre premier lot en quelques minutes. Sans abonnement ni compte.

Télécharger Cardloader Mettre une étoile sur GitHub