Instale o Cardloader e conecte o seu scanner de cartas

O Cardloader é um programa de desktop grátis para Windows, macOS e Linux. A instalação leva um minuto; para escanear em lote com um Fujitsu/Ricoh fi-8170, basta mais um driver.

Baixar a versão mais recente Todas as versões

Primeiros passos

Baixe. Baixe o instalador para o seu sistema na versão mais recente do GitHub.
Instale. Instale o Cardloader e abra pela primeira vez seguindo o guia para macOS, Windows ou Linux.
Escolha um motor. Abra Settings e baixe o modelo local gratuito, ou cole o seu token da API da Ximilar para ter identificação exata, preços e graduação.
Conecte um scanner. Opcional: instale o driver e conecte um fi-8170 ou outro scanner TWAIN ou SANE, ou use uma pasta monitorada (Watch folder).
Confira as configurações de scan. Escaneie em ADF duplex a 600 dpi, com a detecção de alimentação múltipla desligada, em pilhas pequenas.
Crie uma sessão. Clique em New session, escolha uma pasta ou o seu scanner, defina como identificar e graduar as cartas e clique em Create & run.
Revise e exporte. Acompanhe os resultados chegando, corrija qualquer identificação com um clique e exporte a sessão em CSV.

Passo 1

Baixe o programa para escanear cartas no Windows, Mac e Linux

O Cardloader 0.1.0 é grátis. Baixe o instalador do seu sistema e siga o guia correspondente logo abaixo:

Sistema	Download	Requisitos
macOS	.dmg	macOS 11 Big Sur ou mais recente, Apple silicon ou Intel
Windows	.exe ou .msi	Windows 10 ou 11, 64 bits
Linux	.AppImage, .deb ou .rpm	x86-64; o .deb exige Ubuntu 22.04, Debian 12 ou mais recente

As versões anteriores e as notas de cada uma ficam nas versões no GitHub. Os instaladores são compilados a partir do código aberto pelo GitHub Actions.

macOS Windows Linux

Passo 2 · macOS

Instale o Cardloader no Mac

Abra o Cardloader_0.1.0_universal.dmg na pasta Transferências.
Na janela que se abre, arraste o Cardloader para a pasta Aplicativos.
Abra o Cardloader na pasta Aplicativos. Na primeira vez, o macOS avisa que não pôde verificar se “Cardloader” está livre de malware: feche o aviso.
Abra Ajustes do Sistema → Privacidade e Segurança, role para baixo até Segurança e clique em Abrir Mesmo Assim ao lado da mensagem sobre o Cardloader.
Confirme com a sua senha ou com o Touch ID e clique em Abrir. A partir daí, o Cardloader abre como qualquer outro app, e você já pode ejetar a imagem de disco.

O macOS pede essa confirmação porque esta primeira versão ainda não é assinada com um certificado de desenvolvedor da Apple. No macOS 14 e anteriores, também dá para clicar com o botão direito no app e escolher Abrir. No Terminal, xattr -dr com.apple.quarantine /Applications/Cardloader.app faz o mesmo.

Passo 2 · Windows

Instale o Cardloader no Windows

Execute o Cardloader_0.1.0_x64-setup.exe na pasta Downloads.
Se aparecer uma janela azul dizendo “O Windows protegeu o computador”, clique em Mais informações e depois em Executar assim mesmo.
Avance pelas telas do instalador. Ele instala o Cardloader na sua conta de usuário, sem precisar de permissão de administrador.
Abra o Cardloader pelo menu Iniciar.

O SmartScreen avisa porque esta primeira versão ainda não tem assinatura de código. O instalador baixa o Microsoft Edge WebView2 se o computador ainda não tiver (o Windows 11 já vem com ele). O .msi instala para todos os usuários e exige permissão de administrador. O auxiliar TWAIN do scanner vem incluído nos dois.

Passo 2 · Linux

Instale o Cardloader no Linux

Escolha um dos pacotes. Abra um terminal na pasta onde você o baixou:

Ubuntu, Debian, Linux Mint (.deb)

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

O apt também instala o WebKitGTK, de que o Cardloader precisa. Abra o Cardloader pelo menu de aplicativos ou rode 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

Qualquer distribuição (AppImage)

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

Se ele não abrir e mencionar FUSE, instale o libfuse2 (no Ubuntu 24.04, libfuse2t64).

