.. /*  
    * 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-android:

Printing from Android
---------------------

.. list-table:: Printing from Android
   :width: 100%
   :widths: 12 88
   
   * - |image69|
     - If :ref:`SavaPage IPP Everywhere <ch-printer-ipp-everywhere>`
       is configured in a Local Network, the corresponding printer
       is automatically detected and can directly be used without
       any configuration. |br| 
       |br|

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

   * - |image70|

     - :ref:`SavaPage Android Print App <ch-printer-android-savapage-print-app>`
       is a native Android printing service. Users can copy the URL and their
       credentials from the :ref:`Internet 
       Printer <ch-webapp-user-main-user-details-internet-printer>` dialog.
       The app makes use of :ref:`RESTful User Services <app-restful-user>`.
       

.. _ch-printer-android-savapage-print-app:

SavaPage Android Print App
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|image71| |image72|

.. admonition:: |ADMONITION_TITLE_PREVIEW|

   `SavaPage Android Print
   App <https://f-droid.org/packages/org.savapage.android.print/>`__ is
   a :ref:`Feature Preview <preface-conventions-feature-preview>` that is
   fully operational but impermanent. The preview is offered to provoke
   feedback based on real world use. Please tell us your requirements.

Users can copy the URL and their credentials from the :ref:`Internet
Printer <ch-webapp-user-main-user-details-internet-printer>` dialog.

The app makes use of :ref:`RESTful User Services <app-restful-user>`.

To illustrate the App, composite Android screen-shots below show three
SavaPage Printers. A tap on a printer entry shows the details for
editing.

.. figure:: ../images/manual/screenshots/user/sp-android-print-printer-list.png
   :alt: SavaPage Android Print App - Printer List
   :width: 300

   SavaPage Android Print App - Printer List


Printers were added by selecting |RST_BUTTON_ADD_PRINTER| from the top-right
menu or by pressing the bottom-right |RST_BUTTON_PLUS_SYMBOL| button. Global
Settings were used to trust a self-signed SSL certificate of any SavaPage
Printer URL.

.. figure:: ../images/manual/screenshots/user/sp-android-print-menu.png
   :alt: SavaPage Android Print App - Menu
   :width: 300

   SavaPage Android Print App - Menu

.. important::

   After the SavaPage App is enabled in the “Print services” section
   of the Settings App, Android Apps that offer Print Services will see
   the SavaPage printers as target.
   
.. figure:: ../images/manual/screenshots/user/sp-android-print-share.png
   :alt: SavaPage Android Print Service
   :width: 300

   SavaPage Android Print Service
   
.. /*  
    * Images
    */

.. |image69| image:: ../images/manual/ipp-everywhere-275x320.png
   :width: 80px
   :target: #ch-printer-ipp-everywhere
.. |image70| image:: ../images/manual/android-apk-192x192.png
   :width: 70px
   :target: #ch-printer-android-savapage-print-app
.. |image71| image:: ../images/manual/savapage-feature-preview-75x100.png
   :width: 50px
   :target: #preface-conventions-feature-preview
.. |image72| image:: ../images/manual/get-it-on-f-droid-shield.png
   :width: 250px
   :target: https://f-droid.org/packages/org.savapage.android.print/