Cardloader 설치와 카드 스캐너 연결

Cardloader는 Windows, macOS, Linux용 무료 데스크톱 프로그램입니다. 설치는 1분이면 끝나고, 후지쯔/리코 fi-8170으로 대량 스캔을 하려면 드라이버 하나만 더 설치하면 됩니다.

최신 버전 다운로드 모든 릴리스

빠른 시작

다운로드. GitHub 최신 릴리스에서 내 운영체제에 맞는 설치 파일을 다운로드합니다.
설치하기. macOS, Windows, Linux별 안내에 따라 Cardloader를 설치하고 처음 실행합니다.
엔진 고르기. Settings를 열고 무료 로컬 모델을 다운로드하거나, 정확한 식별과 시세, 그레이딩을 위해 Ximilar API 토큰을 붙여 넣습니다.
스캐너 연결하기. 선택 사항: 드라이버를 설치하고 fi-8170이나 다른 TWAIN 또는 SANE 스캐너를 연결합니다. Watch folder(감시 폴더)를 써도 됩니다.
스캔 설정 확인하기. ADF 양면, 600dpi로 스캔하고 다중 급지 감지는 끄며, 카드는 적게 나눠 넣습니다.
세션 만들기. New session을 누르고 폴더나 스캐너를 고른 뒤, 카드를 식별하고 그레이딩할 방식을 정하고 Create & run을 누릅니다.
확인하고 내보내기. 결과가 채워지는 것을 지켜보면서 잘못된 식별은 클릭 한 번으로 고치고, 세션을 CSV로 내보냅니다.

1단계

Windows, Mac, Linux용 카드 스캐너 프로그램 다운로드

Cardloader 0.1.0 버전은 무료입니다. 내 운영체제에 맞는 설치 파일을 다운로드한 뒤 아래 안내를 따라 설치하세요.

운영체제	다운로드	시스템 요구 사항
macOS	.dmg	macOS 11 Big Sur 이상, Apple 실리콘 또는 Intel Mac
Windows	.exe 또는 .msi	Windows 10 또는 11, 64비트
Linux	.AppImage, .deb 또는 .rpm	x86-64, .deb는 Ubuntu 22.04, Debian 12 이상 필요

이전 버전과 릴리스 노트는 GitHub 릴리스에 있습니다. 설치 파일은 GitHub Actions가 오픈 소스 코드로 빌드합니다.

macOS Windows Linux

2단계 · macOS

Mac에 Cardloader 설치하기

다운로드 폴더에서 Cardloader_0.1.0_universal.dmg 파일을 엽니다.
나타난 창에서 Cardloader를 응용 프로그램 폴더로 드래그합니다.
응용 프로그램 폴더에서 Cardloader를 엽니다. 처음에는 Cardloader에 악성 소프트웨어가 있는지 확인할 수 없다는 경고가 나타나는데, 여기서 완료를 클릭합니다.
시스템 설정 → 개인정보 보호 및 보안을 열고 보안까지 아래로 스크롤한 다음, Cardloader에 관한 메시지 옆의 그래도 열기를 클릭합니다.
암호나 Touch ID로 확인한 뒤 열기를 클릭합니다. 이제부터 Cardloader는 다른 앱처럼 바로 열리며, 디스크 이미지는 추출해도 됩니다.

이렇게 확인을 거치는 것은 초기 빌드가 아직 Apple 개발자 인증서로 서명되지 않았기 때문입니다. macOS 14 이하에서는 앱을 오른쪽 클릭하고 열기를 선택해도 됩니다. 터미널에서 xattr -dr com.apple.quarantine /Applications/Cardloader.app 명령을 실행해도 같습니다.

2단계 · Windows

Windows에 Cardloader 설치하기

다운로드 폴더에서 Cardloader_0.1.0_x64-setup.exe 파일을 실행합니다.
파란색 “Windows의 PC 보호” 창이 나타나면 추가 정보를 클릭한 다음 실행을 클릭합니다.
설치 화면의 안내에 따라 진행합니다. Cardloader는 관리자 권한 없이 내 사용자 계정에 설치됩니다.
시작 메뉴에서 Cardloader를 실행합니다.

SmartScreen 경고가 뜨는 것은 초기 빌드에 아직 코드 서명이 없기 때문입니다. PC에 Microsoft Edge WebView2가 없으면 설치 파일이 함께 다운로드합니다(Windows 11에는 기본으로 들어 있습니다). .msi는 모든 사용자용으로 설치되며 관리자 권한이 필요합니다. TWAIN 스캐너 도우미는 두 설치 파일에 모두 들어 있습니다.

2단계 · Linux

Linux에 Cardloader 설치하기

패키지를 하나 고르고, 다운로드한 폴더에서 터미널을 열어 다음 명령을 실행하세요.

Ubuntu, Debian, Linux Mint(.deb)

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

Cardloader에 필요한 WebKitGTK도 apt가 함께 설치합니다. 애플리케이션 메뉴에서 Cardloader를 실행하거나 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

모든 배포판(AppImage)

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

실행되지 않고 FUSE 관련 메시지가 나오면 libfuse2(Ubuntu 24.04에서는 libfuse2t64)를 설치하세요.

3단계

로컬 AI 모델 또는 Ximilar API 설정

무료 로컬 모델(오프라인)

