Skip to content

Commit 99ac55a

Browse files
committed
README.md: various notes added
- current printing stack explained - future with CUPS 3.0 commented - the current s-c-p status mentioned - add the note for looking for co-developer
1 parent 58b1f94 commit 99ac55a

1 file changed

Lines changed: 78 additions & 2 deletions

File tree

README.md

Lines changed: 78 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,77 @@
22

33
[![Build Status](https://travis-ci.org/OpenPrinting/system-config-printer.svg?branch=master)](https://travis-ci.org/OpenPrinting/system-config-printer)
44

5-
This is a graphical tool for CUPS administration. It uses IPP to
6-
configure a CUPS server.
5+
This is a graphical tool for CUPS administration - system-config-printer (s-c-p).
6+
It uses IPP to configure a CUPS server. Additionally it provides dBUS interface
7+
for several operations which aren't directly available in cupsd, and automatic USB
8+
printer installation daemon for non-IPP-over-USB printers.
9+
10+
The alternatives for the graphical configuration tool are CUPS Web
11+
interface, desktop control-center or lpadmin command line tool if you need
12+
to install printer manually which may not be needed in recent cases.
13+
14+
WHEN I DO NOT NEED PRINTER SETUP TOOL AS S-C-P?
15+
-----------------------------------------------
16+
17+
If the application where you print from has an up-to-date print dialog
18+
(uses the current CUPS API) and your printer is set up for driverless printing
19+
(has AirPrint/IPP Everywhere/IPP-over-USB support, opened port 631, lies in your local network
20+
and Avahi is running, IPP and mDNS is enabled in your firewall, ipp-usb is installed if
21+
your printer is connected by USB), you don't to install the printer at all. The dialog
22+
is able to pick up the printer right before you open the dialog and it disappears
23+
once you don't need it (reappearing next time you open the dialog again).
24+
This appearing and disappearing printer is called CUPS temporary queue.
25+
26+
The devices supporting AirPrint/IPP Everywhere appear since 2010 (IPP-over-USB devices a bit later),
27+
so if your device was made after 2010, there is a great chance it supports the standards.
28+
29+
From the dialogs I'm aware of the temporary queues are currently supported in any GTK3
30+
based application (evince, gvim, gedit, firefox if you are on GNOME and choose system
31+
dialog for printing...) and in Libreoffice.
32+
33+
FUTURE WITH CUPS 3.0:
34+
---------------------
35+
36+
CUPS 3.0 will divide the current CUPS in several modules - command line tools, library,
37+
CUPS Local server and CUPS Sharing server. CUPS Local server will be designed as lightweight
38+
for desktop usage, supporting only CUPS temporary queues. CUPS Sharing server will be more like
39+
the current cupsd, supporting permanent driverless queues, suited for servers.
40+
41+
system-config-printer is often used on desktops where will be CUPS Local server installed by default.
42+
Since the server will support only CUPS temporary queues, system-config-printer will need to work
43+
with IPP services which are on localhost (USB devices, printer applications and permanent driverless
44+
queues from CUPS Sharing server if installed as well), in local network or defined by printer profiles,
45+
if system-config-printer should work with CUPS 3.0.
46+
47+
IS S-C-P REQUIRED IN SYSTEM WITH CUPS 3.0?
48+
------------------------------------------
49+
50+
Regarding printer setup tools OpenPrinting current plans are to integrate printer setup dialog into
51+
common print dialog, which would enable non-driverless printer installation (via printer application)
52+
right when user needs it - right before the printing.
53+
54+
dBUS interface (but probably not the same methods) will be available in CUPS 3.0 project
55+
and since non-driverless devices are less common with time OpenPrinting group agreed there
56+
won't be an automatic installation mechanism for them.
57+
58+
So the standalone configuration tool like system-config-printer isn't a priority in system with CUPS 3.0,
59+
but it can exist together with CUPS 3.0 if updated. The next point is connected to the matter.
60+
61+
NEW DEVELOPER OR CO-MAINTAINER WANTED:
62+
--------------------------------------
63+
64+
I'm looking for a new developer or co-maintainer for system-config-printer and pycups,
65+
who would update/help to update them to the current standards.
66+
67+
In case of system-config-printer it consists:
68+
- migration to GTK 4,
69+
- migration of dbus code because dbus-python is deprecated,
70+
- support for installing printer applications from various sources (.rpm, .deb, snap, flatpak),
71+
- support for managing IPP services instead of permanent CUPS queues.
72+
- implementation of unit tests and overall updating the python code to current PEPs
73+
74+
The project is kept in maintenance mode (accepting and testing sent patches, limited new development)
75+
until there is such a person.
776

877
Build requirements:
978
-------------------
@@ -56,3 +125,10 @@ How to uninstall:
56125
```
57126
$ sudo make uninstall
58127
```
128+
129+
Translations:
130+
-------------
131+
132+
Translations are available at [Fedora Weblate](https://translate.fedoraproject.org).
133+
If you want to update translations, please update it in Weblate. The Weblate then creates
134+
automatic PR, which keeps upstream project and Weblate project in synch.

0 commit comments

Comments
 (0)