---
name: "configlets-druid"
section: "1"
platform: "linux"
package: "configlet-frontends"
version: "1.8"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/configlets-druid"
---

# configlets-druid(1)

GNOME front end to run configlets in a wizard-like manner.

%progeny-entity;  \]\>

## NAME

configlets-druid — **GNOME** front end to run configlets in a wizard-like  manner.

## SYNOPSIS

**configlets-druid** \[--ask-only  \| --commit-only \]  \[*configlet\_dir*\]

## DESCRIPTION

**configlets-druid** is a **GNOME** front end to  installed configlets.  It provides a druid interface to them,  where each appears in a window with a Back and Next button to  choose between them.

After the initial welcoming screen, the druid shows a list of  the configlets that will be displayed, along with short  descriptions of each.  Next to each configlet's name is a check  box that is checked by default (but see below for information on  configuring this); the user may check or uncheck any of the  configlets shown.  The next screen after this is the first  configlet in the list that was checked; the rest of the screens  consist of the rest of the checked configlets, followed by a  wrap-up screen.  If the user uses Back to return to the list and  selects a different set of configlets, the newly checked list  will be displayed when the user clicks Next to proceed.

See  **/usr/share/doc/python-configlets/book/book.html**       or **http://hackers.progeny.com/configlets/** for  more information.

## OPTIONS

- **--ask-only**

  Run the druid, but do not commit any changes to **debconf** until  later, when run with **--commit-only**. Intended  for use by **apt**-like tools.

- **--commit-only**

  Save earlier recorded values to **debconf**.

- *configlet\_dir*

  Location for installed configlets. Defaults to  **/usr/share/configlets/**.

## CONFIGURATION

**configlets-druid** can use a configuration file,  located at **/etc/configlets-druid.cfg**.  This  file can contain blank lines and comment lines that start with a  line, with whitespace separating the item and value.  (The value  can contain whitespace.)  For some items, no value is necessary;  in those cases, it can be omitted.

The following configuration items are recognized:

- **cancelable**

  Turn on the Cancel button on the druid.  The default is to  turn the Cancel button off.

- **debug**

  Cause the druid and the configlets to print large amounts of  debugging information to standard error.

- **dont\_show\_required\_configlets**

  If a configlet is listed as required (see the  **required\_configlets** item below), then it is  displayed with "(mandatory)" added to its description, and  its checkbox cannot be unchecked.  If this item is  specified, then required configlets will not be shown in the  first screen at all.

- **gtkrc**

  Provides a path to a custom gtkrc for the druid.  By  default, the gtkrc from the Raleigh theme is used if  available, or no gtkrc if it is not.

- **logo**

  Provides the path to the logo to load into the druid's logo  space.  If not specified, this defaults to a Debian logo.

- **omit\_configlets**

  Configlets whose names appear in this space-separated list  are omitted from the druid entirely and are not shown.

- **required\_configlets**

  Configlets whose names appear in this space-separated list  are considered "required".  This means that they are  displayed with "(mandatory)" added to their descriptions,  and their check boxes are checked and set insensitive (so  that the user cannot uncheck the box).

- **show\_only\_listed\_configlets**

  By default, the druid loads and shows all of the configlets  it finds, subject to exceptions.  If this item is given,  only configlets explicitly mentioned in the configuration  file are loaded and shown.

- **standard\_configlets**

  This item is ignored unless  **show\_only\_listed\_configlets** is also given.  In that case, it consists of a space-separated list of  configlets that are to be shown in the normal way.

- **unchecked\_configlets**

  Configlets whose names appear in this space-separated list  are displayed with their check boxes unchecked by default.

## FILES

- **/usr/share/configlets**

  The location from which all configlets are loaded.

- **/etc/configlets-druid.cfg**

  The configuration file.

## AUTHORS

Jeff Licquia \<jlicquia@progeny.com\>

Eric Gillespie, Jr. \<epg@progeny.com\>