I-install ang Cardloader at ikonekta ang card scanner mo

Ang Cardloader ay libreng desktop app para sa Windows, macOS at Linux. Isang minuto lang ang pag-install; isang driver pa ang kailangan para ikonekta ang Fujitsu/Ricoh fi-8170 para sa bulk scanning.

I-download ang pinakabagong release Lahat ng release

Mabilisang simula

I-download. I-download ang installer para sa system mo mula sa pinakabagong release sa GitHub.
I-install. I-install ang Cardloader at buksan ito sa unang pagkakataon, ayon sa gabay para sa macOS, Windows o Linux.
Pumili ng engine. Buksan ang Settings at i-download ang libreng local model, o i-paste ang Ximilar API token mo para sa eksaktong match, presyo at grading.
Ikonekta ang scanner. Opsyonal: i-install ang driver at ikonekta ang fi-8170 o ibang TWAIN o SANE scanner, o gumamit ng watch folder.
Suriin ang scan settings. Mag-scan sa ADF duplex sa 600 dpi, naka-off ang multifeed detection, nang paunti-unting patong.
Gumawa ng session. I-click ang New session, pumili ng folder o ng scanner mo, piliin kung paano kikilalanin at iga-grade ang mga card, at i-click ang Create & run.
Suriin at i-export. Panoorin ang paglabas ng mga resulta, ayusin ang kahit anong match sa isang click at i-export ang session sa CSV.

Hakbang 1

I-download ang card scanner software para sa Windows, Mac at Linux

Libre ang Cardloader 0.1.0. I-download ang installer para sa system mo, at sundin ang gabay nito sa ibaba:

System	Download	Mga kailangan
macOS	.dmg	macOS 11 Big Sur o mas bago, Apple silicon o Intel
Windows	.exe o .msi	Windows 10 o 11, 64-bit
Linux	.AppImage, .deb o .rpm	x86-64; kailangan ng .deb ang Ubuntu 22.04, Debian 12 o mas bago

Nasa GitHub releases ang mga lumang bersyon at ang release notes. Binubuo ng GitHub Actions ang mga installer mula sa open-source na code.

macOS Windows Linux

Hakbang 2 · macOS

I-install ang Cardloader sa Mac

Buksan ang Cardloader_0.1.0_universal.dmg mula sa Downloads folder mo.
Sa lalabas na window, i-drag ang Cardloader papunta sa folder na Applications.
Buksan ang Cardloader mula sa folder na Applications. Sa unang pagkakataon, sasabihin ng macOS na hindi nito ma-verify na walang malware ang “Cardloader”: i-click ang Done.
Buksan ang System Settings → Privacy & Security, mag-scroll pababa sa Security at i-click ang Open Anyway sa tabi ng mensahe tungkol sa Cardloader.
Kumpirmahin gamit ang password mo o Touch ID, at i-click ang Open. Mula ngayon, magbubukas ang Cardloader gaya ng ibang app, at puwede mo nang i-eject ang disk image.

Nagtatanong ang macOS dahil hindi pa naka-sign ng Apple developer certificate ang maagang build na ito. Sa macOS 14 at mas luma, gumagana rin ang pag-right-click sa app at pagpili ng Open. Sa Terminal, ganoon din ang ginagawa ng xattr -dr com.apple.quarantine /Applications/Cardloader.app.

Hakbang 2 · Windows

I-install ang Cardloader sa Windows

Patakbuhin ang Cardloader_0.1.0_x64-setup.exe mula sa Downloads folder mo.
Kung lumabas ang asul na window na “Windows protected your PC”, i-click ang More info, pagkatapos ang Run anyway.
Sundan ang mga hakbang ng installer. Ini-install nito ang Cardloader para sa user account mo, nang walang administrator rights.
Buksan ang Cardloader mula sa Start menu.

Nagbababala ang SmartScreen dahil hindi pa code-signed ang maagang build na ito. Dina-download ng installer ang Microsoft Edge WebView2 kung wala pa nito ang PC (mayroon na ang Windows 11). Ini-install ng .msi ang app para sa lahat ng user at kailangan nito ng administrator rights. Kasama sa dalawa ang TWAIN helper para sa scanner.

Hakbang 2 · Linux

I-install ang Cardloader sa Linux

Pumili ng isang package. Magbukas ng terminal sa folder kung saan mo ito na-download:

Ubuntu, Debian, Linux Mint (.deb)

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

Ini-install din ng apt ang WebKitGTK, na kailangan ng Cardloader. Buksan ang Cardloader mula sa applications menu mo, o patakbuhin ang 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

Kahit anong distribution (AppImage)

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

Kung hindi ito magbukas at may binabanggit na FUSE, i-install ang libfuse2 (sa Ubuntu 24.04, libfuse2t64).

Hakbang 3

I-set up ang local AI model o ang Ximilar API

