libfolks is a library that aggregates people from multiple sources (eg, Telepathy connection managers) to create metacontacts.

You can build, test and install libfolks using Meson:

meson setup build
meson compile -C build
meson test -C build
meson install -C build

Various backends can be enabled or disabled at compile-time. A comprehensive list of compile-time options can be found at meson_options.txt

You can browse the code, issues and more at libfolks' GitLab repository.

If you find a bug in libfolks, please file an issue on the issue tracker. Please try to add reproducible steps and the relevant version of libfolks.

If you want to contribute functionality or bug fixes, please open a Merge Request (MR). For more info on how to do this, see GitLab's help pages on MR's. Please also follow our coding conventions, as described in CONTRIBUTING.md

If libfolks is not translated in your language or you believe that the current translation has errors, you can join one of the various translation teams in GNOME. Translators do not commit directly to Git, but are advised to use our separate translation infrastructure instead. More info can be found at the translation project wiki page.

libfolks has its own web page on https://wiki.gnome.org/Projects/Folks.

The latest version of the documentation is also published online by our CI to the GitLab Pages of our repository. You can find the documentation for both the Vala API as well as the C API.

To discuss issues with developers and other users, you can post to the GNOME discourse instance or join #contacts on irc.gnome.org.

libfolks is released under the LGPL, version 2.1. See COPYING for more info.