CUPS/Foomatic driver for Brother P-touch label printers

This is the home page of ptouch-driver, a driver for the Brother P-touch series of label printers. It consists of a raster-to-printerdata filter, and XML data files for the foomatic database.

Please note that this is still beta software, probably full of bugs.

Technical information about the Brother P-touch QL500 is available at Renaud Bompuis' site.




To install the tar file distribution, run

 > tar zxf ptouch-driver-*.tar.gz
 > cd ptouch-driver-*
 > ./configure
 > make
 > make install

If you do not have root access, you will probably need to use the --prefix=... option to ./configure. Run ./configure --help to view available options.


online documentation of the CUPS rastertoptch filter is generated from the source code using doxygen.

Reporting Bugs

If you think you have found a bug and want to report it,

  1. Find a minimal input example PostScript document that elicits the bug.
  2. Set up CUPS for debugging by setting LogLevel debug in /etc/cups/cupsd.conf, and restart CUPS, e.g. by service cups restart.
  3. Redirect the raw printer data to a file by setting "print to file" in your printer configuration application. If you use http://localhost:631 to do this, click on Modify Printer, Continue, select AppSocket, Continue, and then enter a device URI like file:/home/myname/ql500-data.raw, Continue.
  4. When submitting a bug report, include
    1. A good description of the bug symptoms and circumstances.
    2. The PostScript input example file.
    3. The CUPS error log excerpt from /var/log/cups/error_log.
    4. The raw printer data file.

Last updated Wednesday 4 February 2009 by Arne John Glenstrup