.. index:: API Docs
.. api_docs:

API Documentation
=================

This chapter contains API documentation specific to the Librem 5 as well as
links to upstream documentation.

API documentation for the underlying GNOME platform can be found in
:ref:`gnome_resources`. This list is currently being `filled in
<https://source.puri.sm/Librem5/developer.puri.sm/issues/60>`_.

See also the :ref:`software_reference` for detailed information about the
Librem 5 software stack.

Phone/Messaging APIs
--------------------
* Modem/Sim card access is provided via the `ModemManager`_  DBBus APIs
* Access to network connections is provided via `NetworkManager`_ DBus APIs

Shell APIs
----------
DBus APIs provided by the Phone Shell (:ref:`phosh`):

* `org.gnome.Mutter.DisplayConfig`_ provides display information and
  configuration:

  * Retrieve information about conntected displays,
  * Set gamma curve (used for e.g. nightlight)
  * Set primary monitor
  * Backlight brightness
  * Lacks `changing displays <https://source.puri.sm/Librem5/phosh/issues/57>`_

  Mostly used by gnome-settings-daemon.

* `org.gnome.Mutter.IdleMonitor`_ to detect if the session is idle
  (for e.g. screen lock or power saving). Used by e.g. gnome-session
  for idle detection.

* `org.gnome.keyring.SystemPrompter`_ provides System modal
  authentication dialogs (used by e.g. gnupg's pinentry, SIM card pin
  entry, etc.)


Mobile Widgets
--------------
* `libhandy reference manual <https://honk.sigxcpu.org/projects/libhandy/doc/>`_

.. _`org.gnome.Mutter.DisplayConfig`: https://source.puri.sm/Librem5/phosh/blob/master/src/monitor/org.gnome.Mutter.DisplayConfig.xml
.. _`org.gnome.Mutter.IdleMonitor`: https://source.puri.sm/Librem5/phosh/blob/master/src/dbus/org.gnome.Mutter.IdleMonitor.xml
.. _`org.gnome.keyring.SystemPrompter`: https://gitlab.gnome.org/GNOME/gcr/blob/master/gcr/org.gnome.keyring.Prompter.xml
.. _`ModemManager`: https://www.freedesktop.org/software/ModemManager/api/latest/ref-dbus.html
.. _`NetworkManager`: https://developer.gnome.org/NetworkManager/stable/spec.html