Instala Cardloader y conecta tu escáner de cartas

Cardloader es una aplicación de escritorio gratis para Windows, macOS y Linux. Instalarla lleva un minuto; para escanear en lote con un Fujitsu/Ricoh fi-8170 solo hace falta un controlador más.

Descargar la última versión Todas las versiones

Inicio rápido

Descarga. Descarga el instalador para tu sistema desde la última versión publicada en GitHub.
Instala. Instala Cardloader y ábrelo por primera vez siguiendo la guía para macOS, Windows o Linux.
Elige un motor. Abre Settings y descarga el modelo local gratuito, o pega tu token de la API de Ximilar para obtener coincidencias exactas, precios y gradeo.
Conecta un escáner. Opcional: instala el controlador y conecta un fi-8170 u otro escáner TWAIN o SANE, o usa una carpeta vigilada (Watch folder).
Comprueba los ajustes de escaneo. Escanea en ADF dúplex a 600 ppp, con la detección de alimentación múltiple desactivada, en montones pequeños.
Crea una sesión. Haz clic en New session, elige una carpeta o tu escáner, decide cómo identificar y gradear las cartas y pulsa Create & run.
Revisa y exporta. Mira cómo llegan los resultados, corrige cualquier coincidencia con un clic y exporta la sesión a CSV.

Paso 1

Descarga el programa para escanear cartas en Windows, Mac y Linux

Cardloader 0.1.0 es gratis. Descarga el instalador para tu sistema y sigue su guía más abajo:

Sistema	Descarga	Requisitos
macOS	.dmg	macOS 11 Big Sur o posterior, Apple silicon o Intel
Windows	.exe o .msi	Windows 10 u 11, 64 bits
Linux	.AppImage, .deb o .rpm	x86-64; el .deb necesita Ubuntu 22.04, Debian 12 o posterior

Las versiones anteriores y sus notas están en las versiones publicadas en GitHub. GitHub Actions compila los instaladores a partir del código abierto.

macOS Windows Linux

Paso 2 · macOS

Instala Cardloader en macOS

Abre Cardloader_0.1.0_universal.dmg desde la carpeta Descargas.
En la ventana que aparece, arrastra Cardloader a la carpeta Aplicaciones.
Abre Cardloader desde la carpeta Aplicaciones. La primera vez, macOS avisa de que no ha podido verificar que «Cardloader» no contenga software malicioso: cierra el aviso.
Abre Ajustes del Sistema → Privacidad y seguridad (en Latinoamérica, Configuración del Sistema), baja hasta Seguridad y haz clic en Abrir igualmente junto al mensaje sobre Cardloader.
Confirma con tu contraseña o con Touch ID y haz clic en Abrir. A partir de ahora Cardloader se abre como cualquier otra aplicación, y ya puedes expulsar la imagen de disco.

macOS lo pregunta porque esta primera versión aún no está firmada con un certificado de desarrollador de Apple. En macOS 14 y anteriores también funciona hacer clic derecho en la aplicación y elegir Abrir. En Terminal, xattr -dr com.apple.quarantine /Applications/Cardloader.app hace lo mismo.

Paso 2 · Windows

Instala Cardloader en Windows

Ejecuta Cardloader_0.1.0_x64-setup.exe desde la carpeta Descargas.
Si aparece una ventana azul que dice «Windows protegió su PC», haz clic en Más información y después en Ejecutar de todas formas.
Sigue los pasos del instalador. Instala Cardloader para tu cuenta de usuario, sin permisos de administrador.
Abre Cardloader desde el menú Inicio.

SmartScreen avisa porque esta primera versión aún no tiene firma de código. Si el equipo todavía no tiene Microsoft Edge WebView2, el instalador lo descarga (Windows 11 ya lo incluye). El .msi instala para todos los usuarios y necesita permisos de administrador. Los dos incluyen el asistente TWAIN para el escáner.

Paso 2 · Linux

Instala Cardloader en Linux

Elige un solo paquete. Abre una terminal en la carpeta donde lo descargaste:

Ubuntu, Debian, Linux Mint (.deb)

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

apt instala también WebKitGTK, que Cardloader necesita. Abre Cardloader desde el menú de aplicaciones o ejecuta 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

Cualquier distribución (AppImage)

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

Si no arranca y menciona FUSE, instala libfuse2 (en Ubuntu 24.04, libfuse2t64).

Paso 3

Configura el modelo de IA local o la API de Ximilar

