sane-snapscan(5)

📦
version 1.4.0 · 6 versions
, in centos-stream 10, fedora 43, fedora 44, opensuse-leap 16.0

💖 sane-snapscan 💖

okay so this is the manual page for sane-snapscan, bestie — it lives in section 5 of the SANE docs (Scanner Access Now Easy, iykyk) and it's literally all about getting your AGFA SnapScan flatbed talking to your computer. buckle up 🎀

✨ NAME ✨

sane-snapscan — the SANE backend for AGFA SnapScan flatbed scanners. that's the whole vibe. 🦋

🌸 DESCRIPTION 🌸

the sane-snapscan library implements a SANE backend — and SANE stands for Scanner Access Now Easy, which, slay — that gives you access to AGFA SnapScan flatbed scanners. 💅

right now, the following scanners are supported from this backend: AGFA SnapScan 300, 310, 600, and 1236s, 1236u, 1212u, e20, e25, e40, e50, e60, Vuego 310s, Acer 300f, 310s, 610s, 610plus, Prisa 620s, Prisa 620u, Prisa 620ut, Prisa 640u, Prisa 640bu, Prisa 1240, Prisa 3300, Prisa 4300, Prisa 5300 and Guillemot Maxi Scan A4 Deluxe (SCSI) (with varying success).

not gonna lie, that last bit — "with varying success" — is doing a LOT of heavy lifting 😭 consider that your vibe check before you plug anything in.

🎀 DEVICE NAMES 🎀

so this backend expects device names shaped like this:

special

where special is the path-name for the special device that corresponds to a SCSI scanner. for SCSI scanners, the special device name has to be a generic SCSI device, or a symlink pointing at one of those. under Linux, a device name like /dev/sga or /dev/sge would work, for example. see sane-scsi(5) for details. 🫶

for USB scanners, the devicename must contain the keyword "usb" — like in /dev/usbscanner or /dev/usb/scanner0.

for scanners that need a firmware upload before scanning, add a line starting with "firmware" followed by the fully qualified path to your firmware file, like this:

firmware /usr/share/sane/snapscan/firmware.bin

for further details, go read http://snapscan.sourceforge.net 🌈

⭐ CONFIGURATION ⭐

the contents of the snapscan.conf file is a list of device names that correspond to SnapScan scanners. empty lines and lines starting with a hash mark (#) are ignored. see sane-scsi(5) for details on what constitutes a valid device name. ✨

🍓 FILES 🍓

  • /etc/sane.d/snapscan.conf — the backend configuration file (see also the description of SANE_CONFIG_DIR below).
  • /usr/lib64/sane/libsane-snapscan.a — the static library implementing this backend.
  • /usr/lib64/sane/libsane-snapscan.so — the shared library implementing this backend (present on systems that support dynamic loading).

💜 ENVIRONMENT 💜

  • SANE_CONFIG_DIR — this environment variable specifies the list of directories that may contain the configuration file. on NIX systems, the directories are separated by a colon (`:`); under OS/2, they're separated by a semi-colon (`;`). if this variable isn't set, the configuration file is searched in two default directories: first the current working directory ("."), and then /etc/sane.d. if the value of the environment variable ends with the directory separator character, then the default directories are searched *after the explicitly specified directories. for example, setting SANE_CONFIG_DIR to "/tmp/config:" would result in directories tmp/config, ., and /etc/sane.d being searched (in this order).
  • SANE_DEBUG_SNAPSCAN — if the library was compiled with debug support enabled, this environment variable controls the debug level for this backend. e.g., a value of 255 requests all debug output to be printed. smaller levels reduce verbosity. 🔥

💀 BUGS 💀

the man page doesn't provide much information yet.

yes, that IS the bug. the docs are lowkey under construction 🙈 iconic behavior honestly.

👑 SEE ALSO 👑

sane(7), sane-scsi(5), http://sourceforge.net/projects/snapscan/ (new development website)

🌟 AUTHOR 🌟

Kevin Charter, Franck Schneider, Michel Roelofs, Emmanuel Blot, Mikko Tyolajarvi, David Mosberger-Tang, Wolfgang Goeller, Petter Reinholdtsen, Gary Plewa, Sebastien Sable, Oliver Schwartz and Mikael Magnusson.

Man page by Henning Meier-Geinitz (mostly based on the web pages and source code). 🫶

okay that's the whole thing, bestie — periodt. ✨ this page is from SANE Scanner Access Now Easy, dated 14 Jul 2008, and yeah it's literally titled sane-snapscan(5) — go scan something cute 💅🎀

📦 where this page comes from