Zainstaluj Cardloader i podłącz skaner do kart

Cardloader to darmowa aplikacja na komputer z systemem Windows, macOS lub Linux. Instalacja zajmuje minutę; do masowego skanowania na Fujitsu/Ricoh fi-8170 potrzebny jest jeszcze jeden sterownik.

Pobierz najnowsze wydanie Wszystkie wydania

Szybki start

Pobierz. Pobierz instalator dla swojego systemu z najnowszego wydania na GitHubie.
Zainstaluj. Zainstaluj Cardloader i otwórz go po raz pierwszy według instrukcji dla macOS, Windows lub Linux.
Wybierz silnik. Otwórz Settings i pobierz darmowy model lokalny albo wklej token API Ximilar, by uzyskać dokładne dopasowania, ceny i grading.
Podłącz skaner. Opcjonalnie: zainstaluj sterownik i podłącz fi-8170 lub inny skaner TWAIN albo SANE. Możesz też użyć monitorowanego folderu (Watch folder).
Sprawdź ustawienia skanowania. Skanuj dwustronnie z podajnika ADF w rozdzielczości 600 dpi, małymi stosami, z wyłączonym wykrywaniem podawania wielu arkuszy.
Utwórz sesję. Kliknij New session, wybierz folder lub skaner, określ, jak rozpoznawać i oceniać karty, a potem kliknij Create & run.
Sprawdź i wyeksportuj. Obserwuj, jak pojawiają się wyniki, popraw dowolne dopasowanie jednym kliknięciem i wyeksportuj sesję do CSV.

Krok 1

Pobierz program do skanowania kart na Windows, Mac i Linux

Cardloader 0.1.0 jest darmowy. Pobierz instalator dla swojego systemu i wykonaj kroki z instrukcji poniżej:

System	Pobieranie	Wymagania
macOS	.dmg	macOS 11 Big Sur lub nowszy, Apple silicon lub Intel
Windows	.exe lub .msi	Windows 10 lub 11, 64-bitowy
Linux	.AppImage, .deb lub .rpm	x86-64; pakiet .deb wymaga Ubuntu 22.04, Debiana 12 lub nowszych

Starsze wersje i informacje o zmianach znajdziesz w wydaniach na GitHubie. Instalatory są budowane z otwartego kodu źródłowego przez GitHub Actions.

macOS Windows Linux

Krok 2 · macOS

Zainstaluj Cardloader na Macu

Otwórz plik Cardloader_0.1.0_universal.dmg z folderu Pobrane rzeczy.
W oknie, które się pojawi, przeciągnij Cardloader na folder Aplikacje.
Otwórz Cardloader z folderu Aplikacje. Za pierwszym razem macOS poinformuje, że nie może zweryfikować, czy „Cardloader” jest wolny od złośliwego oprogramowania: zamknij ten komunikat.
Otwórz Ustawienia systemowe → Prywatność i ochrona, przewiń w dół do sekcji Ochrona i kliknij Otwórz mimo to obok komunikatu dotyczącego Cardloader.
Potwierdź hasłem lub Touch ID, a potem kliknij Otwórz. Od tej pory Cardloader uruchamia się jak każda inna aplikacja, a obraz dysku możesz już wysunąć.

macOS pyta, bo ta wczesna wersja nie jest jeszcze podpisana certyfikatem dewelopera Apple. W macOS 14 i starszych działa też kliknięcie aplikacji prawym przyciskiem i wybranie Otwórz. W Terminalu to samo robi polecenie xattr -dr com.apple.quarantine /Applications/Cardloader.app.

Krok 2 · Windows

Zainstaluj Cardloader w systemie Windows

Uruchom plik Cardloader_0.1.0_x64-setup.exe z folderu Pobrane.
Jeśli pojawi się niebieskie okno „System Windows ochronił ten komputer”, kliknij Więcej informacji, a potem Uruchom mimo to.
Przejdź przez kolejne kroki instalatora. Instaluje on Cardloader dla Twojego konta użytkownika, bez uprawnień administratora.
Uruchom Cardloader z menu Start.

SmartScreen ostrzega, bo ta wczesna wersja nie ma jeszcze podpisu cyfrowego. Jeśli na komputerze nie ma jeszcze Microsoft Edge WebView2, instalator go pobierze (Windows 11 ma go wbudowanego). Instalator .msi instaluje aplikację dla wszystkich użytkowników i wymaga uprawnień administratora. Oba zawierają pomocnika skanera TWAIN.

Krok 2 · Linux

Zainstaluj Cardloader w systemie Linux

Wybierz jeden pakiet. Otwórz terminal w folderze, do którego go pobrano:

Ubuntu, Debian, Linux Mint (.deb)

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

apt zainstaluje też WebKitGTK, którego potrzebuje Cardloader. Uruchom Cardloader z menu aplikacji albo poleceniem 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

Dowolna dystrybucja (AppImage)

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

Jeśli aplikacja się nie uruchamia, a komunikat wspomina o FUSE, zainstaluj libfuse2 (w Ubuntu 24.04: libfuse2t64).

Krok 3