Modelo local gratuito (sin conexión)

Abre Settings → Identification → Local model, acepta la licencia del modelo y haz clic en descargar. Ocupa unos 330 MB y puedes pausar y reanudar la descarga. A partir de ahí, las sesiones nuevas identifican las cartas en tu equipo, sin cuenta y sin internet.

API de Ximilar (opcional)

Para obtener coincidencias exactas entre variantes, niveles de confianza, precios y gradeo, copia tu token de API desde la Ximilar App, pégalo en Settings y haz clic en Test connection. El token se guarda en el llavero de tu sistema.

El reconocimiento de coleccionables necesita el plan Business de Ximilar o una prueba. Cada carta consume créditos de la API: una llamada por reconocimiento (dos en modo Auto) más una por gradeo. Consulta los precios de Ximilar.

Paso 4

Conecta un escáner Fujitsu / Ricoh fi-8170

Cardloader controla directamente el RICOH (antes Fujitsu) fi-8170, y también cualquier escáner TWAIN 2.x con alimentador de documentos en Windows o cualquier escáner SANE en macOS y Linux. Conecta el escáner por USB e instala el controlador para tu sistema:

Sistema	Qué instalar	Cómo se comunica Cardloader con él
Windows	PaperStream IP (TWAIN) para el fi-8170	Asistente TWAIN incluido, en un proceso aparte para que un controlador bloqueado nunca congele la aplicación
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (o el paquete SANE de tu distribución); opcionalmente, el controlador `pfufs` de RICOH	SANE `scanimage`

Para comprobar el escáner fuera de Cardloader, ejecuta scanimage -L en macOS o Linux, o ábrelo en PaperStream Capture en Windows.
El puerto de red del fi-8170 solo funciona a través de PaperStream en Windows; el escáner no es compatible con eSCL/AirScan.
ScanSnap y otros escáneres: los modelos ScanSnap no tienen controlador TWAIN. Deja que su propio programa guarde las imágenes en una carpeta y crea una sesión de Watch folder (carpeta vigilada); Cardloader analiza cada imagen en cuanto llega.

Paso 5

Cómo escanear cartas en lote: ajustes recomendados

Los ajustes predeterminados del escáner en Cardloader están pensados para cartas estándar de 63 × 88 mm:

ADF dúplex, para escanear y emparejar el anverso y el reverso de cada carta en una sola pasada.
600 ppp en color, suficiente para los números de coleccionista y el gradeo.
Marco de 66 × 92 mm, algo más grande que la carta, para que nunca se corten los bordes.
Detección de alimentación múltiple desactivada: las cartas rígidas provocan falsos errores de doble alimentación.
Empieza con montones pequeños de unas 10 cartas y no metas cartas enfundadas ni en toploader.

Para desarrolladores

Compilar desde el código fuente

Necesitas Rust, Node.js 22 o posterior, los requisitos previos de Tauri para tu sistema, y CMake con Clang para compilar llama.cpp para el modelo local.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # ejecuta la app con recarga en caliente
$ just install   # compila e instala en local

just es opcional; hay un Makefile con los mismos objetivos. Para compilar sin el modelo local, ejecuta cargo build --no-default-features en src-tauri/. Más detalles en el README.

Referencia

Actualizar o desinstalar Cardloader

Para actualizar, descarga la nueva versión e instálala igual que la primera vez, encima de la anterior. Se conservan tus sesiones, tus ajustes, el token de API y los modelos descargados.

Sistema	Desinstalar
macOS	Arrastra Cardloader desde Aplicaciones a la Papelera (el Basurero en Latinoamérica).
Windows	Configuración → Aplicaciones → Aplicaciones instaladas y luego Desinstalar en el menú ⋯ de Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader` o borra el AppImage.

Al desinstalar solo se elimina la aplicación. Tus sesiones siguen en la carpeta de datos que se indica abajo hasta que la borres.

Referencia

Dónde guarda Cardloader tus datos

Las sesiones, miniaturas, escaneos y capas de gradeo se quedan en tu equipo. Las imágenes originales de las sesiones de carpeta nunca se modifican ni se mueven, y al borrar una sesión solo se eliminan los archivos que creó Cardloader.

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

Empieza a escanear tus cartas gratis

Descarga Cardloader para Windows, macOS o Linux, elige una carpeta o tu escáner e identifica tu primer lote en minutos. Sin suscripción y sin cuenta.

Descargar Cardloader Danos una estrella en GitHub