Introduction to libsecret

The libsecret package contains a GObject based library for accessing the Secret Service API.



Development versions of BLFS may not build or run some packages properly if dependencies have been updated since the most recent stable versions of the book.

Package Information

libsecret Dependencies





Gi-DocGen-2023.1 and docbook-xml-4.5, docbook-xsl-nons-1.79.2, libxslt-1.1.37 (to build manual pages), and Valgrind-3.20.0 (can be used in tests)

Optional (Required for the test suite)

D-Bus Python-1.3.2, Gjs-1.74.1, PyGObject-3.42.2 (Python 3 module), and tpm2-tss

Runtime Dependency




Any package requiring libsecret expects GNOME Keyring to be present at runtime.

User Notes:

Installation of libsecret

Install libsecret by running the following commands:

mkdir bld &&
cd bld &&

meson --prefix=/usr --buildtype=release -Dgtk_doc=false .. &&

Now, as the root user:

ninja install

To test the results, issue: dbus-run-session ninja test.

If gi-docgen is installed and the -Dgtk_doc=false has been removed, as the root user, issue the following command to fix the name of the installed documentation directory:

mv -v /usr/share/doc/libsecret-{1,0.20.5}

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-Dgtk_doc=false: Remove this if you have Gi-DocGen-2023.1 installed and want to rebuild the documentation with it.

-Dmanpage=false: Use this switch if you have not installed libxslt-1.1.37 and DocBook packages.

-Dgcrypt=false: Use this switch if you have not installed the recommended dependency of libgcrypt-1.10.1.


Installed Program: secret-tool
Installed Library:
Installed Directories: /usr/include/libsecret-1 and /usr/share/doc/libsecret-0.20.5

Short Descriptions


is a command line tool that can be used to store and retrieve passwords

contains the libsecret API functions