README

March 13, 2025 ยท View on GitHub

libsoup is an HTTP client/server library for GNOME. It uses GObjects and the glib main loop, to integrate well with GNOME applications.

Features:

  • Both asynchronous (GMainLoop and callback-based) and synchronous APIs
  • Automatically caches connections
  • SSL support
  • Proxy support, including authentication and SSL tunneling
  • Client support for Digest, NTLM, and Basic authentication
  • Server support for Digest and Basic authentication

See the documentation in docs/reference/ and the test programs in tests/ for simple examples of how to use the code. The evolution-data-server and evolution-exchange modules in GNOME git have some more complicated examples.

There is a support forum for libsoup-related questions/discussions at https://discourse.gnome.org/tag/libsoup

Bugs against libsoup can be filed at: https://gitlab.gnome.org/GNOME/libsoup/issues/

More information and API documentation is available at https://libsoup.gnome.org

Licensing: libsoup is licensed under the LGPL, see COPYING for more details.