sane-magicolor(5)

💖 sane-magicolor — the KONICA MINOLTA + Toshiba TEC scanner backend, explained by your favorite Unix girlie 💖

okay so bestie, welcome to sane-magicolor, section 5 of the manual (that's the "file formats and conventions" girlies, iykyk ✨). It's the SANE backend for KONICA MINOLTA magicolor and Toshiba TEC e-STUDIO scanners. Sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ NAME ✨

sane-magicolor — the SANE backend for KONICA MINOLTA magicolor and Toshiba TEC e-STUDIO scanners. That's it, that's the name, no cap. 🎀

---

🌈 DESCRIPTION 🌈

The sane-magicolor backend supports KONICA MINOLTA magicolor and Toshiba TEC e-STUDIO scanners connected via USB or LAN. Both ways in, one backend, we love a versatile icon 💅

---

👑 SUPPORTED DEVICES 👑

The following scanner should work with this backend:

Device Details
-----------------------------
Vendor: KONICA MINOLTA
Model: magicolor 1690MF
Vendor: Toshiba TEC
Model: e-STUDIO2323AM

So that's the KONICA MINOLTA magicolor 1690MF and the Toshiba TEC e-STUDIO2323AM. Two queens, both slaying, periodt. 👑

---

🛠️ CONFIGURATION 🛠️

This section describes the backend's configuration file entries. The file lives at:

/etc/sane.d/magicolor.conf

For a proper setup, you need at least one of the following entries, bestie — pick your fighter:

net autodiscovery
net [IP ADDRESS] [DEVICE-ID]
usb
usb [VENDOR-ID] [DEVICE-ID]

not me pointing out that if you skip all of these, nothing is gonna happen 🙈 at least one. At. Least. One.

---

📁 FILES 📁

• /etc/sane.d/magicolor.conf — the backend configuration file. The main character, fr fr.
• /usr/lib64/sane/libsane-magicolor.a — the static library implementing this backend.
• /usr/lib64/sane/libsane-magicolor.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). Order matters, bestie, don't come for me 💅

SANE_DEBUG_MAGICOLOR

If the library was compiled with debug support enabled, this environment variable controls the debug level for this backend. Higher debug levels increase the verbosity of the output. Spicy. 🌶️

Example:

export SANE_DEBUG_MAGICOLOR=127

To obtain debug messages from the backend, set this environment variable before calling your favorite frontend (e.g. xscanimage(1)).

Example:

SANE_DEBUG_MAGICOLOR=65 xscanimage

set it before, not after — the backend is nosy and it needs to already know, okurrr? 😭

---

💀 KNOWN BUGS AND RESTRICTIONS 💀

Large color scans may sometimes timeout due to unknown reasons (the scanner simply stops returning data).

Cancelling large scans may lock up the scanner.

Yeah. Not a vibe. Be careful with the big color scans, bestie, and maybe don't spam cancel on them unless you're ready for the consequences 🫶

---

🔗 SEE ALSO 🔗

• sane(7)
• http://wiki.kainhofer.com/hardware/magicolor_scan

---

🧚 AUTHOR 🧚

Reinhold Kainhofer <reinhold@kainhofer.com>

---

and that's the whole page, bestie!! ✨ This icon of a manual is dated 10 Jan 2011, and it's sane-magicolor(5) — SANE Scanner Access Now Easy, always and forever 💜🦋 go scan something cute 🎀