system-config-printer

This page is about the printer administration tool system-config-printer, which first appeared in Fedora (as part of my work at Red Hat), and later Ubuntu and other operating systems.

The purpose of the tool is to configure a CUPS server (often the local machine) using the CUPS API. The tool is written in Python, using pygtk for the graphical parts and with some Python bindings (pycups) for the CUPS API.

It is largely the same as using the CUPS web interface for configuring printers, but has the advantage of being a native application rather than a web page. It appears in the Fedora menu under System ▸ Administration ▸ Printing.

As a result of using the CUPS API the tool is able to configure remote CUPS instances and is not limited to configuring CUPS on the local machine. The CUPS library providing the API uses HTTP and IPP to communicate with the CUPS server.

I work on this application as part of my job at Red Hat.

Download

Download tarball releases from:
http://cyberelk.net/tim/data/system-config-printer/

You will also require pycups from:
http://cyberelk.net/tim/software/pycups/

Source Code

The git repository is available at fedorahosted.org:

git clone git://git.fedorahosted.org/git/system-config-printer.git

or browse using gitweb.

New releases are announced at freshmeat.

Translations

Language translations should be submitted through Fedora Transifex.

Mailing list

There is a public mailing list for discussion of the development of this project.

Reporting bugs

If you have found a bug in system-config-printer, please report it. If system-config-printer came with your operating system, report the bug to the operating system vendor:

295 Responses to “system-config-printer”

  1. Ronnie says:

    Hello, my pc is running Linux Ubuntu 12.04.3 LTS
    with CUPS system-config-printer 1.3.8 installed.

    Am using an Epson Stylus D88 Inkjet Printer connected to above > no problems.

    My question is about the Ink Toner Levels:-

    “Marker levels are not reported for this printer”.
    (4) CYMK

    Is there a facility to show these levels?

    Merry Christmas and Thanks in advance of any reply.

    Ronnie

    • Tim says:

      For the time being you have to use the “escputil” program that comes with gutenprint for that. Ideally the gutenprint driver itself would query the device and report the levels to CUPS, but until then escputil is what we have.

  2. Xzu says:

    Hi.
    I would like to translate terms of configuration in french.
    “Language translations should be submitted through Fedora Transifex.” >is broken :/ .

  3. Paul says:

    Hi, I have never installed a file like the one I get when I go to the web site: http://cyberelk.net/tim/data/system-config-printer/

    I’ve installed several Linux distributions but all are causing my printer to print with a blank page and continuously, yes…until the paper runs out or I pull the plug. I have never seen this before and can’t figure it out. How to I load or install the program at the web page. Is it contained in a download package? If not where can I find the procedure to install it.

    • Tim says:

      That’s called a “tarball”. If you are new to Linux you probably want to stick with the pre-packaged applications from your distribution vendor to start with. Have you filed a bug report with them about your printing problem?

  4. david larson says:

    printer will not operate because it is on “paused”. how do I un-pause it?

    • Tim says:

      The queue is not enabled. Select the printer, then from the menu bar select Printer > Enabled.

      • Darren says:

        Hi there I am new to this operating system, I am using Ubuntu ver. 13.10 and I have an HP Deskjet 1000 printer. The computer installed the drivers ok but in the status line of the printer properties it says Idle – Sending data to printer. but nothing is happening and when I open the view print queue there is nothing there how can I fix this

  5. Pertti Laine says:

    My printer Epson Stylus SX420W is not working scanner.Printer is ok and work.
    Scanner error W-61..whats is wrong??..what missing..i have mscan and ascan-data programs in pc lubuntu

  6. PRERNA says:

    I am using BOSS operating system.
    previously my printer name is displayed n evrythng prints fine. but suddenly it stops displaying printer name . it only shows print to file option. what to do?
    I am new to dis OS.

  7. Mark says:

    Whenever I run system-config-printer, zombie printers that I used to have installed keep reappearing. If I delete them from inside system-config-printer, the next time I run it they appear again! Somewhere there must be a config file that these are hiding in, but I’ve searched and can’t find it. Anyone know where this might be?

  8. charles wautelet says:

    My printer a Canon 2450 prints all the caracters in reverse. . Could you say me how i can get a normal printing .

    • Tim says:

      It sounds like a driver problem, so it depends on the driver you’re using. If it’s one that came with the OS, best idea is to report a bug with that OS.

      • donna says:

        i have never used this linux before. i cannot get printer to be avaiable or scanneror ink levels
        the printer is an epson artisan 810.
        please what do i do

  9. donna says:

    i am new to ubuntu Version 34.0.1847.116 Ubuntu 12.04 (260972)
    the printer will not connect. by way of wifi or wire

    socket://printer:9100
    Epson Artisan 810 – CUPS+Gutenprint v5.2.8-pre1
    Processing – Unable to locate printer “printer”.

    is their any way you could help me with getting this printer on line please

    • Tim says:

      I think you have the wrong name. It’s saying it can’t find a host called “printer”. Instead of “printer”, put in the hostname or IP address of the printer.

  10. donna says:

    forgive me but don’t know host name and how do i find printer ip address

    • Tim says:

      If you don’t know how to find those out, you are better off connecting it directly with USB. But ask on the Ubuntu forums: I don’t use Ubuntu myself so people in those forums are more likely to be able to help.

  11. donna says:

    i did connect with usb as well but it still says not connected. thats why i din’t understand

  12. linda churchill says:

    I am new to this OS (don’t much like it, difficult to figure out) Epson xp-410 will run paper thru on test print but will not print any words…CUPS server error Status 1000….what’s that all about…in English please:)

    • Tim says:

      Looks like this model requires a non-free driver:
      http://www.openprinting.org/printer/Epson/Epson-XP-410_Series

      Please note that system-config-printer runs on several operating systems (Ubuntu, Fedora, etc), so I don’t know which you are using. The best idea is to ask in the forums provided by your OS vendor, e.g. ubuntuforums.org, ask.fedoraproject.org, fedoraforum.org, etc.

      Status 1000 sounds like ‘user canceled authorization’: e.g. you closed a dialog asking for a password, or perhaps the account you are logged in using is not permitted to alter printer settings.

  13. Sevak says:

    Hi,

    I was trying to share a printer on my network following the guide at https://help.ubuntu.com/community/NetworkPrintingWithUbuntu and came across the following error.

    I set up everything based on the guide and tried to print a page from a different computer and it didn’t work. I went back to check the settings, and I couldn’t access them. Whenever I open Printers->Server->Settings I get the following error

    CUPS server error
    There was an HTTP error: Not found.

    Restarting the computer, the cups server or even reinstalling cups and system-config-prnter didn’t help. I tried searching the internet for the error, but couldn’t find much. For the only error message that came close people suggested the user didn’t have the necessary privileges. This definitely is not the case for me, as I have administrator privileges and only several minutes ago I was able to access the settings.

    Canon MG2200 printer connected to a Dell inspiron laptop running a fresh install of 14.04

    How do I get rid of this error message and gain access to the settings?

    I would appreciate any help in resolving this problem. I can’t quite understand the error message and I haven’t found a way to reset the settings.

    Thanks

Leave a reply

Comments are moderated. Comments that are inappropriate, offensive, vulgar, badly written or insulting will be deleted or edited to make the author look silly.