Cài đặt Cardloader và kết nối máy scan thẻ của bạn

Cardloader là ứng dụng máy tính miễn phí cho Windows, macOS và Linux. Cài đặt chỉ mất một phút; để kết nối máy Fujitsu/Ricoh fi-8170 quét số lượng lớn, bạn chỉ cần cài thêm một driver.

Tải bản mới nhất Tất cả bản phát hành

Bắt đầu nhanh

Tải về. Tải trình cài đặt cho hệ điều hành của bạn từ bản phát hành mới nhất trên GitHub.
Cài đặt. Cài đặt Cardloader và mở lần đầu theo hướng dẫn cho macOS, Windows hoặc Linux.
Chọn bộ nhận diện. Mở Settings và tải mô hình cục bộ miễn phí, hoặc dán token Ximilar API của bạn để có kết quả khớp chính xác, giá và chấm điểm.
Kết nối máy scan. Tùy chọn: cài driver rồi kết nối fi-8170 hoặc một máy scan TWAIN hay SANE khác, hoặc dùng Watch folder (thư mục theo dõi).
Kiểm tra cài đặt quét. Quét hai mặt qua ADF ở 600 dpi, tắt phát hiện nạp chồng (multifeed) và quét từng xấp nhỏ.
Tạo phiên. Nhấp New session, chọn một thư mục hoặc máy scan của bạn, chọn cách nhận diện và chấm điểm thẻ, rồi nhấp Create & run.
Kiểm tra và xuất. Xem kết quả hiện ra, sửa bất kỳ kết quả khớp nào chỉ với một cú nhấp và xuất phiên ra CSV.

Bước 1

Tải phần mềm quét thẻ cho Windows, Mac và Linux

Cardloader 0.1.0 miễn phí. Hãy tải trình cài đặt cho hệ điều hành của bạn, rồi làm theo hướng dẫn tương ứng bên dưới:

Hệ điều hành	Tải về	Yêu cầu
macOS	.dmg	macOS 11 Big Sur trở lên, Mac chip Apple hoặc Intel
Windows	.exe hoặc .msi	Windows 10 hoặc 11, 64-bit
Linux	.AppImage, .deb hoặc .rpm	x86-64; gói .deb cần Ubuntu 22.04, Debian 12 trở lên

Các phiên bản cũ hơn và ghi chú phát hành có trên trang bản phát hành GitHub. Trình cài đặt được GitHub Actions build từ mã nguồn mở.

macOS Windows Linux

Bước 2 · macOS

Cài đặt Cardloader trên máy Mac

Mở Cardloader_0.1.0_universal.dmg trong thư mục Tải về.
Trong cửa sổ hiện ra, kéo Cardloader vào thư mục Ứng dụng.
Mở Cardloader từ thư mục Ứng dụng. Lần đầu, macOS sẽ báo không thể xác minh “Cardloader” không chứa phần mềm độc hại: hãy nhấp Xong.
Mở Cài đặt hệ thống → Quyền riêng tư & Bảo mật, cuộn xuống mục Bảo mật và nhấp Vẫn mở bên cạnh thông báo về Cardloader.
Xác nhận bằng mật khẩu hoặc Touch ID, rồi nhấp Mở. Từ nay Cardloader khởi động như mọi ứng dụng khác, và bạn có thể đẩy ảnh đĩa ra.

macOS hỏi vì bản build đầu tiên này chưa được ký bằng chứng chỉ nhà phát triển của Apple. Trên macOS 14 trở về trước, bạn cũng có thể nhấp chuột phải vào ứng dụng và chọn Mở. Trong Terminal, lệnh xattr -dr com.apple.quarantine /Applications/Cardloader.app cũng có tác dụng tương tự.

Bước 2 · Windows

Cài đặt Cardloader trên Windows

Chạy Cardloader_0.1.0_x64-setup.exe trong thư mục Tải xuống.
Nếu cửa sổ SmartScreen màu xanh hiện ra, hãy nhấp Thông tin thêm, rồi nhấp Vẫn chạy.
Nhấp qua các bước của trình cài đặt. Cardloader được cài cho tài khoản người dùng của bạn, không cần quyền quản trị viên.
Mở Cardloader từ menu Bắt đầu.

SmartScreen cảnh báo vì bản build đầu tiên này chưa được ký mã. Trình cài đặt sẽ tải Microsoft Edge WebView2 về nếu máy chưa có (Windows 11 đã có sẵn). Tệp .msi cài cho mọi người dùng và cần quyền quản trị viên. Cả hai đều có sẵn trình hỗ trợ máy scan TWAIN.

Bước 2 · Linux

Cài đặt Cardloader trên Linux

Chọn một gói. Mở terminal trong thư mục bạn đã tải gói về:

Ubuntu, Debian, Linux Mint (.deb)

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

apt cài luôn cả WebKitGTK mà Cardloader cần. Mở Cardloader từ menu ứng dụng, hoặc chạy 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

Mọi bản phân phối (AppImage)

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

Nếu ứng dụng không khởi động và báo lỗi liên quan đến FUSE, hãy cài libfuse2 (trên Ubuntu 24.04 là libfuse2t64).

Bước 3

Thiết lập mô hình AI cục bộ hoặc Ximilar API

Mô hình cục bộ miễn phí (offline)