Settings → Identification → Local model을 열고 모델 라이선스에 동의한 뒤 다운로드를 누르세요. 용량은 약 330MB이며 일시 정지와 재개가 가능합니다. 이후 새 세션은 계정도 인터넷도 없이 내 PC에서 카드를 인식합니다.

Ximilar API(선택 사항)

카드 버전까지 구분하는 정확한 식별, 신뢰도 점수, 시세, 그레이딩이 필요하다면 Ximilar App에서 API 토큰을 복사해 Settings에 붙여 넣고 Test connection을 누르세요. 토큰은 시스템 키체인에 보관됩니다.

수집품 인식에는 Ximilar Business 요금제나 체험판이 필요합니다. 카드마다 API 크레딧이 들며, 인식 한 번에 호출 한 번(Auto 모드는 두 번), 그레이딩 한 번에 호출 한 번입니다. Ximilar 요금을 참고하세요.

4단계

후지쯔/리코 fi-8170 스캐너 연결

Cardloader는 RICOH(구 후지쯔) fi-8170을 직접 제어하며, Windows에서는 자동 급지 장치(ADF)가 있는 TWAIN 2.x 스캐너, macOS와 Linux에서는 SANE 스캐너도 제어합니다. 스캐너를 USB로 연결하고 운영체제에 맞는 드라이버를 설치하세요.

운영체제	설치할 것	Cardloader와의 연결 방식
Windows	fi-8170용 PaperStream IP(TWAIN)	내장 TWAIN 도우미. 별도 프로세스로 돌아가므로 드라이버가 멈춰도 앱은 멈추지 않습니다
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils`(또는 배포판의 SANE 패키지), 필요하면 RICOH의 `pfufs` 드라이버	SANE `scanimage`

Cardloader 밖에서 스캐너를 확인하려면 macOS나 Linux에서 scanimage -L을 실행하거나, Windows에서 PaperStream Capture로 열어 보세요.
fi-8170의 네트워크 포트는 Windows의 PaperStream을 통해서만 쓸 수 있으며, 스캐너가 eSCL/AirScan을 지원하지 않습니다.
ScanSnap 등 다른 스캐너: ScanSnap 모델에는 TWAIN 드라이버가 없습니다. 스캐너 전용 프로그램이 폴더에 저장하도록 하고 Watch folder(감시 폴더) 세션을 만드세요. Cardloader가 이미지가 들어오는 대로 분석합니다.

5단계

트레이딩 카드 대량 스캔 방법: 권장 설정

Cardloader의 스캐너 기본값은 표준 63 × 88mm 트레이딩 카드에 맞춰져 있습니다.

ADF 양면: 카드 앞면과 뒷면을 한 번에 스캔해 짝지어 줍니다.
600dpi 컬러: 카드 번호를 읽고 그레이딩하기에 충분한 해상도입니다.
66 × 92mm 스캔 영역: 카드보다 조금 커서 가장자리가 잘리지 않습니다.
다중 급지 감지 끄기: 빳빳한 카드는 다중 급지 오류를 잘못 일으키기 쉽습니다.
처음에는 10장 정도씩 적게 넣고, 슬리브나 탑로더에 넣은 카드는 넣지 마세요.

개발자용

소스 코드에서 빌드하기

Rust, Node.js 22 이상, 운영체제별 Tauri 사전 요구 사항, 그리고 로컬 모델용 llama.cpp를 컴파일할 CMake와 Clang이 필요합니다.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # 핫 리로드로 앱 실행
$ just install   # 빌드 후 이 PC에 설치

just는 없어도 됩니다. 같은 타깃을 가진 Makefile이 있습니다. 로컬 모델 없이 빌드하려면 src-tauri/에서 cargo build --no-default-features를 실행하세요. 자세한 내용은 README를 참고하세요.

참고

Cardloader 업데이트와 제거

업데이트하려면 새 버전을 다운로드해 같은 방법으로 기존 버전 위에 설치하세요. 세션, 설정, API 토큰, 다운로드한 모델은 그대로 유지됩니다.

운영체제	제거 방법
macOS	응용 프로그램 폴더에서 Cardloader를 휴지통으로 드래그합니다.
Windows	설정 → 앱 → 설치된 앱에서 Cardloader의 ⋯ 메뉴를 열고 제거를 선택합니다.
Linux	`sudo apt remove cardloader` 또는 `sudo dnf remove cardloader`를 실행하거나 AppImage 파일을 삭제합니다.

제거해도 앱만 지워집니다. 세션은 직접 삭제하기 전까지 아래 데이터 폴더에 남아 있습니다.

참고

Cardloader가 데이터를 저장하는 곳

세션, 썸네일, 스캔 이미지, 그레이딩 오버레이는 모두 내 PC에 저장됩니다. 폴더 세션의 원본 이미지는 수정하거나 옮기지 않으며, 세션을 삭제해도 Cardloader가 만든 파일만 지워집니다.

운영체제	폴더
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

지금 무료로 카드 스캔을 시작하세요

Windows, macOS, Linux용 Cardloader를 다운로드해 폴더나 스캐너를 지정하면 몇 분 만에 첫 카드 묶음을 인식할 수 있습니다. 구독도, 계정도 필요 없습니다.

Cardloader 다운로드 GitHub에서 스타 누르기