---
name: "splashy-config.xml"
section: "5"
platform: "linux"
package: "splashy"
version: "0.3.13-3+lenny1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/splashy-config.xml"
---

# splashy-config.xml(5)

a user-mode, POSIX and LSB compliant, boot splashing system for UNIX.

## NAME

**Splashy** - a user-mode, POSIX and LSB compliant, boot splashing system for UNIX.

## SYNOPSIS

**/etc/splashy/config.xml** - Splashy's configuration file

## DESCRIPTION

**/etc/splashy/config.xml** sets splashy's behaviour during boot, shutdown inter-runlevel and error. It is an XML file where all values are enclosed in tags

A tag is anything enclosed between **\<** and **\>**. An opening tag has the form `"<tag>"` while a closing tag has its name preceded with a backslash (**\\**) character as in `"<\tag>"`

Tags can be considered as folders. Each tag either contains tags or contains a value

The value of the final tag affects in the field defined by its parents tags

The following tag folders are supported:

- *\<splashy\>*

  This tag is mandatory. It contains all splashy's configuration values, listed below.

  The following values are supported:

- *\<themes\>*

  Absolute path to the directory containing the installed splashy themes. Default: /etc/splashy/themes

- *\<current\_theme\>*

  Name of the theme to use. It must be the name of a directory in \<themes\>'s value's directory. Default: default

- *\<default\_theme\>*

  Full path to a theme to fall back to if the theme specified in \<current\_theme\>'s value can't be found. Default: /etc/splashy/themes/default

- *\<pid\>*

  Full path to the PID file splashy will use to store its PID so that other processes can know if it is running. Default: /var/run/splashy.pid

Comments can be introduced by enclsing them between **\<!--** and **--\>**. Blank lines are also ignored

## EXAMPLES

The following is a complete and valid splashy configuration file:

```
 <splashy>
    <!-- themes directory: conventional path /etc/splashy/themes -->
    <themes>/etc/splashy/themes</themes>
    <!-- current theme could be relative the themes defined above or full path -->
    <current_theme>default</current_theme>
    <!-- full path to theme to fall back in case of problems. DO NOT CHANGE -->
    <default_theme>/etc/splashy/themes/default</default_theme>
    <!-- this defaults should be ok -->
    <pid>/var/run/splashy.pid</pid>
 </splashy>
```

## NOTES

Values are refered by their tag name prefixed with all of its parent tag's names. For example: `"/splashy/pid"`

## FILES

- */etc/splashy/config.xml*

  Main configuration. Defines how splashy should be setup

- */etc/splashy/themes/*

  Location where splashy themes are stored

## SEE ALSO

[**splashy**(1)](/splashy/1.md), [**splashy\_config**(1)](/splashy_config/1.md), [**splashy\_config**(1)](/splashy_config/1.md), [**splashy-theme.xml**(5)](/splashy-theme.xml/5.md)

## AUTHORS

Jacobo Vilella \<jacobo221@gmail.com\>