Scanners: Difference between revisions

Revision as of 13:54, 30 August 2017

Scanners are handled by the SANE library:

#/etc/nixos/configuration.nix
{
  hardware.sane.enable = true;
}

Verification

To check quickly if your scanner is detected by SANE, you can use scanimage -L. If root only can detect the scanner, try adding your user in the scanner or lp group.

Extra backends

You can check on the official page of libsane if your scanner is supported. Some backends are proprietary and not installed by default (see below).

Note that the selection of the right set of backends by libsane depends on the LD_LIBRARY_PATH environment variable. nixos-rebuild switch is thus not enough to "install" a new backend, you need to logout/login again for changes to take effect.

HP

hardware.sane.extraBackends = [ pkgs.hplipWithPlugin ];

Epson

If your scanner is listed as supported by the epkowa backend :

hardware.sane.extraBackends = [ pkgs.epkowa ];

SnapScan firmware

Many scanners require firmware blobs which can be downloaded from the website of the scanner or extracted from the drivers they provide. Once you have the appropriate firmware you need to tell SANE where to find it in your configuration.nix:

{
  hardware.sane.enable = true;
  nixpkgs.config.sane.snapscanFirmware = pkgs.fetchurl {
    # https://wiki.ubuntuusers.de/Scanner/Epson_Perfection/#Unterstuetzte-Geraete
    url = "https://media-cdn.ubuntu-de.org/wiki/attachments/52/46/Esfw41.bin"; #Epson Perfection 2480
    sha256 = "00cv25v4xlrgp3di9bdfd07pffh9jq2j0hncmjv3c65m8bqhjglq";
  };
}

Gimp plugin

To enable the Gimp plugin you need a special version of xsane :

{
  nixpkgs.config.packageOverrides = pkgs: {
    xsaneGimp = pkgs.xsane.override { gimpSupport = true; }; 
  };
}

and you also need to manually create a symlink:

ln -s /run/current-system/sw/bin/xsane ~/.gimp-2.8/plug-ins/xsane

Enable Network Scanning

As of right now ( 2017-08-16 ) the sane backend does not support overriding according to the nixpkgs issue #17411. The workaround for this is to download the sane-extra-config.nix of michaelrus, put it into /etc/nixos/sane-extra-config.nix and use it in your configuration.nix via:

{ ... }:{
 imports = [
  ./sane-extra-config.nix
 ];
 ...
 hardware.sane.extraConfig."magicolor" = ''
   net 10.0.0.30 0x2098
 ''; # magicolor 1690mf
}

@@ Line 1: / Line 1: @@
-== Add SANE firmware ==
+Scanners are handled by the SANE library:
+<syntaxhighlight lang="nix">#/etc/nixos/configuration.nix
+{
+  hardware.sane.enable = true;
+}</syntaxhighlight>
+== Verification ==
+To check quickly if your scanner is detected by SANE, you can use <code>scanimage -L</code>. If root only can detect the scanner, try adding your user in the <code>scanner</code> or <code>lp</code> group.
+== Extra backends ==
+You can check on the [http://www.sane-project.org/sane-supported-devices.html official page of libsane] if your scanner is supported. Some backends are proprietary and not installed by default (see below).
+Note that the selection of the right set of backends by libsane depends on the <code>LD_LIBRARY_PATH</code> environment variable. <code>nixos-rebuild switch</code> is thus not enough to "install" a new backend, you need to logout/login again for changes to take effect.
+=== HP  ===
+<syntaxhighlight lang="nix">hardware.sane.extraBackends = [ pkgs.hplipWithPlugin ];</syntaxhighlight>
+=== Epson ===
+If your scanner is listed as supported by the epkowa backend :
+<syntaxhighlight lang="nix">hardware.sane.extraBackends = [ pkgs.epkowa ];</syntaxhighlight>
+=== SnapScan firmware ===
 Many scanners require firmware blobs which can be downloaded from the website of the scanner or extracted from the drivers they provide. Once you have the appropriate firmware you need to tell SANE where to find it in your configuration.nix:
@@ Line 10: / Line 37: @@
      sha256 = "00cv25v4xlrgp3di9bdfd07pffh9jq2j0hncmjv3c65m8bqhjglq";
    };
-  # to build the gimp plugin
+}</syntaxhighlight>
+== Gimp plugin ==
+To enable the Gimp plugin you need a special version of xsane :
+<syntaxhighlight lang="nix">{
    nixpkgs.config.packageOverrides = pkgs: {
      xsaneGimp = pkgs.xsane.override { gimpSupport = true; };
    };
 }</syntaxhighlight>
-To enable the gimp plugin you also need to manually create a symlink:
+and you also need to manually create a symlink:
 <syntaxhighlight lang="bash">ln -s /run/current-system/sw/bin/xsane ~/.gimp-2.8/plug-ins/xsane</syntaxhighlight>
-== Support for HP scanners ==
-<syntaxhighlight lang="nix">hardware.sane.extraBackends = [ pkgs.hplipWithPlugin ];</syntaxhighlight>
-== Non-root scanning ==
-It seems like you might need to add group scanner to users which should be allowed to use scanner.
 == Enable Network Scanning ==