Cardloader’ı kurun ve kart tarayıcınızı bağlayın

Cardloader, Windows, macOS ve Linux için ücretsiz bir masaüstü uygulamasıdır. Kurulumu bir dakika sürer; toplu tarama için bir Fujitsu/Ricoh fi-8170 bağlamak ise yalnızca bir sürücü daha gerektirir.

Son sürümü indir Tüm sürümler

Hızlı başlangıç

İndirin. Sisteminize uygun yükleyiciyi GitHub’daki son sürümden indirin.
Kurun. macOS, Windows ya da Linux için kurulum adımlarını izleyerek Cardloader’ı kurun ve ilk kez açın.
Motor seçin. Settings’i açın ve ücretsiz yerel modeli indirin ya da tam eşleşmeler, fiyatlar ve derecelendirme için Ximilar API token’ınızı yapıştırın.
Tarayıcı bağlayın. İsteğe bağlı: sürücüyü kurup fi-8170’i veya başka bir TWAIN ya da SANE tarayıcıyı bağlayın; bunun yerine izlenen klasör de kullanabilirsiniz.
Tarama ayarlarını kontrol edin. ADF ile çift taraflı ve 600 dpi çözünürlükte tarayın; çoklu besleme algılamayı kapatın ve küçük destelerle çalışın.
Oturum oluşturun. New session’a tıklayın, bir klasör ya da tarayıcınızı seçin, kartların nasıl tanınıp derecelendirileceğini belirleyin, ardından Create & run’a tıklayın.
Kontrol edin ve dışa aktarın. Sonuçların dolmasını izleyin, herhangi bir eşleşmeyi tek tıkla düzeltin ve oturumu CSV olarak dışa aktarın.

1. adım

Windows, Mac ve Linux için kart tarama programını indirin

Cardloader 0.1.0 ücretsizdir. Sisteminize uygun yükleyiciyi indirin, ardından aşağıdaki kurulum adımlarını izleyin:

Sistem	İndirme	Gereksinimler
macOS	.dmg	macOS 11 Big Sur veya üstü, Apple silicon ya da Intel
Windows	.exe veya .msi	Windows 10 veya 11, 64 bit
Linux	.AppImage, .deb veya .rpm	x86-64; .deb için Ubuntu 22.04, Debian 12 ya da daha yenisi gerekir

Eski sürümler ve sürüm notları GitHub sürümleri sayfasındadır. Yükleyiciler, açık kaynak koddan GitHub Actions ile derlenir.

macOS Windows Linux

2. adım

Cardloader’ı Mac’e kurun

İndirilenler klasöründeki Cardloader_0.1.0_universal.dmg dosyasını açın.
Açılan pencerede Cardloader’ı Uygulamalar klasörüne sürükleyin.
Cardloader’ı Uygulamalar klasöründen açın. İlk açılışta macOS, “Cardloader” uygulamasında kötü amaçlı yazılım olmadığını doğrulayamadığını söyler: Bitti düğmesine tıklayın.
Sistem Ayarları → Gizlilik ve Güvenlik bölümünü açın, Güvenlik kısmına kadar aşağı kaydırın ve Cardloader ile ilgili mesajın yanındaki Yine de Aç düğmesine tıklayın.
Parolanızla ya da Touch ID ile onaylayın, ardından Aç düğmesine tıklayın. Artık Cardloader diğer uygulamalar gibi açılır; disk görüntüsünü de çıkarabilirsiniz.

Bu erken sürüm henüz bir Apple geliştirici sertifikasıyla imzalanmadığı için macOS onay ister. macOS 14 ve öncesinde uygulamaya sağ tıklayıp Aç komutunu seçmek de işe yarar. Terminal’de xattr -dr com.apple.quarantine /Applications/Cardloader.app komutu da aynı işi görür.

2. adım

Cardloader’ı Windows’a kurun

İndirilenler klasöründeki Cardloader_0.1.0_x64-setup.exe dosyasını çalıştırın.
Mavi bir “Windows kişisel bilgisayarınızı korudu” penceresi çıkarsa önce Ek bilgi bağlantısına, ardından Yine de çalıştır düğmesine tıklayın.
Yükleyicinin adımlarını izleyin. Cardloader yönetici hakları gerekmeden, yalnızca sizin kullanıcı hesabınıza kurulur.
Cardloader’ı Başlat menüsünden açın.

Bu erken sürüm henüz kod imzalı olmadığı için SmartScreen uyarı verir. Bilgisayarda Microsoft Edge WebView2 yoksa yükleyici onu indirir (Windows 11’de zaten vardır). .msi dosyası tüm kullanıcılar için kurar ve yönetici hakları gerektirir. TWAIN tarayıcı yardımcısı ikisinde de bulunur.

2. adım

Cardloader’ı Linux’a kurun

Bir paket seçin ve indirdiğiniz klasörde bir terminal açın:

Ubuntu, Debian, Linux Mint (.deb)

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

apt, Cardloader’ın ihtiyaç duyduğu WebKitGTK’yı da kurar. Cardloader’ı uygulama menünüzden ya da cardloader komutuyla başlatın.

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

Tüm dağıtımlar (AppImage)

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

Açılmazsa ve hata mesajında FUSE geçiyorsa libfuse2 paketini kurun (Ubuntu 24.04’te libfuse2t64).

3. adım

Yerel yapay zeka modelini ya da Ximilar API’yi kurun

Ücretsiz yerel model (çevrimdışı)