Mở Settings → Identification → Local model, chấp nhận giấy phép của mô hình và nhấp tải về. Mô hình nặng khoảng 330 MB, có thể tạm dừng và tải tiếp. Sau đó các phiên mới sẽ nhận diện thẻ ngay trên máy tính của bạn, không cần tài khoản, không cần internet.

Ximilar API (tùy chọn)

Để có kết quả khớp chính xác giữa các biến thể, độ tin cậy, giá và chấm điểm, hãy sao chép token API của bạn từ Ximilar App, dán vào Settings và nhấp Test connection. Token được lưu trong kho khóa (keychain) của hệ thống.

Nhận diện đồ sưu tầm cần gói Business của Ximilar hoặc bản dùng thử. Mỗi thẻ tốn credit API: một lượt gọi cho mỗi lần nhận diện (hai lượt ở chế độ Auto) cộng một lượt cho mỗi lần chấm điểm. Xem bảng giá Ximilar.

Bước 4

Kết nối máy scan Fujitsu / Ricoh fi-8170

Cardloader điều khiển trực tiếp máy RICOH (trước đây là Fujitsu) fi-8170, cùng mọi máy scan TWAIN 2.x có khay nạp tài liệu trên Windows hoặc máy scan SANE trên macOS và Linux. Kết nối máy scan qua USB và cài driver cho hệ điều hành của bạn:

Hệ điều hành	Cần cài gì	Cardloader giao tiếp với máy thế nào
Windows	PaperStream IP (TWAIN) cho fi-8170	Trình hỗ trợ TWAIN đi kèm, chạy trong tiến trình riêng nên driver bị treo cũng không làm đơ ứng dụng
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (hoặc gói SANE của bản phân phối bạn dùng); có thể thêm driver `pfufs` của RICOH	SANE `scanimage`

Để kiểm tra máy scan bên ngoài Cardloader, chạy scanimage -L trên macOS hoặc Linux, hoặc mở máy trong PaperStream Capture trên Windows.
Cổng mạng của fi-8170 chỉ hoạt động qua PaperStream trên Windows; máy không hỗ trợ eSCL/AirScan.
ScanSnap và các máy scan khác: các dòng ScanSnap không có driver TWAIN. Hãy để phần mềm đi kèm của máy lưu ảnh vào một thư mục và tạo một phiên Watch folder (thư mục theo dõi); Cardloader sẽ phân tích từng ảnh ngay khi ảnh được lưu vào.

Bước 5

Cách quét thẻ bài số lượng lớn: cài đặt khuyên dùng

Cài đặt quét mặc định của Cardloader được tinh chỉnh cho thẻ bài khổ chuẩn 63 × 88 mm:

Quét hai mặt qua ADF, để mặt trước và mặt sau của từng thẻ được quét và ghép cặp trong một lượt.
600 dpi, ảnh màu, đủ để đọc số thẻ và chấm điểm.
Khung 66 × 92 mm, lớn hơn thẻ một chút để không bao giờ bị cắt mất cạnh.
Tắt phát hiện nạp chồng (multifeed): thẻ cứng dễ khiến máy báo nhầm lỗi nạp hai tờ.
Bắt đầu với những xấp nhỏ khoảng 10 thẻ, và đừng cho thẻ đang bọc sleeve hay top loader vào máy.

Dành cho lập trình viên

Build từ mã nguồn

Bạn cần Rust, Node.js 22 trở lên, các yêu cầu cài đặt của Tauri cho hệ điều hành của bạn, và CMake cùng Clang để biên dịch llama.cpp cho mô hình cục bộ.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # chạy ứng dụng với hot reload
$ just install   # build và cài đặt trên máy

just là tùy chọn; Makefile có các target tương tự. Để build không kèm mô hình cục bộ, chạy cargo build --no-default-features trong src-tauri/. Xem thêm trong README.

Tham khảo

Cập nhật hoặc gỡ cài đặt Cardloader

Để cập nhật, hãy tải phiên bản mới và cài đè lên bản cũ theo cách tương tự. Các phiên, cài đặt, token API và mô hình đã tải về đều được giữ nguyên.

Hệ điều hành	Gỡ cài đặt
macOS	Kéo Cardloader từ thư mục Ứng dụng vào Thùng rác.
Windows	Cài đặt → Ứng dụng → Ứng dụng đã cài đặt, rồi chọn Gỡ cài đặt trong menu ⋯ của Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader`, hoặc xóa tệp AppImage.

Gỡ cài đặt chỉ xóa ứng dụng. Các phiên của bạn vẫn nằm trong thư mục dữ liệu bên dưới cho đến khi bạn tự xóa.

Tham khảo

Cardloader lưu dữ liệu của bạn ở đâu

Phiên, ảnh thu nhỏ, ảnh quét và lớp hiển thị chấm điểm đều nằm trên máy tính của bạn. Ảnh gốc trong các phiên từ thư mục không bao giờ bị sửa hay di chuyển, và khi xóa một phiên, chỉ những tệp do Cardloader tạo ra mới bị xóa.

Hệ điều hành	Thư mục
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

Bắt đầu quét thẻ của bạn miễn phí

Tải Cardloader về cho Windows, macOS hoặc Linux, chọn một thư mục hoặc máy scan của bạn, và nhận diện loạt thẻ đầu tiên chỉ trong vài phút. Không gói đăng ký, không cần tài khoản.

Tải Cardloader về Gắn sao trên GitHub