Установите Cardloader и подключите сканер

Cardloader — бесплатная программа для Windows, macOS и Linux. Установка занимает минуту, а чтобы сканировать карты пачками на Fujitsu/Ricoh fi-8170, понадобится ещё один драйвер.

Скачать последнюю версию Все релизы

Быстрый старт

Скачайте. Скачайте установщик для своей системы из последнего релиза на GitHub.
Установите. Установите Cardloader и откройте его в первый раз, следуя инструкции для macOS, Windows или Linux.
Выберите движок. Откройте Settings и скачайте бесплатную локальную модель или вставьте токен API Ximilar для точных совпадений, цен и грейдинга.
Подключите сканер. По желанию: установите драйвер и подключите fi-8170 или другой сканер TWAIN или SANE либо используйте отслеживаемую папку.
Проверьте настройки сканирования. Включите двустороннее сканирование через ADF с разрешением 600 dpi, выключите обнаружение подачи нескольких листов и сканируйте небольшими стопками.
Создайте сессию. Нажмите New session, выберите папку или сканер, укажите, как распознавать и оценивать карты, и нажмите Create & run.
Проверьте и экспортируйте. Следите, как появляются результаты, исправьте любое совпадение одним щелчком и экспортируйте сессию в CSV.

Шаг 1

Скачайте программу для сканирования карт для Windows, Mac и Linux

Cardloader 0.1.0 бесплатен. Скачайте установщик для своей системы и следуйте инструкции для неё ниже:

Система	Скачать	Требования
macOS	.dmg	macOS 11 Big Sur или новее, Apple silicon или Intel
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

Установите Cardloader на Mac

Откройте Cardloader_0.1.0_universal.dmg из папки «Загрузки».
В появившемся окне перетащите Cardloader на папку Программы.
Откройте Cardloader из папки «Программы». При первом запуске macOS сообщит, что не удалось проверить «Cardloader» на наличие вредоносного ПО: нажмите Готово.
Откройте Системные настройки → Конфиденциальность и безопасность, прокрутите вниз до раздела Безопасность и нажмите Все равно открыть рядом с сообщением о Cardloader.
Подтвердите действие паролем или Touch ID и нажмите Открыть. Теперь Cardloader запускается как любая другая программа, а образ диска можно извлечь.

macOS спрашивает подтверждение, потому что эта ранняя сборка ещё не подписана сертификатом разработчика Apple. В macOS 14 и более ранних версиях можно также щёлкнуть программу правой кнопкой мыши и выбрать Открыть. В Терминале то же самое делает команда xattr -dr com.apple.quarantine /Applications/Cardloader.app.

Шаг 2 · Windows

Установите Cardloader в Windows

Запустите Cardloader_0.1.0_x64-setup.exe из папки «Загрузки».
Если появится синее окно «Система Windows защитила ваш компьютер», нажмите Подробнее, а затем Выполнить в любом случае.
Пройдите шаги установщика. Он устанавливает Cardloader для вашей учётной записи, права администратора не нужны.
Запустите Cardloader из меню «Пуск».

SmartScreen предупреждает, потому что эта ранняя сборка ещё не подписана цифровой подписью. Если на компьютере ещё нет Microsoft Edge WebView2, установщик скачает его (в Windows 11 он уже есть). Установщик .msi ставит программу для всех пользователей и требует прав администратора. Помощник TWAIN для сканера есть в обоих.

Шаг 2 · Linux

Установите Cardloader в Linux

Выберите один пакет. Откройте терминал в папке, куда вы его скачали:

Ubuntu, Debian, Linux Mint (.deb)

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

apt заодно установит WebKitGTK, который нужен Cardloader. Запускайте 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

Настройте локальную модель или API Ximilar

Бесплатная локальная модель (офлайн)

Откройте Settings → Identification → Local model, примите лицензию модели и нажмите кнопку загрузки. Модель занимает около 330 МБ, загрузку можно приостановить и продолжить. После этого новые сессии распознают карты на вашем компьютере, без аккаунта и без интернета.