Settings → Identification → Local model bölümünü açın, modelin lisansını kabul edin ve indirmeye tıklayın. Model yaklaşık 330 MB’tır; indirme duraklatılıp devam ettirilebilir. Ardından yeni oturumlar kartları bilgisayarınızda, hesap ve internet olmadan tanır.

Ximilar API (isteğe bağlı)

Varyasyonlar arasında tam eşleşme, güven skorları, fiyatlar ve derecelendirme için API token’ınızı Ximilar App üzerinden kopyalayın, Settings bölümüne yapıştırın ve Test connection düğmesine tıklayın. Token, sisteminizin anahtar zincirinde saklanır.

Koleksiyon ürünlerini tanımak için Ximilar Business planı ya da deneme sürümü gerekir. Her kart API kredisi harcar: tanıma başına bir çağrı (Auto modunda iki), artı her derecelendirme için bir çağrı. Ayrıntılar için Ximilar fiyatlandırması.

4. adım

Fujitsu / Ricoh fi-8170 tarayıcıyı bağlayın

Cardloader, RICOH (eski adıyla Fujitsu) fi-8170 tarayıcıyı doğrudan çalıştırır; Windows’ta belge besleyicili her TWAIN 2.x tarayıcıyı, macOS ve Linux’ta da her SANE tarayıcıyı. Tarayıcıyı USB ile bağlayın ve sisteminize uygun sürücüyü kurun:

Sistem	Kurulacaklar	Cardloader’ın bağlantı yolu
Windows	fi-8170 için PaperStream IP (TWAIN)	Kendi sürecinde çalışan dahilî TWAIN yardımcısı; takılan bir sürücü uygulamayı asla dondurmaz
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (ya da dağıtımınızın SANE paketi); isteğe bağlı olarak RICOH `pfufs` sürücüsü	SANE `scanimage`

Tarayıcıyı Cardloader dışında denetlemek için macOS ya da Linux’ta scanimage -L komutunu çalıştırın veya Windows’ta tarayıcıyı PaperStream Capture ile açın.
fi-8170’in ağ bağlantı noktası yalnızca Windows’ta PaperStream üzerinden çalışır; tarayıcı eSCL/AirScan desteklemez.
ScanSnap ve diğer tarayıcılar: ScanSnap modellerinin TWAIN sürücüsü yoktur. Kendi yazılımlarının görüntüleri bir klasöre kaydetmesini sağlayın ve bir Watch folder (izlenen klasör) oturumu oluşturun; Cardloader her görüntüyü geldiği anda analiz eder.

5. adım

Koleksiyon kartları toplu olarak nasıl taranır: önerilen ayarlar

Cardloader’ın varsayılan tarayıcı ayarları, standart 63 × 88 mm koleksiyon kartlarına göre yapılmıştır:

ADF ile çift taraflı tarama: her kartın ön ve arka yüzü tek geçişte taranır ve eşleştirilir.
600 dpi, renkli: kart numaraları ve derecelendirme için yeterlidir.
66 × 92 mm çerçeve: karttan biraz büyüktür, böylece kenarlar asla kırpılmaz.
Çoklu besleme algılama kapalı: sert kartlar yanlış çift besleme hatalarına yol açar.
Yaklaşık 10 kartlık küçük destelerle başlayın; kılıflı (sleeve) kartları ve toploader’ları tarayıcıya vermeyin.

Geliştiriciler için

Kaynak koddan derleme

Rust, Node.js 22 veya daha yenisi, sisteminiz için Tauri ön koşulları ve yerel model için llama.cpp’yi derlemek üzere Clang ile birlikte CMake gerekir.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # uygulamayı anında yeniden yüklemeyle çalıştırır
$ just install   # derleyip yerel olarak kurar

just isteğe bağlıdır; bir Makefile aynı hedefleri içerir. Yerel model olmadan derlemek için cargo build --no-default-features komutunu src-tauri/ içinde çalıştırın. Daha fazlası README dosyasında.

Referans

Cardloader’ı güncelleme veya kaldırma

Güncellemek için yeni sürümü indirip eskisinin üzerine aynı şekilde kurun. Oturumlarınız, ayarlarınız, API token’ınız ve indirdiğiniz modeller korunur.

Sistem	Kaldırma
macOS	Cardloader’ı Uygulamalar klasöründen Çöp Sepeti’ne sürükleyin.
Windows	Ayarlar → Uygulamalar → Yüklü uygulamalar bölümünde Cardloader’ın ⋯ menüsünden Kaldır seçeneğini seçin.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader` ya da AppImage dosyasını silin.

Kaldırma işlemi yalnızca uygulamayı siler. Oturumlarınız, siz silene kadar aşağıdaki veri klasöründe kalır.

Referans

Cardloader verilerinizi nerede saklar

Oturumlar, küçük resimler, taramalar ve derecelendirme katmanları bilgisayarınızda kalır. Klasör oturumlarındaki orijinal görüntüler hiçbir zaman değiştirilmez veya taşınmaz; bir oturumu silmek yalnızca Cardloader’ın oluşturduğu dosyaları kaldırır.

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

Kartlarınızı ücretsiz taramaya başlayın

Cardloader’ı Windows, macOS ya da Linux için indirin, bir klasörü veya tarayıcınızı seçin; ilk kartlarınız birkaç dakika içinde tanınsın. Abonelik yok, hesap yok.

Cardloader’ı indir GitHub’da yıldız ver