sane-gphoto2(5)

📦
version 1.4.0 · 8 versions
, in alpine 3.24, arch rolling

🎀 NAME 🎀

sane-gphoto2 — the SANE backend for gphoto2-supported cameras. This is the sane-gphoto2(5) manual page, bestie, so keep that name in your back pocket.

✨ DESCRIPTION ✨

okay so the sane-gphoto2 library implements a SANE (Scanner Access Now Easy) backend that gives you access to the digital cameras supported by gphoto2. The way this backend is set up: it has only been tested with a handful of cameras so far, and patches to support other models are welcome — yes, that means you can slide into the codebase if you want. 💅

Because of the limited testing of this backend, it is commented out in /etc/sane.d/dll.conf by default. So you either remove the comment character, or call the backend explicitly. E.g. scanimage -d gphoto2 or xscanimage gphoto2. No cap, that's the whole move. 🫶

🦋 DEVICE NAMES 🦋

The current version of the backend only allows one camera to be connected. The device name is always "0".

🎀 CONFIGURATION 🎀

The contents of gphoto2.conf specify the characteristics of the camera to be used. Resolutions (high resolution, low resolution, and thumbnail size) are required since they are needed by the SANE frontends, but can't be obtained through the gphoto2 interface. Valid ports and cameras can be obtained by gphoto2 --list-cameras and gphoto2 --list-ports.

The dumpinquiry line causes some information about the camera to be printed.

Empty lines and lines starting with a hash mark (#) are ignored. A sample configuration file is shown below:

The topfolder line specifies the "fixed" part of the file path. For example, on the Kodak DC-240, files are stored in the directory /DCIM/100DC240. The /DCIM portion is constant, but 100DC240 will change and must be read from the camera. In this case, the line would read topfolder=/DCIM.

Some cameras don't implement a file structure and store all pictures in the / directory. This is indicated by setting subdirs=0 with topfolder=/.

port=usb:
camera=Kodak DC240
# this is a comment
high_resolution=1280x960
low_resolution=640x480
thumb_resolution=160x120
dumpinquiry

💜 FILES 💜

  • /etc/sane.d/gphoto2.conf — the backend configuration file (see also description of SANE_CONFIG_DIR below).
  • /usr/lib/sane/libsane-gphoto2.a — the static library implementing this backend.
  • /usr/lib/sane/libsane-gphoto2.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 are separated by a semi-colon (;). If this variable is not set, the configuration file is searched in two default directories: first, the current working directory (.) and then in /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_GPHOTO2 — if the library was compiled with debugging support enabled, this environment variable controls the debug level for this backend. A value of 128 requests maximally copious debug output; smaller levels reduce verbosity.
  • GP_DEBUG — set to 1, 2, or 3, to enable various levels of debugging within the gphoto2 libraries.

👑 SEE ALSO 👑

🍓 AUTHOR 🍓

Peter S. Fales.

The manpage was largely copied from the sane-dc210(5) manpage.

💀 BUGS 💀

Many, no doubt.

More general comments, suggestions, and inquiries about frontends or SANE should go to the SANE Developers mailing list (see http://www.sane-project.org/mailing-lists.html for details). You must be subscribed to the list, otherwise your mail won't be sent to the subscribers.

okay bye bestie — this page is dated 11 Jul 2008, and the manual/source/version tag is sane-gphoto2(5). stay iconic ✨💅

📦 where this page comes from