# libportal Reference Manual

## Portals

libportal is a library that provides GIO-style async API wrappers for the D-Bus portal APIs in xdg-desktop-portal.

Where possible, applications should prefer to use existing library APIs that have portal support. For example, a GTK+ application should use GtkFileChooserNative instead of xdp_portal_open_file().

Some portal interfaces are not covered in libportal, since they already have perfectly adequate APIs in GLib (which libportal depends on anyway).

NetworkMonitor

- Use GNetworkMonitor

ProxyResolver

- Use GProxyResolver

Settings

- Use a plain GDBusProxy

GameMode

- Not currently covered

Secrets

- Not currently covered

## Helpers

Auxiliary objects that are used in the portal API wrappers.