Cardloader ইনস্টল করুন, আপনার কার্ড স্ক্যানার যুক্ত করুন

Cardloader হলো Windows, macOS ও Linux‑এর জন্য বিনামূল্যের একটি ডেস্কটপ অ্যাপ। ইনস্টল করতে এক মিনিট লাগে; একসঙ্গে অনেক কার্ড স্ক্যান করতে Fujitsu/Ricoh fi-8170 যুক্ত করার জন্য শুধু আরেকটি ড্রাইভার লাগে।

সর্বশেষ রিলিজ ডাউনলোড করুন সব রিলিজ

দ্রুত শুরু

ডাউনলোড। সর্বশেষ GitHub রিলিজ থেকে আপনার সিস্টেমের ইনস্টলার ডাউনলোড করুন।
ইনস্টল করুন। macOS, Windows বা Linux‑এর নির্দেশনা অনুসরণ করে Cardloader ইনস্টল করুন আর প্রথমবার খুলুন।
ইঞ্জিন বেছে নিন। Settings খুলে বিনামূল্যের লোকাল মডেল ডাউনলোড করুন, অথবা হুবহু মিল, দাম ও গ্রেডিংয়ের জন্য আপনার Ximilar API টোকেন পেস্ট করুন।
স্ক্যানার যুক্ত করুন। চাইলে ড্রাইভার ইনস্টল করে fi-8170 বা অন্য কোনো TWAIN বা SANE স্ক্যানার যুক্ত করুন, অথবা একটি ওয়াচ ফোল্ডার ব্যবহার করুন।
স্ক্যান সেটিংস যাচাই করুন। 600 dpi‑তে ADF ডুপ্লেক্সে, মাল্টিফিড শনাক্তকরণ বন্ধ রেখে, ছোট ছোট গোছায় স্ক্যান করুন।
সেশন তৈরি করুন। 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

Mac‑এ Cardloader ইনস্টল করুন

Downloads ফোল্ডার থেকে Cardloader_0.1.0_universal.dmg খুলুন।
যে উইন্ডোটি খুলবে, সেখানে Cardloader টেনে এনে Applications ফোল্ডারের ওপর ছেড়ে দিন।
Applications ফোল্ডার থেকে Cardloader খুলুন। প্রথমবার macOS জানাবে, “Cardloader” ম্যালওয়্যারমুক্ত কি না তা যাচাই করা যায়নি: Done বাটনে ক্লিক করুন।
System Settings → Privacy & Security খুলুন, নিচে Security অংশ পর্যন্ত স্ক্রল করুন আর Cardloader‑সংক্রান্ত বার্তার পাশে Open Anyway বাটনে ক্লিক করুন।
আপনার পাসওয়ার্ড বা Touch ID দিয়ে নিশ্চিত করুন, তারপর Open বাটনে ক্লিক করুন। এখন থেকে Cardloader অন্য যেকোনো অ্যাপের মতোই চালু হবে, আর ডিস্ক ইমেজটি ইজেক্ট করে দিতে পারেন।

এই প্রথম দিকের বিল্ডটি এখনো Apple ডেভেলপার সার্টিফিকেট দিয়ে সাইন করা হয়নি, তাই macOS অনুমতি চায়। macOS 14 বা তার আগের সংস্করণে অ্যাপটিতে রাইট-ক্লিক করে Open বেছে নিলেও কাজ হয়। Terminal‑এ xattr -dr com.apple.quarantine /Applications/Cardloader.app চালালেও একই কাজ হয়।

ধাপ 2 · Windows

Windows‑এ Cardloader ইনস্টল করুন

Downloads ফোল্ডার থেকে Cardloader_0.1.0_x64-setup.exe চালান।
নীল রঙের “Windows protected your PC” উইন্ডো এলে More info, তারপর Run anyway বাটনে ক্লিক করুন।
ইনস্টলারের ধাপগুলো একে একে পার হয়ে যান। এটি অ্যাডমিনিস্ট্রেটর অধিকার ছাড়াই শুধু আপনার ইউজার অ্যাকাউন্টের জন্য Cardloader ইনস্টল করে।
Start মেনু থেকে 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

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

লোকাল AI মডেল বা Ximilar API সেট আপ করুন

বিনামূল্যের লোকাল মডেল (অফলাইন)

