Difference between revisions of "CUPS/Printer-specific problems"

From ArchWiki
Jump to: navigation, search
m (foo2zjs Driver: laserJet -> LaserJet)
m (foo2zjs: The older thread appears to be the only one with useful information, so just mention that for now.)
(5 intermediate revisions by the same user not shown)
Line 532: Line 532:
See also [[CUPS/Troubleshooting#HP issues]].
See also [[CUPS/Troubleshooting#HP issues]].
Most HP printers will use {{Pkg|hplip}}, but some may use {{AUR|hpoj}}. Yet some laser printers are supported by {{AUR|foo2zjs-nightly}}.
Most HP printers will use {{Pkg|hplip}}, but some may use {{AUR|hpoj}}. Some laser printers are also supported by {{AUR|foo2zjs-nightly}}.
{| class="wikitable"
{| class="wikitable"
Line 566: Line 566:
====== HPLIP Driver ======
=== HPLIP ===
{{Note|As of hplip v3.17.11 hpijs is not longer available. If you have printers using hpijs they will fail to print. You must modify them and select the new hpcups driver instead.}}
{{Note|As of hplip v3.17.11 hpijs is not longer available. If you have printers using hpijs they will fail to print. You must modify them and select the new hpcups driver instead.}}
Line 596: Line 596:
* '''Or:''' Remove {{Pkg|hplip}}, {{Pkg|foomatic-db}} and {{Pkg|foomatic-db-engine}} along with any unnecessary dependencies. Reinstall {{Pkg|hplip}} and restart CUPS. Install your printer using the CUPS web UI, which should now be able to find the drivers automatically. No reboot needed.}}
* '''Or:''' Remove {{Pkg|hplip}}, {{Pkg|foomatic-db}} and {{Pkg|foomatic-db-engine}} along with any unnecessary dependencies. Reinstall {{Pkg|hplip}} and restart CUPS. Install your printer using the CUPS web UI, which should now be able to find the drivers automatically. No reboot needed.}}
====== foo2zjs Driver ======
=== foo2zjs ===
This driver is for printers that use the ZjStream protocol. These are some of HP LaserJet printers, as well as printers from other manufactures that use this protocol.
At the time of writing, June 2018, the hplip package interfere with foo2zjs. If you have both installed you should read this [https://bbs.archlinux.org/viewtopic.php?pid=1788866#p1788866 forum post] and [https://bugs.archlinux.org/task/58815 bug report]. It is advised for those interested in the forum post '''not''' to skip the [https://bbs.archlinux.org/viewtopic.php?pid=1662809#p1662809 older thread].
[http://foo2zjs.rkkda.com/ foo2zjs] supports some HP LaserJet printers. As of June 2018 the hplip package interferes with {{aur|foo2zjs-nightly}}, as described at [https://bbs.archlinux.org/viewtopic.php?pid=1662809 this forum post] and {{Bug|58815}}.

Revision as of 06:51, 9 June 2018

This article contains printer or manufacturer-specific instructions for CUPS. See OpenPrinting if your printer is not already listed here, or if none of the listed drivers work.

Note: If you add a printer to this list, consider contributing your entry to OpenPrinting - that way users of other distributions will also benefit!


Printer Driver/filter Notes
DCP-135C brother-dcp135cAUR
DCP-150C brother-dcp150cAUR
DCP-7020 foomatic Or Brother's driver.
DCP-7030 brother-dcp7030AUR
DCP-7065DN brother-dcp7065dnAUR
FAX-2820 brother-cups-wrapper-laserAUR
FAX-2840 brother-fax2840AUR Or foomatic - works mostly with hpijs-pcl5e.ppd. Same as the HL-2170W.
FAX-2940 brother-fax2940AUR
HL-2030 foomatic Or brother-hl2030AUR
HL-2035 foomatic Should be compatible with any drivers for the HL-2030.
HL-2040 foomatic Or brother-hl2040AUR
HL-2130 foomatic (using the HL-2140 driver) Or hplip
HL-2140 foomatic Or brother-hl2140AUR
HL-2170W foomatic Or Brother's driver.
HL-2230 foomatic Same as HL-2170W. Select HL-2170W as the driver in CUPS admin when adding a printer.
HL-2250DN brother-hl2250dnAUR
HL-2270DW brother-hl2270dwAUR
HL-2280DW brother-hl2280dwAUR
HL-2340DW brother-hll2340dwAUR
HL-3045CN Install Brother's driver.
HL-3140CW brother-hl3140cwAUR Use IPP and Brother's driver to avoid page-shrinking and endless blank printouts
HL-3150CDW brother-hl3150cdwAUR
HL-3170CDW brother-hl3170cdwAUR
HL-5140 foomatic Or Brother's driver.
HL-5340 foomatic Using the Generic PCL 6/PCL XL Printer - CUPS+Gutenprint (gutenprint and foomatic-db-gutenprint-ppds). Or Brother's driver, which may result in failed prints with postscript errors.
HL-L2300D brother-hll2300dAUR
HL-L2350DW brother-hll2350dwAUR
HL-L2380DW brother-hll2380dwAUR
HL-L2395DW brother-hll2395dwAUR Use socket protocol (socket://hostname-or-ip:9100).
HL-L5100DN HP LaserJet Foomatic driver This model will emulate a HP LaserJet. lpd://hostname-or-ip/BINARY_P1
MFC-420CN brother-mfc-420cnAUR
MFC-440CN brother-mfc-440cnAUR
MFC-7360N brother-mfc7360nAUR
MFC-7840W brother-mfc-7840wAUR
MFC-9320CW Install Brother's driver.
MFC-9332CDW brother-mfc-9332cdwAUR
MFC-9840CDW foomatic Or Brother's driver. This printer also works with the generic PCL-6 driver from the gutenprint package. Use pcl_p1 for the printer's address when using the PCL-6 driver.
MFC-J470DW brother-mfc-j470dwAUR
MFC-J480DW brother-mfc-j480dwAUR Use ipp:// described below.
MFC-J5520DW brother-mfc-j5520dwAUR
MFC-J5910DW brother-mfc-j5910dwAUR
MFC-J650DW Install Brother's driver.
MFC-J885DW brother-mfc-j885dwAUR
MFC-J985DW brother-mfc-j985dwAUR
MFC-L2700DW brother-mfc-l2700dwAUR Please look also at the comments section of the AUR package page.
QL-500 brother-ql500AUR
QL-570 brother-ql570AUR
QL-580N brother-ql580nAUR
QL-650TD brother-ql650tdAUR
QL-700 brother-ql700AUR
QL-710W brother-ql710wAUR
QL-720NW brother-ql720nwAUR
QL-1050 brother-ql1050AUR
QL-1050N brother-ql1050nAUR
QL-1060 brother-ql1060nAUR
TD-2020 brother-td2020AUR
TD-2120N brother-td2120nAUR
TD-2130N brother-td2130nAUR
TD-4000 brother-td4000AUR
TD-4100N brother-td4100nAUR
Printer Driver/filter Notes

Network printers

For network printers, use ipp://printer_ip/ipp/port1 as printer address. For some older printers, this might not work. If not, try lpd://printer_ip/BINARY_P1 instead.

Some printers use the socket protocol. For these printers, use socket://printer_ip:9100. For http, use http://printer_ip/POSTSCRIPT_P1.

Custom drivers

Brother provides custom drivers on their website, either in source tarball, rpm, or deb form. Packaging Brother printer drivers covers creating PKGBUILDs from the existing RPM packages.

Note: The source packages might be a better alternative to the rpm packages, provided they contain all the needed files.

Manually installing from the RPM packages

Warning: This should ideally be automated in a PKGBUILD

Install the rpmextract package, and extract both rpm packages using rpmextract.sh. Extracting both files will create a var and a usr directory - move the contents of both directories into the corresponding root directories.

Run the cups wrapper file in /usr/local/Brother/cupswrapper. This should automatically install and configure your brother printer.

Updating the firmware

Install net-snmp and run:

snmpwalk -c public $PRINTER_IP | grep -A 1

At this point, you will have the relevant data to get a valid firmware download link from Brother. The file should look similar to the one below:


Post this file to Brother:

curl -X POST -d @request.xml https://firmverup.brother.co.jp/kne_bh7_update_nt_ssl/ifax2.asmx/fileUpdate -H "Content-Type:text/xml" > response.xml

In response.xml you will find a <PATH> tag that contains the firmware download URL. Next, download the firmware, push it to the printer, and let the printer process it. Before that is done, change the Admin password to something known, it will be used as the user to log into the FTP site (VERY bad practice, don't do this).

wget http://update-akamai.brother.co.jp/CS/LZ4266_W.djf
 send LZ4266_W.djf

With that, the printer will restart, and the latest firmware will be installed and (hopefully) your printing woes will be solved.


There are many possible drivers for Canon printers. Many Canon printers are supported by gutenprint. Some of Canon's LBP, iR, and MF printers use a driver supporting the UFR II/UFR II LT/LIPSLX protocols, which is available as cndrvcups-lbAUR or cndrvcups-lb-binAUR. Others use the #CARPS, #cnijfilter, or Canon CAPT drivers.

Printer Driver/filter Notes
iP4300 gutenprint Or use the TurboPrint driver.
LBP810 Canon CAPT
LBP5050 series
LBP7200Cdn (network mode)
LBP7200C series
MF4720w cndrvcups-lb-binAUR
MG4200 series cnijfilter-mg4200AUR Avoid the web interface when adding the printer as it won't find the PPD file.
TS8050 cnijfilter2AUR Without cnijfilter2AUR printing will fail with a filter error or you might get "Rendering Completed" and nothing will print
TS9020 canon-ts9020AUR
Printer Driver/filter Notes

Some Canon printers will use a similar setup to the iP4500, so consider modifying the cnijfilter-ip4500AUR package for other, similar printers.


Some of Canon's printers use Canon's proprietary Canon Advanced Raster Printing System (CARPS) driver. Rainbow Software have managed to reverse engineer the CARPS data format and have successfully created a CARPS CUPS driver, which is available as carps-cupsAUR. The project's GitHub page includes a list of working printers.

USB over IP (BJNP)

Some Canon printers use Canon's proprietary USB over IP BJNP protocol to communicate over the network. There is a CUPS backend for this, which is available as cups-bjnpAUR.


Some printers using the cnijfilter drivers support the cnijnet protocol. To find the printer URI run

$ cnijnetprn --search auto

and use the cnijnet:/ URI in the output.

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: The URI appears to be of the form cnijnet:/ followed by the MAC address of the printer. If this is the case it would be good to mention it here. (Discuss in Talk:CUPS/Printer-specific problems#)


Printer Driver/filter Notes
1250C foo2zjs-nightlyAUR See http://cybercom.net/~dcoffin/hbpl, the patch has been merged into upstream. The printer may also work with the Xerox Phaser 6000B driver.
C1660NW foo2zjs-nightlyAUR The printer may also work with the Xerox Phaser 6000B driver.


Install Dell's driver. Both e515dwcupswrapper-3.2.0-1.i386.deb and e515dwlpr-3.2.0-1.i386.deb need to be installed. You could either write a PKGBUILD, use debtapAUR, or use dpkgAUR (using dpkg is not recommended as the files will not be managed by pacman). The driver works on both the x86_64 and i386 platforms, but may require multilib.
S1130n dell-unified-printer-driverAUR Driver conflicts with samsung-unified-driver-printer (both create rastertospl and libscmssc.so)
Printer Driver/filter Notes


epson-inkjet-printer-escprAUR and epson-inkjet-printer-escpr2AUR are sets of drivers using the Epson Inkjet Printer Driver (ESC/P-R) for Linux.

Printer Driver/filter Notes
AcuLaser CX11(NF) epson-alcx11-filterAUR
AcuLaser C900 This printer uses Epson's driver, with a device URI of 'usb://EPSON/AL-C900', and may need the pipsplus service to be running.
EP-50V epson-inkjet-printer-escpr2AUR
ET-2700 epson-inkjet-printer-escprAUR
ET-3700 epson-inkjet-printer-escpr2AUR
EW-M571T epson-inkjet-printer-escprAUR
EW-M670FT epson-inkjet-printer-escpr2AUR
L380 epson-inkjet-printer-201601wAUR
L4150 epson-inkjet-printer-escprAUR
L6160 epson-inkjet-printer-escpr2AUR
LP-S5000 This printer requires a custom driver from Avasys.
PM-520 epson-inkjet-printer-escpr2AUR
TX125 epson-inkjet-printer-n10-nx127AUR
WF-3720 epson-inkjet-printer-escpr2AUR
XP-446 epson-inkjet-printer-escprAUR
XP-5100 epson-inkjet-printer-escpr2AUR
Printer Driver/filter Notes



escputil is part of the gutenprint package, and performs some utility functions on Epson printers such as nozzle cleaning.


This is a printer status monitor which enables to get the remaining ink quantity, to print test patterns, to reset printer and to clean nozzle. It use an intuitive graphical user interface.


This is a GUI using escputil and cups drivers. It supports nearly all USB printer of Epson and displays ink quantity, can clean and align print heads and print test patterns.

Custom drivers


Warning: This section involves installing packages without pacman. These directions should ideally be automated with a PKGBUILD.

"Source" code of the driver is available on the avasys website, in Japanese, however it includes a 32 bit binary which will cause problem on 64 bit system.

  • Download the source code of the driver.
  • Compile and install the driver.
$ ./configure --prefix=/usr
$ make
# make install

If you have any problems on a 64 system, some other lib32 libraries may be required. Please adjust this page if that is the case.


See also CUPS/Troubleshooting#HP issues.

Most HP printers will use hplip, but some may use hpojAUR. Some laser printers are also supported by foo2zjs-nightlyAUR.

Printer Driver/filter Notes
DeskJet 710C pnm2ppaAUR
DeskJet 712C
DeskJet 720C
DeskJet 722C
DeskJet 820se
DeskJet 820Cxi
DeskJet 1000Cse
DeskJet 1000Cxi
LaserJet P1606dn hplip + hplip-pluginAUR Or foo2zjs-nightlyAUR, or AirPrint.
LaserJet Pro MFP M126nw hplip + hplip-pluginAUR
Photosmart 2575 hplip Or use the hpijs driver in foomatic.
Printer Driver/filter Notes


Note: As of hplip v3.17.11 hpijs is not longer available. If you have printers using hpijs they will fail to print. You must modify them and select the new hpcups driver instead.

hplip provides drivers for HP DeskJet, OfficeJet, Photosmart, Business Inkjet, and some LaserJet printers, and also provides an easy to use setup tool. See https://developers.hp.com/hp-linux-imaging-and-printing/supported_devices/index for the list of supported printers.

To run the setup tool with the GUI qt frontend:

# hp-setup -u

To run the setup tool with the command line frontend:

# hp-setup -i

To set up directly the configuration of a network connected HP printer:

# hp-setup -i <ip address>

To run systray spool manager:

$ hp-systray

To generate a URI for a given ip address:

# hp-makeuri <ip address>

PPD files are in /usr/share/ppd/HP/.

If your printer is listed as requiring a binary plugin, install the hplip-pluginAUR package from AUR. If the binary plugin hplip-pluginAUR is a requirement you will need to start the org.cups.cupsd.service before the PPD is recognized by hplip.


hplip depends on foomatic-db-engine which prevents the drivers list from appearing when a printer is added to CUPS via the web user interface (following error : "Unable to get list of printer drivers"). Possible workarounds:

  • Either: Install hplip first, then retrieve the PPD file that matches your printer from /usr/share/ppd/HP/. Next, remove hplip entirely as well as any unnecessary dependencies. Finally, install the printer manually using the CUPS web UI, selecting the PPD file you retrieved, and then re-install hplip. After a reboot, you should have a fully working printer.
  • Or: Remove hplip, foomatic-db and foomatic-db-engine along with any unnecessary dependencies. Reinstall hplip and restart CUPS. Install your printer using the CUPS web UI, which should now be able to find the drivers automatically. No reboot needed.


foo2zjs supports some HP LaserJet printers. As of June 2018 the hplip package interferes with foo2zjs-nightlyAUR, as described at this forum post and FS#58815.


Printer Driver/filter Notes
Minolta Magicolor 1600W foomatic
Minolta Magicolor 1680MF
Minolta Magicolor 1690MF
Minolta Magicolor 2480MF
Minolta Magicolor 2490MF
Minolta Magicolor 2530DL
Minolta Magicolor 4690MF
Printer Driver/filter Notes



Lexmark provides a utility called lexijtools with the drivers.

Custom drivers

Lexmark does provide Linux drivers for all their hardware. The following packages are required:

The drivers will need to be downloaded from Lexmark's website. Preferably, create a package (see Creating packages) and install it. Here is a basic PKGBUILD that still needs work but will give an idea of what is required.

# Contributor: Todd Partridge (Gen2ly) toddrpartridge (at) yahoo

pkgdesc="Lexmark Z2300 and 2600 Series printer driver for cups"
depends=('cups' 'glibc' 'ncurses' 'libusb' 'libxext' 'libxtst' 'libxi' 'libstdc++5' 'krb5' 'lua' 'java-runtime')
conflicts=('z600' 'cjlz35le-cups' 'cups-lexmark-700')

package() {
  # Extract installer
  sh lexmark-inkjet-08-driver-1.0-1.i386.tar.gz.sh --target Installer-Files
  cd Installer-Files
  mkdir Driver
  tar xvvf instarchive_all --lzma -C Driver/
  cd Driver
  tar xv lexmark-inkjet-08-driver-1.0-1.i386.tar.gz -C $pkgdir

Keep in mind you can use the automated installer but doing so will leave the resulting changes untracked. The PPD will be installed into /usr/local/lexmark/lxk08/etc/ or similar, depending on the printer model.


Printer Driver/filter Notes
C110 foomatic
MC561 foomatic-db-nonfree
Printer Driver/filter Notes


Install openprinting-ppds-pxlmono-ricohAUR if your device is black and white, or openprinting-ppds-pxlcolor-ricohAUR if it's color. Note that Ricoh copiers are sometimes branded as Savin, Gestetner, Lanier, Rex-Rotary, Nashuatec, and/or IKON. So, if you have a device bearing one of these brands, it may be supported by these drivers as well.

For winprinters (Ricoh series SP100 and SP200) try out ricoh-sp100-gitAUR.

Printer Driver/filter Notes
SP 112 ricoh-sp100-gitAUR
SP 201n ricoh-sp100-gitAUR
213W Generic PCL Laser Obtain a WPS code by holding down the wifi button for 2 seconds, then hitting the stop/start button.
Printer Driver/filter Notes


Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: All the cnijfilter drivers appear to be for Canon printers - maybe the cnijfilter comment would be better off in the Canon section? (Discuss in Talk:CUPS/Printer-specific problems#)

For printers requiring the cnijfilter drivers, search for the correct driver in the AUR

Printer Driver/filter Notes
ML-2010 splix
SCX-4200 splix
Newer printers? samsung-unified-driverAUR
Printer Driver/filter Notes

Xerox or FujiXerox

Printer Driver/filter Notes
DocuPrint 203A hplip Using the DocuPrint P8e(hpijs) driver, or the Brother driver on FujiXerox's website (see #Brother for more information on how to install custom Brother drivers).
Phaser 3100MFP Install Xerox's driver See #Phaser 3100MFP for more instructions.
Phaser 6115MFP foomatic
Phaser 6121MFP foomatic
Printer Driver/filter Notes

Custom drivers

Phaser 3100MFP

Warning: This section involves installing packages without pacman. These directions should ideally be automated with a PKGBUILD.

Once you have downloaded the drivers, execute the driver installer and accept the licence:

# cd printer
# ./XeroxPhaser3100.install

Note that the driver is 32 bit, so some 32 bit libraries will be required on an x86_64 system.

For the scanner, create an /etc/sane.d directory if it doesn't already exist, because it's need by the installer:

# mkdir -p /etc/sane.d

Now install the driver:

# cd scanner/
# ./XeroxPhaser3100sc.install

Again, on an x86_64 install, 32 bit libraries will be needed.

Phaser 6000B

Install the xerox-phaser-6010 package (archived from the AUR). The driver may require older versions of nettle and gnutls to be installed, since the binary blob linked against older versions of the shared libraries provided by those packages. The oldest known-good versions are nettle-2.7.1-1 and gnutls-3.3.13-1.

Phaser 6125N

Warning: This section involves installing packages without pacman. These directions should ideally be automated with a PKGBUILD.

FujiXerox does not support Linux on this model. An old rpm is available but does not seem to work.

A slightly adapted custom driver has been found to work out of the box.

To install the tarball, run

# tar -C / --keep-newer-files -xvzf cups-xerox-phaser-6125n-1.0.0.tar.gz