.. /*  
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _ch-printer-windows:

Printing from Windows
---------------------

.. contents:: |RST_TABLE_OF_CONTENTS|
   :depth: 2
   :local:


.. _ch-printer-windows-install-driver:

.. list-table:: Printing from Windows
   :width: 100%
   :widths: 12 88
   
   * - |image75|

     - If :ref:`SavaPage IPP Everywhere <ch-printer-ipp-everywhere>` is 
       configured in a Local Network, the corresponding printer is automatically
       detected by Windows and can be used without any configuration by executing
       “Add a printer or scanner”. As a response Windows will be “Searching
       for Printers and Scanners”: pick the detected SavaPage printer and select 
       “Add device". |br| 
       |br|

       -  Make sure Windows IPP printing is enabled as explained in
          :ref:`IPP Printer <ch-printer-windows-install-ipp-printer>`.

       -  :ref:`IP Based Authentication <ch-auth-ip-based>` or :ref:`Basic
          Authentication <ch-auth-basic>` is needed before submitting a print job.

   * - |image76|

     - Installing a :ref:`IPP Printer <ch-printer-windows-install-ipp-printer>`
       or :ref:`Raw Printer <ch-printer-windows-install-local-printer>` is
       similar for different Windows versions with slight variations in
       dialog appearance. |br|
       |br|
       When asked for a *printer driver*, pick a plain PostScript driver from
       the list. Any type/model will do, as long as it generates standard
       PostScript spool files. It makes sense to select just a simple,
       no-frills type/model. |br| 
       |br|

       .. caution::
       
          Although a printer driver may render printed documents correctly on
          first sight, its SafePages PDF might not be  *searchable*. You can
          simply :ref:`Download the PDF <ch-webapp-user-main-pdf>` result and
          check with a simple copy/paste of text. When the pasted result is
          garbled, the printer driver delivered so-called “Mojibake” [3]_ .


.. [3]
   `Mojibake <https://en.wikipedia.org/wiki/Mojibake>`__ is the garbled
   text that is the result of text being decoded using an unintended
   character encoding. The result is a systematic replacement of symbols
   with completely unrelated ones, often from a different writing
   system.


.. _ch-printer-windows-install-ipp-printer:

IPP Printer
~~~~~~~~~~~

Before adding a SavaPage IPP Printer make sure IPP printing is enabled.

1. Go to Control Panel

2. Select **Programs and Features**

3. Select **Turn Windows features on or off**

4. In the features list, scroll down to **Print and Document Services** and
   verify that the **Internet Printing Client** checkbox is checked. If not,
   check this option and click **OK**.

To add SavaPage as IPP Printer, start the **Add a printer or scanner**
dialog, choose **Add a new device manually** and follow these steps:

1. Find a printer by other options

   - Select **Add a printer using an IP address or hostname**.
   - Click **Next**.
   
2. Type a printer hostname or IP address

   - Select **IPP Device** as **Device type**. 
   - At **Hostname or IP address**, enter the URL of a SavaPage
     :ref:`IPP Queue <ch-webapp-admin-queue-edit>`. For example: 
     
     - ``https://my-savapage:8632/printers/my-queue``
     - ``http://my-savapage:8631/printers`` (default IPP ``/`` queue)
     
   - Click Next
   
3. Click **Print a test page**

   - Choose a :ref:`plain PostScript driver <ch-printer-windows-install-driver>` from the list.
   - Click **Finish**


.. _ch-printer-windows-install-local-printer:

Raw Printer
~~~~~~~~~~~

To add SavaPage as Raw Printer, start the "Add a printer or scanner"
dialog, choose **Add a new device manually** and follow these steps:

1. Find a printer by other options

   - Select **Add a printer using an IP address or hostname**
   - Click **Next**. 
   
2. Type a printer hostname or IP address

   - Devicetype : **TCP/IP Device**
   - Hostname or IP address : `my-savapage:9100``
   - Click **Next**
   
3. Detecting TCP/IP port ... (may take a while) 

4. Additional port information required

   - Device Type : **Custom**
   - Click **Settings . . .**
   
5. Configure Standard TCP/IP port Monitor

   - Protocol: **Raw**
   - Port Number: 9100 (or the alternative port as configured in
     :ref:`server.properties <ch-install-on-linux-advanced-config-alt-tcpip-interface-ports>`).
   - Click **OK** and **Next** 
   
6. Install the printer driver

   - Choose a :ref:`plain PostScript driver <ch-printer-windows-install-driver>`
     from the list.
   - Click **Next**
   
7. Which version of the driver do you want to use

   - Use the driver that is currently installed
   - Click **Next** 
   
8. Type a printer name

   - For instance “SavaPage” (it is possible to rename the printer after it is
     installed).
   - Click **Next**
   
9. Printer Sharing
 
   - If you want to share this printer, you must provide a share name.
   - Click **Next**
    
10. Print a test page to check if everything works as expected.

    - Print jobs are send to the :ref:`Reserved Queue <ch-webapp-admin-queues-reserved>`
      named ``/raw`` .
    - Click **Finish**


.. /*  
    * Images
    */

.. |image75| image:: ../images/manual/ipp-everywhere-275x320.png
   :width: 80px
   :target: #ch-printer-ipp-everywhere
.. |image76| image:: ../images/manual/windows-10-logo-128x128.png
   :width: 70px
   :target: #preface-conventions-feature-preview