🐟🖨 Network printing for Sailfish OS
Find a file
2023-01-16 20:35:43 +01:00
.github Create FUNDING.yml 2020-06-07 20:29:03 +02:00
doc Fix image-to-pdf in flowchart, break apart pdf2printable and ppm2pwg boxes 2022-12-17 20:51:01 +01:00
icons Fix icon 2019-12-12 09:31:18 +01:00
ppm2pwg@acc32f3769 Sync submodules 2023-01-16 20:35:43 +01:00
qml Fix advanced page range input 2022-11-17 20:21:43 +01:00
rpm Fix binary installation directive 2022-07-12 14:57:23 +02:00
src Ensure increasing page range list 2022-08-19 18:32:06 +02:00
translations Fix German translation 2022-10-22 13:22:36 +02:00
.gitignore Remove autogeneration of version header 2022-01-01 19:26:40 +01:00
.gitmodules add ppm2pwg as a submodule 2020-05-02 18:14:12 +02:00
harbour-seaprint.desktop Add RemovableMedia permission 2022-04-17 12:11:26 +02:00
harbour-seaprint.pro Sync submodules 2023-01-16 20:35:43 +01:00
LICENSE Create LICENSE 2021-11-08 19:27:52 +01:00
README.md Update README.md 2022-12-17 17:46:08 +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, 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 Plaintext, SeaPrint can render it to PDF internally and then the requirements follow those of PDF. You can also send Plaintext to supporting printers and leave the rendering up to the printer (SeaPrint will strip leading and trailing Form Feed characters and ensure CR+LF newlines, but not do any reflow or similar). Since rendering will differ between printers, this has lowest priority for automatic format selection.

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

When printing images the result may depend on how they are transferred. If a document-oriented format like PDF/Postscript/PWG/URF is used SeaPrint does scale-and-rotate to fit, otherwise (when transferred as PNG or JPEG) that is left up to the printer. Only when printing images as images can the scaling setting be used.

For printing JPEG images, transferring them as JPEG has highest priority. JPEGs are then (losslessly) re-encoded to the baseline encoding profile to work with all printers (since SeaPrint 1.1). For other image formats JPEG has lowest priority as transfer format since it is lossy.

Format flowchart

Flowchart made with GoAT.

pdf2printable, ppm2pwg and baselinify were made especially for SeaPrint and can be found here.

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.