Nainstalujte Cardloader a připojte skener karet

Cardloader je desktopová aplikace zdarma pro Windows, macOS a Linux. Instalace zabere minutu; k hromadnému skenování se skenerem Fujitsu/Ricoh fi-8170 stačí doinstalovat ovladač.

Stáhnout nejnovější verzi Všechna vydání

Rychlý start

Stažení. Stáhněte si instalátor pro svůj systém z nejnovějšího vydání na GitHubu.
Instalace. Nainstalujte Cardloader a poprvé ho spusťte podle návodu pro macOS, Windows nebo Linux.
Výběr rozpoznávání. Otevřete Settings a stáhněte lokální model zdarma, nebo vložte svůj token pro Ximilar API kvůli přesným shodám, cenám a gradingu.
Připojení skeneru. Volitelné: nainstalujte ovladač a připojte fi-8170 nebo jiný skener TWAIN či SANE, případně použijte sledovanou složku.
Kontrola nastavení skenování. Skenujte oboustranně přes ADF při 600 dpi, s vypnutou detekcí vícenásobného podání a po malých stozích.
Vytvoření relace. Klikněte na New session, vyberte složku nebo skener, zvolte, jak karty rozpoznat a ohodnotit, a klikněte na Create & run.
Kontrola a export. Sledujte, jak přibývají výsledky, jedním kliknutím opravte případnou shodu a relaci vyexportujte do CSV.

Krok 1

Stáhněte si software na skenování karet pro Windows, Mac a Linux

Cardloader 0.1.0 je zdarma. Stáhněte si instalátor pro svůj systém a pak postupujte podle návodu níže:

Systém	Ke stažení	Požadavky
macOS	.dmg	macOS 11 Big Sur nebo novější, Apple silicon nebo Intel
Windows	.exe nebo .msi	Windows 10 nebo 11, 64bitový
Linux	.AppImage, .deb nebo .rpm	x86-64; balíček .deb vyžaduje Ubuntu 22.04, Debian 12 nebo novější

Starší verze a poznámky k vydání najdete na GitHub Releases. Instalátory sestavuje GitHub Actions přímo z open source kódu.

macOS Windows Linux

Krok 2 · macOS

Instalace Cardloaderu na Mac

Otevřete Cardloader_0.1.0_universal.dmg ze složky Stažené soubory.
V okně, které se objeví, přetáhněte Cardloader do složky Aplikace.
Otevřete Cardloader ze složky Aplikace. Poprvé macOS ohlásí, že nemůže ověřit, zda „Cardloader“ neobsahuje malware: klikněte na Hotovo.
Otevřete Nastavení systému → Soukromí a zabezpečení, sjeďte dolů k části Zabezpečení a u zprávy o Cardloaderu klikněte na Přesto otevřít.
Potvrďte heslem nebo Touch ID a klikněte na Otevřít. Od teď se Cardloader spouští jako každá jiná aplikace a obraz disku můžete vysunout.

macOS se ptá, protože tato raná verze ještě není podepsaná vývojářským certifikátem Apple. V macOS 14 a starším funguje i kliknutí pravým tlačítkem na aplikaci a volba Otevřít. V Terminálu udělá totéž xattr -dr com.apple.quarantine /Applications/Cardloader.app.

Krok 2 · Windows

Instalace Cardloaderu ve Windows

Spusťte Cardloader_0.1.0_x64-setup.exe ze složky Stažené soubory.
Pokud se objeví modré okno „Systém Windows ochránil váš počítač“, klikněte na Další informace a pak na Přesto spustit.
Proklikejte se instalátorem. Cardloader se nainstaluje pro váš uživatelský účet, bez práv správce.
Spusťte Cardloader z nabídky Start.

SmartScreen varuje, protože tato raná verze ještě nemá podepsaný kód. Pokud v počítači chybí Microsoft Edge WebView2, instalátor ho stáhne (ve Windows 11 už je). Balíček .msi instaluje pro všechny uživatele a vyžaduje práva správce. Pomocný program TWAIN pro skener obsahují oba.

Krok 2 · Linux

Instalace Cardloaderu v Linuxu

Vyberte jeden balíček. Otevřete terminál ve složce, kam jste ho stáhli:

Ubuntu, Debian, Linux Mint (.deb)

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

apt doinstaluje i WebKitGTK, který Cardloader potřebuje. Cardloader pak spustíte z nabídky aplikací nebo příkazem 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

Jakákoli distribuce (AppImage)

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

Pokud se nespustí a hlásí něco o FUSE, nainstalujte libfuse2 (v Ubuntu 24.04 libfuse2t64).

Krok 3

Nastavení lokálního AI modelu nebo Ximilar API

