Instal Cardloader dan hubungkan scanner kartumu

Cardloader adalah aplikasi desktop gratis untuk Windows, macOS, dan Linux. Instalasinya cuma butuh satu menit; untuk menghubungkan Fujitsu/Ricoh fi-8170 agar bisa scan kartu dalam jumlah banyak, kamu hanya perlu satu driver tambahan.

Unduh rilis terbaru Semua rilis

Mulai cepat

Unduh. Unduh installer untuk sistem operasimu dari rilis GitHub terbaru.
Instal. Instal Cardloader lalu buka untuk pertama kali, dengan mengikuti panduan untuk macOS, Windows, atau Linux.
Pilih mesin. Buka Settings dan unduh model lokal yang gratis, atau tempel token API Ximilar-mu untuk hasil cocok yang persis, harga, dan grading.
Hubungkan scanner. Opsional: instal driver dan hubungkan fi-8170 atau scanner TWAIN maupun SANE lainnya, atau gunakan Watch folder (folder pantau).
Periksa pengaturan scan. Scan dengan ADF duplex pada 600 dpi, deteksi multifeed dimatikan, dan dalam tumpukan kecil.
Buat sesi. Klik New session, pilih folder atau scanner-mu, tentukan cara mengidentifikasi kartu dan melakukan grading, lalu klik Create & run.
Periksa dan ekspor. Lihat hasilnya bermunculan, perbaiki hasil cocok mana pun dengan satu klik, lalu ekspor sesi ke CSV.

Langkah 1

Unduh software scan kartu untuk Windows, Mac, dan Linux

Cardloader 0.1.0 gratis. Unduh installer untuk sistem operasimu, lalu ikuti panduannya di bawah:

Sistem	Unduh	Persyaratan
macOS	.dmg	macOS 11 Big Sur atau yang lebih baru, Apple silicon atau Intel
Windows	.exe atau .msi	Windows 10 atau 11, 64-bit
Linux	.AppImage, .deb atau .rpm	x86-64; paket .deb butuh Ubuntu 22.04, Debian 12, atau yang lebih baru

Versi lama dan catatan rilis ada di rilis GitHub. Installer-nya di-build oleh GitHub Actions dari kode open source.

macOS Windows Linux

Langkah 2 · macOS

Instal Cardloader di Mac

Buka Cardloader_0.1.0_universal.dmg dari folder Unduhan.
Di jendela yang muncul, seret Cardloader ke folder Aplikasi.
Buka Cardloader dari folder Aplikasi. Saat pertama kali, macOS akan bilang tidak dapat memverifikasi bahwa “Cardloader” bebas malware: klik Selesai.
Buka Pengaturan Sistem → Privasi & Keamanan, gulir ke bawah ke Keamanan, lalu klik Tetap Buka di samping pesan tentang Cardloader.
Konfirmasi dengan kata sandi atau Touch ID, lalu klik Buka. Mulai sekarang Cardloader terbuka seperti aplikasi lainnya, dan kamu bisa mengeluarkan image disk-nya.

macOS menanyakan ini karena build awal ini belum ditandatangani dengan sertifikat developer Apple. Di macOS 14 dan sebelumnya, klik kanan aplikasinya lalu pilih Buka juga bisa. Di Terminal, xattr -dr com.apple.quarantine /Applications/Cardloader.app melakukan hal yang sama.

Langkah 2 · Windows

Instal Cardloader di Windows

Jalankan Cardloader_0.1.0_x64-setup.exe dari folder tempat kamu mengunduhnya.
Jika muncul jendela biru SmartScreen, klik Info selengkapnya, lalu Tetap jalankan.
Ikuti langkah-langkah installer sampai selesai. Cardloader diinstal untuk akun penggunamu, tanpa hak administrator.
Buka Cardloader dari menu Mulai.

SmartScreen memberi peringatan karena build awal ini belum ditandatangani secara digital. Installer akan mengunduh Microsoft Edge WebView2 jika PC-mu belum punya (Windows 11 sudah punya). File .msi menginstal untuk semua pengguna dan membutuhkan hak administrator. Helper scanner TWAIN sudah disertakan di keduanya.

Langkah 2 · Linux

Instal Cardloader di Linux

Pilih satu paket. Buka terminal di folder tempat kamu mengunduhnya:

Ubuntu, Debian, Linux Mint (.deb)

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

apt juga menginstal WebKitGTK yang dibutuhkan Cardloader. Buka Cardloader dari menu aplikasi, atau jalankan 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

Distribusi apa pun (AppImage)

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

Jika tidak mau jalan dan muncul pesan tentang FUSE, instal libfuse2 (di Ubuntu 24.04, libfuse2t64).

Langkah 3

Siapkan model AI lokal atau API Ximilar

Model lokal gratis (offline)