Libreng local model (offline)

Buksan ang Settings → Identification → Local model, tanggapin ang lisensya ng model at i-click ang download. Mga 330 MB ito at puwedeng i-pause at ituloy. Pagkatapos nito, kikilalanin ng mga bagong session ang mga card sa computer mo, nang walang account at walang internet.

Ximilar API (opsyonal)

Para sa eksaktong match kahit sa mga variant, confidence score, presyo at grading, kopyahin ang API token mo mula sa Ximilar App, i-paste ito sa Settings at i-click ang Test connection. Itinatago ang token sa keychain ng system mo.

Kailangan ng Ximilar Business plan o trial para sa pagkilala ng collectibles. Gumagamit ng API credits ang bawat card: isang call kada pagkilala (dalawa sa Auto mode) at isa pa kada grading. Tingnan ang presyo ng Ximilar.

Hakbang 4

Ikonekta ang Fujitsu / Ricoh fi-8170 scanner

Direktang pinapatakbo ng Cardloader ang RICOH (dating Fujitsu) fi-8170, at kahit anong TWAIN 2.x scanner na may document feeder sa Windows o SANE scanner sa macOS at Linux. Ikonekta ang scanner sa USB at i-install ang driver para sa system mo:

System	Ano ang i-install	Paano ito kinakausap ng Cardloader
Windows	PaperStream IP (TWAIN) para sa fi-8170	Kasamang TWAIN helper, sa sarili nitong proseso para hindi kailanman ma-freeze ang app dahil sa na-stuck na driver
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (o ang SANE package ng distribution mo); opsyonal ang `pfufs` driver ng RICOH	SANE `scanimage`

Para subukan ang scanner sa labas ng Cardloader, patakbuhin ang scanimage -L sa macOS o Linux, o buksan ito sa PaperStream Capture sa Windows.
Gumagana lang ang network port ng fi-8170 sa pamamagitan ng PaperStream sa Windows; hindi sinusuportahan ng scanner ang eSCL/AirScan.
ScanSnap at ibang scanner: walang TWAIN driver ang mga ScanSnap model. Hayaang mag-save ang sarili nilang software sa isang folder at gumawa ng session na Watch folder; susuriin ng Cardloader ang bawat larawan pagdating nito.

Hakbang 5

Paano mag-bulk scan ng trading card: inirerekomendang settings

Nakaayos ang default na scanner settings ng Cardloader para sa karaniwang 63 × 88 mm na trading card:

ADF duplex, para ma-scan at maipares ang harap at likod ng bawat card sa iisang pasada.
600 dpi, de-kolor, na sapat para sa collector number at grading.
66 × 92 mm na frame, bahagyang mas malaki kaysa sa card, para hindi kailanman maputol ang edges.
Naka-off ang multifeed detection: nagdudulot ang matitigas na card ng maling double-feed error.
Magsimula sa maliliit na patong na mga 10 card, at huwag ipasok ang mga card na naka-sleeve o naka-top loader.

Para sa mga developer

Mag-build mula sa source

Kailangan mo ng Rust, Node.js 22 o mas bago, ang Tauri prerequisites para sa system mo, at CMake na may Clang para i-compile ang llama.cpp para sa local model.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # patakbuhin ang app nang may hot reload
$ just install   # i-build at i-install nang lokal

Opsyonal ang just; may Makefile na may parehong mga target. Para mag-build nang walang local model, patakbuhin ang cargo build --no-default-features sa src-tauri/. Higit pa sa README.

Sanggunian

I-update o i-uninstall ang Cardloader

Para mag-update, i-download ang bagong bersyon at i-install ito sa parehong paraan, sa ibabaw ng luma. Mananatili ang mga session, settings, API token at mga na-download na model mo.

System	Pag-uninstall
macOS	I-drag ang Cardloader mula sa Applications papunta sa Bin.
Windows	Settings → Apps → Installed apps, pagkatapos ang Uninstall sa ⋯ menu ng Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader`, o burahin ang AppImage.

Ang app lang ang inaalis ng pag-uninstall. Mananatili ang mga session mo sa data folder sa ibaba hangga’t hindi mo ito binubura.

Sanggunian

Kung saan itinatago ng Cardloader ang data mo

Nananatili sa computer mo ang mga session, thumbnail, scan at grading overlay. Hindi kailanman binabago o inililipat ang mga orihinal na larawan sa mga folder session, at ang mga file lang na ginawa ng Cardloader ang binubura kapag binura mo ang isang session.

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

Simulang i-scan ang mga card mo nang libre

I-download ang Cardloader para sa Windows, macOS o Linux, ituro ito sa isang folder o sa scanner mo, at makilala ang unang batch mo sa loob ng ilang minuto. Walang subscription, walang account.

I-download ang Cardloader Bigyan ng star sa GitHub