The xfconf package

[ Tags: 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
Author John Obbele
Category System, XFCE
Home page
Source repository head: darcs get
Uploaded Fri Apr 15 17:52:19 UTC 2011 by JohnObbele
Updated Sun Aug 21 12:59:55 UTC 2016 by HerbertValerioRiedel to revision 1
Distributions NixOS:
Executables testGlib, tests
Downloads 345 total (2 in the last 30 days)
Rating 0.0 (0 ratings) [clear 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


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).


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.