Skonfiguruj lokalny model AI lub API Ximilar

Darmowy model lokalny (offline)

Otwórz Settings → Identification → Local model, zaakceptuj licencję modelu i kliknij pobieranie. Model ma ok. 330 MB, a pobieranie można wstrzymać i wznowić. Nowe sesje rozpoznają potem karty na Twoim komputerze, bez konta i bez internetu.

API Ximilar (opcjonalnie)

Aby uzyskać dokładne dopasowania z rozróżnieniem wariantów, poziomy pewności, ceny i grading, skopiuj token API z Ximilar App, wklej go w Settings i kliknij Test connection. Token jest przechowywany w systemowym pęku kluczy.

Rozpoznawanie przedmiotów kolekcjonerskich wymaga planu Ximilar Business lub wersji próbnej. Każda karta zużywa kredyty API: jedno wywołanie na rozpoznanie (dwa w trybie Auto) plus jedno na grading. Zobacz cennik Ximilar.

Krok 4

Podłącz skaner Fujitsu / Ricoh fi-8170

Cardloader bezpośrednio steruje skanerem RICOH (dawniej Fujitsu) fi-8170, a także każdym skanerem TWAIN 2.x z podajnikiem dokumentów w Windows i każdym skanerem SANE w macOS i Linux. Podłącz skaner przez USB i zainstaluj sterownik dla swojego systemu:

System	Co zainstalować	Jak Cardloader się z nim łączy
Windows	PaperStream IP (TWAIN) dla fi-8170	Dołączony pomocnik TWAIN działa w osobnym procesie, więc zawieszony sterownik nigdy nie zamrozi aplikacji
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (lub pakiet SANE z Twojej dystrybucji); opcjonalnie sterownik RICOH `pfufs`	SANE `scanimage`

Aby sprawdzić skaner poza aplikacją Cardloader, uruchom scanimage -L w macOS lub Linux albo otwórz go w PaperStream Capture w Windows.
Port sieciowy fi-8170 działa tylko przez PaperStream w Windows; skaner nie obsługuje eSCL/AirScan.
ScanSnap i inne skanery: modele ScanSnap nie mają sterownika TWAIN. Ustaw ich własny program tak, by zapisywał obrazy do folderu, i utwórz sesję Watch folder (monitorowany folder); Cardloader przeanalizuje każdy obraz, gdy tylko się pojawi.

Krok 5

Jak masowo skanować karty kolekcjonerskie: zalecane ustawienia

Domyślne ustawienia skanera w Cardloader są dobrane do standardowych kart kolekcjonerskich o wymiarach 63 × 88 mm:

Skanowanie dwustronne z podajnika ADF, więc przód i tył każdej karty są skanowane i łączone w pary w jednym przebiegu.
600 dpi, w kolorze, co wystarcza do odczytu numerów kart i do gradingu.
Obszar skanowania 66 × 92 mm, nieco większy niż karta, więc krawędzie nigdy nie zostają obcięte.
Wykrywanie podawania wielu arkuszy wyłączone: przy sztywnych kartach skaner fałszywie zgłasza podanie wielu arkuszy.
Zacznij od małych stosów po ok. 10 kart i nie podawaj kart w koszulkach ani w toploaderach.

Dla programistów

Kompilacja ze źródeł

Potrzebujesz: Rust, Node.js 22 lub nowszy, wymagania wstępne Tauri dla swojego systemu oraz CMake z Clang, aby skompilować llama.cpp dla modelu lokalnego.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # uruchom aplikację z hot reload
$ just install   # zbuduj i zainstaluj lokalnie

just jest opcjonalny; Makefile ma te same cele. Aby zbudować aplikację bez modelu lokalnego, uruchom cargo build --no-default-features w src-tauri/. Więcej w README.

Informacje

Aktualizacja i odinstalowanie Cardloader

Aby zaktualizować aplikację, pobierz nową wersję i zainstaluj ją tak samo, na poprzednią. Twoje sesje, ustawienia, token API i pobrane modele zostaną zachowane.

System	Odinstalowanie
macOS	Przeciągnij Cardloader z folderu Aplikacje do Kosza.
Windows	Ustawienia → Aplikacje → Zainstalowane aplikacje, a potem Odinstaluj w menu ⋯ przy Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader` albo usuń plik AppImage.

Odinstalowanie usuwa tylko aplikację. Twoje sesje zostają w folderze danych opisanym niżej, dopóki go nie usuniesz.

Informacje

Gdzie Cardloader przechowuje Twoje dane

Sesje, miniatury, skany i nakładki z gradingu zostają na Twoim komputerze. Oryginalne obrazy w sesjach z folderu nigdy nie są zmieniane ani przenoszone, a usunięcie sesji kasuje tylko pliki utworzone przez Cardloader.

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

Zacznij skanować swoje karty za darmo

Pobierz Cardloader na Windows, macOS lub Linux, wskaż folder albo swój skaner i rozpoznaj pierwszą partię kart w kilka minut. Bez abonamentu i bez zakładania konta.

Pobierz Cardloader Daj gwiazdkę na GitHubie