Settings → Identification → Local model খুলুন, মডেলের লাইসেন্স গ্রহণ করে ডাউনলোডে ক্লিক করুন। মডেলটি প্রায় 330 MB, আর ডাউনলোড থামিয়ে পরে আবার চালু করা যায়। এরপর নতুন সেশনগুলো আপনার কম্পিউটারেই কার্ড শনাক্ত করবে, কোনো অ্যাকাউন্ট বা ইন্টারনেট ছাড়াই।

Ximilar API (ঐচ্ছিক)

ভ্যারিয়েন্টের মধ্যেও হুবহু মিল, কনফিডেন্স স্কোর, দাম আর গ্রেডিংয়ের জন্য Ximilar App থেকে আপনার API টোকেন কপি করুন, Settings অংশে পেস্ট করুন আর Test connection বাটনে ক্লিক করুন। টোকেনটি আপনার সিস্টেমের কিচেইনে রাখা হয়।

সংগ্রহযোগ্য জিনিস শনাক্ত করতে Ximilar Business প্ল্যান বা ট্রায়াল লাগে। প্রতিটি কার্ডে API ক্রেডিট খরচ হয়: প্রতিটি শনাক্তকরণে একটি কল (Auto মোডে দুটি), আর প্রতিটি গ্রেডিংয়ে আরও একটি। দেখুন Ximilar‑এর দাম।

ধাপ 4

Fujitsu / Ricoh fi-8170 স্ক্যানার যুক্ত করুন

Cardloader সরাসরি RICOH (আগে Fujitsu) fi-8170 চালায়, সঙ্গে Windows‑এ ডকুমেন্ট ফিডারওয়ালা যেকোনো 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 × 88 mm মাপের ট্রেডিং কার্ডের জন্য ঠিক করা:

ADF ডুপ্লেক্স, যাতে প্রতিটি কার্ডের সামনে ও পেছনে একবারেই স্ক্যান হয়ে জোড়া মিলে যায়।
600 dpi, রঙিন, যা কার্ড নম্বর আর গ্রেডিংয়ের জন্য যথেষ্ট।
66 × 92 mm ফ্রেম, কার্ডের চেয়ে সামান্য বড়, তাই কিনারা কখনো কেটে যায় না।
মাল্টিফিড শনাক্তকরণ বন্ধ: শক্ত কার্ডের কারণে ভুলভাবে ডাবল-ফিড ত্রুটি দেখা দেয়।
প্রায় 10টি কার্ডের ছোট গোছা দিয়ে শুরু করুন, আর স্লিভ পরানো কার্ড বা টপলোডার স্ক্যানারে দেবেন না।

ডেভেলপারদের জন্য

সোর্স থেকে বিল্ড করুন

আপনার লাগবে Rust, Node.js 22 বা নতুনতর, আপনার সিস্টেমের জন্য Tauri‑এর পূর্বশর্তগুলো, আর লোকাল মডেলের জন্য llama.cpp কম্পাইল করতে Clang‑সহ CMake।

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # হট রিলোডসহ অ্যাপ চালান
$ just install   # বিল্ড করে লোকালি ইনস্টল করুন

just ঐচ্ছিক; একটি Makefile‑এ একই টার্গেটগুলো আছে। লোকাল মডেল ছাড়া বিল্ড করতে src-tauri/ ফোল্ডারে cargo build --no-default-features চালান। আরও জানতে দেখুন README।

রেফারেন্স

Cardloader আপডেট বা আনইনস্টল করুন

আপডেট করতে নতুন সংস্করণটি ডাউনলোড করে একইভাবে, পুরোনোটির ওপরেই ইনস্টল করুন। আপনার সেশন, সেটিংস, API টোকেন আর ডাউনলোড করা মডেল যেমন আছে তেমনই থাকবে।

সিস্টেম	আনইনস্টল
macOS	Applications থেকে Cardloader টেনে এনে Bin‑এ ফেলে দিন।
Windows	Settings → Apps → Installed apps খুলুন, তারপর Cardloader‑এর ⋯ মেনুতে Uninstall বেছে নিন।
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/`

বিনামূল্যে আপনার কার্ড স্ক্যান করা শুরু করুন

Windows, macOS বা Linux‑এর জন্য Cardloader ডাউনলোড করুন, একটি ফোল্ডার বা আপনার স্ক্যানার বেছে নিন, আর কয়েক মিনিটেই প্রথম ব্যাচের কার্ড শনাক্ত করুন। কোনো সাবস্ক্রিপশন নেই, অ্যাকাউন্টও লাগে না।

Cardloader ডাউনলোড করুন GitHub‑এ স্টার দিন