API Ximilar (по желанию)

Для точных совпадений с учётом вариантов, уровня уверенности, цен и грейдинга скопируйте свой токен API в Ximilar App, вставьте его в Settings и нажмите Test connection. Токен хранится в системном хранилище учётных данных.

Для распознавания коллекционных предметов нужен тариф Ximilar Business или пробный период. Каждая карта расходует кредиты API: один запрос на распознавание (в режиме Auto — два) и ещё один на грейдинг. См. цены Ximilar.

Шаг 4

Подключите сканер Fujitsu / Ricoh fi-8170

Cardloader напрямую управляет сканером RICOH (ранее Fujitsu) fi-8170, а также любым сканером TWAIN 2.x с автоподатчиком в Windows и любым сканером SANE в macOS и Linux. Подключите сканер по USB и установите драйвер для своей системы:

Система	Что установить	Как Cardloader работает со сканером
Windows	PaperStream IP (TWAIN) для fi-8170	Встроенный помощник TWAIN в отдельном процессе, так что зависший драйвер никогда не подвесит программу
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (или пакет SANE вашего дистрибутива); по желанию драйвер RICOH `pfufs`	SANE `scanimage`

Чтобы проверить сканер без Cardloader, выполните scanimage -L в macOS или Linux или откройте его в PaperStream Capture в Windows.
Сетевой порт fi-8170 работает только через PaperStream в Windows; eSCL/AirScan сканер не поддерживает.
ScanSnap и другие сканеры: у моделей ScanSnap нет драйвера TWAIN. Пусть их собственная программа сохраняет сканы в папку, а вы создайте сессию Watch folder: Cardloader проанализирует каждое изображение, как только оно появится.

Шаг 5

Как сканировать коллекционные карточки пачками: рекомендуемые настройки

Настройки сканера по умолчанию в Cardloader подобраны для стандартных карт размером 63 × 88 мм:

Двустороннее сканирование через ADF, чтобы лицевая и оборотная стороны каждой карты сканировались и объединялись в пару за один проход.
600 dpi, в цвете: этого достаточно для номеров карт и грейдинга.
Область 66 × 92 мм, чуть больше карты, чтобы края никогда не обрезались.
Обнаружение подачи нескольких листов выключено: жёсткие карты вызывают ложные ошибки двойной подачи.
Начинайте с небольших стопок примерно по 10 карт и не подавайте карты в протекторах или топлоадерах.

Для разработчиков

Сборка из исходного кода

Понадобятся Rust, Node.js 22 или новее, зависимости Tauri для вашей системы, а также CMake и Clang, чтобы собрать llama.cpp для локальной модели.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # запуск программы с горячей перезагрузкой
$ just install   # сборка и локальная установка

just не обязателен: в Makefile есть те же цели. Чтобы собрать программу без локальной модели, выполните cargo build --no-default-features в src-tauri/. Подробнее в README.

Справка

Как обновить или удалить Cardloader

Чтобы обновить программу, скачайте новую версию и установите её так же, поверх старой. Ваши сессии, настройки, токен API и скачанные модели сохранятся.

Система	Удаление
macOS	Перетащите Cardloader из папки «Программы» в Корзину.
Windows	Параметры → Приложения → Установленные приложения, затем Удалить в меню ⋯ у Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader` или удалите файл AppImage.

При удалении стирается только сама программа. Ваши сессии остаются в папке с данными (см. ниже), пока вы её не удалите.

Справка

Где Cardloader хранит ваши данные

Сессии, миниатюры, сканы и изображения с разметкой грейдинга остаются на вашем компьютере. Исходные изображения в сессиях с папкой никогда не изменяются и не перемещаются, а при удалении сессии удаляются только файлы, созданные Cardloader.

Система	Папка
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

Начните сканировать карты бесплатно

Скачайте Cardloader для Windows, macOS или Linux, укажите папку или сканер, и первая пачка карт будет распознана за несколько минут. Без подписки и без регистрации.

Скачать Cardloader Поставить звезду на GitHub