Passo 3

Configure o modelo de IA local ou a API da Ximilar

Modelo local gratuito (offline)

Abra Settings → Identification → Local model, aceite a licença do modelo e clique para baixar. São cerca de 330 MB, e o download pode ser pausado e retomado. A partir daí, as novas sessões identificam as cartas no seu computador, sem cadastro e sem internet.

API da Ximilar (opcional)

Para ter identificação exata entre variantes, níveis de confiança, preços e graduação, copie o seu token da API no Ximilar App, cole em Settings e clique em Test connection. O token fica guardado no chaveiro do sistema.

O reconhecimento de colecionáveis exige o plano Business da Ximilar ou um período de teste. Cada carta consome créditos da API: uma chamada por identificação (duas no modo Auto) mais uma por graduação. Veja os preços da Ximilar.

Passo 4

Conecte um scanner Fujitsu / Ricoh fi-8170

O Cardloader controla direto o fi-8170 da RICOH (antiga Fujitsu), além de qualquer scanner TWAIN 2.x com alimentador de documentos no Windows ou scanner SANE no macOS e no Linux. Ligue o scanner por USB e instale o driver do seu sistema:

Sistema	O que instalar	Como o Cardloader se comunica
Windows	PaperStream IP (TWAIN) para o fi-8170	Auxiliar TWAIN incluído, num processo separado para que um driver travado nunca congele o programa
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (ou o pacote SANE da sua distribuição); opcionalmente o driver `pfufs` da RICOH	SANE `scanimage`

Para testar o scanner fora do Cardloader, rode scanimage -L no macOS ou no Linux, ou abra o scanner no PaperStream Capture no Windows.
A porta de rede do fi-8170 só funciona pelo PaperStream no Windows; o scanner não suporta eSCL/AirScan.
ScanSnap e outros scanners: os modelos ScanSnap não têm driver TWAIN. Deixe o programa deles salvar numa pasta e crie uma sessão de Watch folder (pasta monitorada); o Cardloader analisa cada imagem assim que ela chega.

Passo 5

Como escanear cartas em lote: configurações recomendadas

As configurações padrão de scanner do Cardloader são ajustadas para cartas no tamanho padrão de 63 × 88 mm:

ADF duplex, para que a frente e o verso de cada carta sejam digitalizados e pareados numa só passada.
600 dpi, em cores, o suficiente para o número da carta e para a graduação.
Área de 66 × 92 mm, um pouco maior que a carta, para as bordas nunca serem cortadas.
Detecção de alimentação múltipla desligada: cartas mais rígidas disparam falsos erros de alimentação dupla.
Comece com pilhas pequenas, de umas 10 cartas, e não passe cartas com sleeve ou em top loader.

Para desenvolvedores

Compilar a partir do código-fonte

Você precisa do Rust, do Node.js 22 ou mais recente, dos pré-requisitos do Tauri para o seu sistema e do CMake com Clang para compilar o llama.cpp do modelo local.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # roda o programa com recarga automática
$ just install   # compila e instala localmente

O just é opcional; um Makefile tem os mesmos alvos. Para compilar sem o modelo local, rode cargo build --no-default-features em src-tauri/. Mais detalhes no README.

Referência

Atualizar ou desinstalar o Cardloader

Para atualizar, baixe a nova versão e instale do mesmo jeito, por cima da anterior. Suas sessões, configurações, token da API e modelos baixados são mantidos.

Sistema	Desinstalar
macOS	Arraste o Cardloader de Aplicativos para o Lixo.
Windows	Configurações → Aplicativos → Aplicativos instalados e depois Desinstalar no menu ⋯ do Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader` ou apague o AppImage.

Desinstalar remove só o programa. Suas sessões continuam na pasta de dados indicada abaixo até você apagá-la.

Referência

Onde o Cardloader guarda os seus dados

Sessões, miniaturas, digitalizações e sobreposições de graduação ficam no seu computador. As imagens originais das sessões de pasta nunca são alteradas nem movidas, e apagar uma sessão remove só os arquivos que o Cardloader criou.

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

Comece a escanear suas cartas de graça

Baixe o Cardloader para Windows, macOS ou Linux, aponte para uma pasta ou para o seu scanner e identifique o primeiro lote em minutos. Sem assinatura e sem cadastro.

Baixar o Cardloader Dar uma estrela no GitHub