xfconf: FFI bindings to xfconf

[ gpl, library, system, xfce ] [ Propose Tags ]

Xfconf is a simple client-server configuration storage and query system build on top of glib and used by XFCE.

[Skip to Readme]
Dependencies base (>=3.0 && <5.0), glib (>=0.12), HUnit (==1.2.*), QuickCheck (>=2.1), test-framework (==0.3.*), test-framework-hunit (==0.2.*), test-framework-quickcheck2 (==0.2.*) [details]
License GPL-3.0-only
Author John Obbele
Maintainer john.obbele@gmail.com
Revised Revision 1 made by HerbertValerioRiedel at Sun Aug 21 12:59:55 UTC 2016
Category System, XFCE
Home page http://patch-tag.com/r/obbele/xfconf/home
Source repo head: darcs get http://patch-tag.com/r/obbele/xfconf/home
Uploaded by JohnObbele at Fri Apr 15 17:52:19 UTC 2011
Distributions NixOS:
Executables testGlib, tests
Downloads 597 total (5 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 3 reports]
Hackage Matrix CI





Build the two test suites


Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

For package maintainers and hackage trustees

Readme for xfconf-

[back to package description]

Haskell bindings to XFCE 4.8 xfconf settings daemon.

Original xfconf API documentation can be found on:


GHC and xfconf-devel/libxfconf obviously :)

You will need a fairly new version of haddock too (>= 2.8).

Cabal should take care of the rest.


Presently, the whole thing is (almost) no more hackish. The system was
integrated with cabal, a set of QuickCheck tests prove the storing and
retrieving of large data sets to work properly and the XfconfChannel*
objects inherit from regular gtk2hs-glib.GObjects.

Only Tests/TestGlib.hs appears broken.


An application of this library can be found with hThemes[0], a small
utility to quickly save and load pre-configured xfconf settings (notably
wallpapers, gtk+2 & xfwm4 themes).

[0]: https://patch-tag.com/r/obbele/hThemes/home

How to build

Just try this:

	bash $ make            # shortcut for cabal configure -f buildTests
	                       #          and cabal build

How to use the Tests/*.hs binaries

Those tests require a working version of XFCE >= 4.8, as well as the
haskell packages test-framework, test-framework-hunit, HUnit,
test-framework-quickcheck2 and QuickCheck. The demo program requires the
haskell binding for gtk. You can ask cabal to build it for you by
specifying the flag "buildTests":

	bash $ cabal configure -fbuildTests
	bash $ cabal build
	bash $ ./dist/build/tests/tests
	bash $ ./dist/build/testGlib/testGlib
	bash $ runghc Demo/Demo.hs

Or you can just quickly run them with one of the following shortcuts:
	bash $ make test(s)         # run with 500 test samples
	bash $ make testGlib        # test glib signals
	                            # (need a -threaded binary)
	bash $ make demo            # run the small xfconf bindings demo

You're welcomed to report any suggestions / bug reports to john obbele
AT gmail.

© Copyright 2010-2011 John Obbele. All Rights Reserved.