Openbox

=======

Openbox is a simple window manager that lets you configure the appearance of

windows, menus, shortcuts and autostarted programs. The `(home openbox)` module

provides configuration options for openbox.

Main Configuration

------------------

Openbox is configured by using the `openbox-home` procedure.

**Scheme Procedure**: (openbox-home config)

Generates configuration files for openbox, according to config, an

openbox-configuration object.

**Data Type**: openbox-configuration

Data type that represents the Openbox configuration. This data type has the

following fields:

* **autostart** (default #f): the content of the autostart script. It can be

  #f if no script needs to be run at startup, or a file-like object.

* **environ** (default #f): the content of the environ file. It can be #f if no

  environment variable needs to be loaded at startup, or a file-like object.

* **menus** (default '()): the list of menus that can be added to the root menu.

* **root-elements** (default '()): the list of menu elements that are to be added

  to the root menu.

* **rc** (default #f): the content of the rc file. It can be #f if no specific

  configuration is needed, or a file-like object.

Example Configuration

---------------------

```scheme

(openbox-home

  (openbox-configuration

    (autostart (local-file "files/autostart"))

    (menus

      (list

        (openbox-menu

          (id "apps-game-menu")

          (label "Games")

          (elements

            (list

              (openbox-element-execute

                (label "MineTest")

                (command (file-append minetest "/bin/minetest")))

              (openbox-element-execute

                (label "harmonist")

                (command (file-append harmonist "/bin/harmonist")))

              (openbox-element-execute

                (label "Xonotic")

                (command (file-append xonotic "/bin/xonotic"))))))))

          (root-elements

            (list

              (openbox-element-menu (id "apps-game-menu"))

              (openbox-element-execute

                (label "Terminal")

                (command (file-append xfce4-terminal "/bin/xfce4-terminal")))

              (openbox-element-execute

                (label "Icecat")

                (command (file-append icecat "/bin/icecat -P --no-remote")))

              (openbox-element-execute

                (label "File Manager")

                (command (file-append pcmanfm "/bin/pcmanfm")))))

          (rc (local-files "files/openbox-rc"))))

```

Menu Configuration

------------------

Menus in Openbox can be configured with the following data types:

**Data Type**: openbox-menu

This data type represents the content of a menu. This data type has the following

fields:

* **id**: a unique identifier used to link to that menu in the parent menu

* **label**: a label shown in the parent menu that opens this menu

* *elements**: the elements of the menu

**Data Type**: openbox-element-menu

This data type represents a menu, as an element of another menu. This data type

has the following fields:

* **id**: the id of the menu that is opened by this element

**Data Type**: openbox-element-execute

This data type represents a menu element that is something to execute when the

user clicks on it. This data type has the following fields:

* **label**: a label shown in the parent menu that executes this element

* **command**: the command to execute when the user clicks on this menu element.

  It can be a string or a g-expression, as seen in the first example.

* **notify?** (default #t): whether to use startupnotify