Lokální model zdarma (offline)

Otevřete Settings → Identification → Local model, přijměte licenci modelu a klikněte na stažení. Model má asi 330 MB a stahování lze pozastavit a obnovit. Nové relace pak rozpoznávají karty na vašem počítači, bez účtu a bez internetu.

Ximilar API (volitelné)

Pro přesné shody i mezi variantami, míru jistoty, ceny a grading zkopírujte svůj API token z Ximilar App, vložte ho do Settings a klikněte na Test connection. Token se uloží do systémové klíčenky.

Rozpoznávání sběratelských předmětů vyžaduje tarif Ximilar Business nebo zkušební verzi. Každá karta stojí API kredity: jedno volání za rozpoznání (v režimu Auto dvě) plus jedno za grading. Viz ceník Ximilar.

Krok 4

Připojení skeneru Fujitsu / Ricoh fi-8170

Cardloader přímo ovládá RICOH (dříve Fujitsu) fi-8170 a také jakýkoli skener TWAIN 2.x s podavačem dokumentů ve Windows nebo skener SANE v macOS a Linuxu. Připojte skener přes USB a nainstalujte ovladač pro svůj systém:

Systém	Co nainstalovat	Jak s ním Cardloader komunikuje
Windows	PaperStream IP (TWAIN) pro fi-8170	Přibalený pomocný program TWAIN ve vlastním procesu, takže zaseknutý ovladač aplikaci nikdy nezamrazí
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (nebo balíček SANE vaší distribuce); volitelně ovladač `pfufs` od RICOH	SANE `scanimage`

Skener mimo Cardloader vyzkoušíte příkazem scanimage -L v macOS nebo Linuxu, ve Windows v programu PaperStream Capture.
Síťový port fi-8170 funguje jen přes PaperStream ve Windows; eSCL/AirScan skener nepodporuje.
ScanSnap a další skenery: modely ScanSnap nemají ovladač TWAIN. Nechte jejich vlastní software ukládat do složky a vytvořte relaci typu Watch folder; Cardloader analyzuje každý obrázek hned, jak dorazí.

Krok 5

Jak hromadně skenovat sběratelské karty: doporučené nastavení

Výchozí nastavení skeneru v Cardloaderu je vyladěné pro standardní sběratelské karty o rozměru 63 × 88 mm:

Oboustranné skenování přes ADF, takže se přední i zadní strana každé karty naskenuje a spáruje v jednom průchodu.
600 dpi, barevně, což stačí na čísla karet i grading.
Rámeček 66 × 92 mm, o něco větší než karta, takže se okraje nikdy neoříznou.
Vypnutá detekce vícenásobného podání: tuhé karty spouštějí falešná hlášení vícenásobného podání.
Začněte malými stohy kolem 10 karet a nevkládejte karty v obalech ani v toploaderech.

Pro vývojáře

Sestavení ze zdrojového kódu

Potřebujete Rust, Node.js 22 nebo novější, prerekvizity Tauri pro svůj systém a CMake s Clangem pro kompilaci llama.cpp kvůli lokálnímu modelu.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # spustí aplikaci s hot reloadem
$ just install   # sestaví a nainstaluje lokálně

just je volitelný; Makefile má stejné cíle. Bez lokálního modelu sestavíte aplikaci příkazem cargo build --no-default-features ve složce src-tauri/. Víc najdete v README.

Příručka

Aktualizace a odinstalace Cardloaderu

Při aktualizaci stáhněte novou verzi a nainstalujte ji stejně jako předtím, přes tu starou. Vaše relace, nastavení, API token i stažené modely zůstanou zachované.

Systém	Odinstalace
macOS	Přetáhněte Cardloader ze složky Aplikace do Koše.
Windows	Nastavení → Aplikace → Nainstalované aplikace, pak v nabídce ⋯ u Cardloaderu zvolte Odinstalovat.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader`, nebo smažte soubor AppImage.

Odinstalace odstraní jen aplikaci. Vaše relace zůstanou v datové složce uvedené níže, dokud ji nesmažete.

Příručka

Kde Cardloader ukládá vaše data

Relace, náhledy, skeny a překryvy z gradingu zůstávají ve vašem počítači. Původní obrázky v relacích ze složky se nikdy neupravují ani nepřesouvají a smazání relace odstraní jen soubory, které vytvořil Cardloader.

Systém	Složka
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

Začněte skenovat své karty zdarma

Stáhněte si Cardloader pro Windows, macOS nebo Linux, nasměrujte ho na složku nebo skener a první várku karet máte rozpoznanou za pár minut. Bez předplatného a bez účtu.

Stáhnout Cardloader Dát hvězdu na GitHubu