🐟🖨 Network printing for Sailfish OS
Find a file
2022-01-01 19:19:20 +01:00
.github Create FUNDING.yml 2020-06-07 20:29:03 +02:00
icons Fix icon 2019-12-12 09:31:18 +01:00
ppm2pwg@fd04fc7128 Update ppm2pwg 2021-12-02 20:45:52 +01:00
qml Adjust terminology 2021-12-22 14:29:18 +01:00
rpm Use pdf2printable 2021-11-16 20:46:35 +01:00
src Use Bytestream instead of QByteArray for IPP messages 2021-12-14 20:06:16 +01:00
translations Linebreak German translation 2021-12-22 14:50:44 +01:00
.gitignore Update gitignore 2020-06-01 21:08:27 +02:00
.gitmodules add ppm2pwg as a submodule 2020-05-02 18:14:12 +02:00
harbour-seaprint.desktop Add SailJail, move overrides location 2021-12-01 20:30:43 +01:00
harbour-seaprint.pro Set PDF_CREATOR 2022-01-01 19:19:20 +01:00
LICENSE Create LICENSE 2021-11-08 19:27:52 +01:00
README.md Update README.md 2021-12-14 20:41:07 +01:00

SeaPrint

Network printing for Sailfish OS

SeaPrint icon

Print PDFs and images over IPP (Internet Printing Protocol).

Most, but not all, IPP-capable printers are supported.

A minority of printers support only PCL and/or their own proprietary formats, these are not supported.

Format support

For PDFs or plaintext, your printer needs to support one of the following formats:

  • PDF
  • Postscript
  • PWG-raster
  • URF-raster

For Postscript, your printer needs to support Postscript natively. (SeaPrint just sends it as-is)

For printing "Office" files, like .doc(x) and odt, you need to install calligraconverter (from the calligra package in Sailfish OS 4.2 onwards). Then the printer support follows that of PDF.

For images, your printer needs to support one of the following formats:

  • PNG
  • JPEG
  • PWG-raster
  • URF-raster
  • PDF
  • Postscript

For printing JPEG images, transferring the unaltered image has priority and the printer does the scaling. Other image formats are lossless and SeaPrint does scale-and-rotate to fit, so JPEG has lowest prio there.

Printers with any of these IPP certifications and derivative standards should likely be supported:

  • IPP Everywhere
  • AirPrint
  • Mopria
  • WiFi Direct

(obviously SeaPrint is unaffiliated and uncertified)

Dealing with misbehaving printers

SeaPrint, in contrast to other printing clients, is not concerned with dealing with the idiosyncrasies of individual printers. If some manufacturer can't make a reasonably well-behaved printer that's on them, not something for SeaPrint to cover for.

There is however a possibility for you, the user, to override certain attributes (to fix names, claimed format support etc.) in the IPP data structure.

To see what your printer sent, aka "the debug info", tap it 5 times rapidly without any document selected. The format is a SeaPrint-specific JSON equivalent representation of the IPP binary data.

Create the file /home/$USER/.config/net.attah/seaprint/overrides. (NB: New location for 1.0, and may move again)

This file should contain a JSON structure, with the outermost key(s) being "what attribute to match on" (uuid recommended if available), the next level is "if this value matches". Everything beneath that is what to inject/replace into the printer's attributes (see debug info above).

Example:

{
  "printer-uuid": {
    "urn:uuid:xxx-yyy-zzz-111-1234567890": {
      "printer-name": {
        "tag": 54,
        "value": "A better name"
      },
      "document-format-supported": {
        "tag": 73,
        "value": [
          "application/octet-stream", "application/pdf"
        ]
      },
      "some-other-attribute-name": {
        "tag": 42,
        "value": "some-value"
      }
    },
    "urn:uuid:other-printer-uuid": {
      ...
    }
  },
  "other-attribute-to-match-other-printer-on": {
    ...
  }
}

Dealing with printers using other protocols

SeaPrint only supports IPP, not port 9100 pjl/pcl raw, lpd/lpr or anything else.

Just use a PAPPL or CUPS as an intermediary. A shared printer there is IPP by definition.