1
<page xmlns="http://projectmallard.org/1.0/"
2
type="topic" style="task"
5
<revision pkgversion="3.6" version="0.1" date="2012-05-21" status="draft"/>
6
<link type="guide" xref="index" group="user" />
7
<link type="seealso" xref="backgrounds-extra" />
9
<credit type="author copyright">
10
<name>Ryan Lortie</name>
11
<email>desrt@desrt.ca</email>
15
<credit type="author copyright">
16
<name>Jeremy Bicha</name>
17
<email>jbicha@ubuntu.com</email>
21
<credit type="author copyright">
22
<name>Jim Campbell</name>
23
<email>jwcampbell@gmail.com</email>
27
<desc>Set system-wide default values using dconf's key file directories</desc>
30
<title>Custom default values for system settings</title>
32
<p>System-wide default values can be set using dconf's <em>key file
33
directories</em>. Key files contain <em>groups</em> and <em>key-value pairs
36
<p>To demonstrate how dconf key files can be used to set default values,
37
we'll look at how to use them to set a default wallpaper.</p>
39
<comment><p>You don't have to use "local" as the profile name. You can even have
40
different profiles for different users. This isn't mentioned because this
41
functionality needs something like accountsservice integration to enforce this.
42
gnome-control-center integration would be great too.</p></comment>
45
<list type="numbered">
46
<title>Set the default wallpaper</title>
47
<item><p>Create a directory named <file>/etc/dconf/profile/</file></p></item>
48
<item><p>From within the <file>profile</file> directory, create and edit a
49
file named <file>user</file>.</p>
55
<item><p>Navigate to the <file>/etc/dconf/db/local.d/</file> directory. If
56
this directory doesn't exist, you will need to create it.</p>
58
<item><p>In the <file>local.d</file> directory, create and edit a
59
key file named <file>00_default-wallpaper</file>.</p>
61
#this portion of the key file identifies the dconf group
62
[org/gnome/desktop/background]
63
#these are the individual key-value pairs that are relevant to the key file group
64
picture-uri='file:///usr/local/share/backgrounds/company-wallpaper.jpg'
65
picture-options='scaled'
66
primary-color='000000'
67
secondary-color='000000'
71
<p>Update the system databases</p>
72
<screen> <output style="prompt"># </output> <input>dconf update</input> </screen>
78
<p>The first time you create a dconf user profile, you'll need to log out
79
and log in to apply the new profile.</p>
85
You can include multiple sets of groups and key-value pairs in each key file,
86
or you can use a separate key file for each group.