Buka Settings → Identification → Local model, setujui lisensi modelnya, lalu klik unduh. Ukurannya sekitar 330 MB dan unduhannya bisa dijeda serta dilanjutkan. Setelah itu, sesi baru akan mengenali kartu di komputermu, tanpa akun dan tanpa internet.

API Ximilar (opsional)

Untuk hasil cocok yang persis di antara varian, skor tingkat keyakinan, harga, dan grading, salin token API-mu dari Ximilar App, tempel ke Settings, lalu klik Test connection. Token disimpan di keychain sistemmu.

Pengenalan barang koleksi membutuhkan paket Business Ximilar atau masa uji coba. Setiap kartu memakai kredit API: satu panggilan per pengenalan (dua di mode Auto), ditambah satu per grading. Lihat harga Ximilar.

Langkah 4

Hubungkan scanner Fujitsu / Ricoh fi-8170

Cardloader mengendalikan RICOH (dulu Fujitsu) fi-8170 secara langsung, juga scanner TWAIN 2.x apa pun yang punya ADF di Windows, atau scanner SANE di macOS dan Linux. Hubungkan scanner lewat USB, lalu instal driver untuk sistem operasimu:

Sistem	Yang perlu diinstal	Cara Cardloader berkomunikasi dengannya
Windows	PaperStream IP (TWAIN) untuk fi-8170	Helper TWAIN bawaan, berjalan di proses terpisah sehingga driver yang macet tidak pernah membuat aplikasi hang
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (atau paket SANE dari distribusimu); opsional driver `pfufs` dari RICOH	SANE `scanimage`

Untuk mengecek scanner di luar Cardloader, jalankan scanimage -L di macOS atau Linux, atau buka scanner-nya di PaperStream Capture di Windows.
Port jaringan fi-8170 hanya berfungsi lewat PaperStream di Windows; scanner ini tidak mendukung eSCL/AirScan.
ScanSnap dan scanner lain: model ScanSnap tidak punya driver TWAIN. Biarkan software bawaannya menyimpan ke sebuah folder, lalu buat sesi Watch folder (folder pantau); Cardloader menganalisis setiap gambar begitu masuk.

Langkah 5

Cara scan kartu koleksi dalam jumlah banyak: pengaturan yang disarankan

Pengaturan bawaan scanner di Cardloader disesuaikan untuk kartu koleksi standar berukuran 63 × 88 mm:

ADF duplex, agar sisi depan dan belakang setiap kartu di-scan dan dipasangkan dalam sekali jalan.
600 dpi, berwarna, cukup untuk membaca nomor kartu dan untuk grading.
Bingkai 66 × 92 mm, sedikit lebih besar dari kartunya, agar tepinya tidak pernah terpotong.
Deteksi multifeed dimatikan: kartu yang kaku membuat scanner keliru mendeteksi multifeed.
Mulailah dengan tumpukan kecil sekitar 10 kartu, dan jangan memasukkan kartu yang memakai sleeve atau toploader.

Untuk developer

Build dari kode sumber

Kamu membutuhkan Rust, Node.js 22 atau yang lebih baru, prasyarat Tauri untuk sistem operasimu, serta CMake dengan Clang untuk meng-compile llama.cpp bagi model lokal.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # jalankan aplikasi dengan hot reload
$ just install   # build dan instal secara lokal

just bersifat opsional; Makefile punya target yang sama. Untuk build tanpa model lokal, jalankan cargo build --no-default-features di src-tauri/. Selengkapnya ada di README.

Referensi

Perbarui atau copot Cardloader

Untuk memperbarui, unduh versi baru dan instal dengan cara yang sama, menimpa versi lama. Sesi, pengaturan, token API, dan model yang sudah diunduh tetap tersimpan.

Sistem	Copot
macOS	Seret Cardloader dari folder Aplikasi ke Tong Sampah.
Windows	Pengaturan → Aplikasi → Aplikasi terinstal, lalu pilih Hapus instalan di menu ⋯ Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader`, atau hapus file AppImage-nya.

Mencopot hanya menghapus aplikasinya. Sesi-sesimu tetap ada di folder data di bawah sampai kamu menghapusnya.

Referensi

Tempat Cardloader menyimpan datamu

Sesi, thumbnail, hasil scan, dan overlay grading tetap tersimpan di komputermu. Gambar asli dalam sesi folder tidak pernah diubah atau dipindahkan, dan menghapus sebuah sesi hanya menghapus file yang dibuat oleh Cardloader.

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

Mulai scan kartumu secara gratis

Unduh Cardloader untuk Windows, macOS, atau Linux, arahkan ke sebuah folder atau ke scanner-mu, dan kenali tumpukan kartu pertamamu dalam hitungan menit. Tanpa langganan, tanpa akun.

Unduh Cardloader Beri bintang di GitHub