# Configuration

Joshuto reads configurations from the following directories using environment variables (in order of precedence):

- `$JOSHUTO_CONFIG_HOME`
- `$XDG_CONFIG_HOME/joshuto`
- `$HOME/.config/joshuto`

Joshuto can currently be configured using the following files:

- [joshuto.toml](/docs/configuration/joshuto.toml.md): basic/general configurations
- [keymap.toml](/docs/configuration/keymap.toml.md): keymapping configurations
- [mimetype.toml](/docs/configuration/mimetype.toml.md): mimetype configurations
- [theme.toml](/docs/configuration/theme.toml.md): theming configurations
- [icons.toml](/docs/configuration/icons.toml.md): icons customization

**Please copy these configs and use it as a base, then modify them accordingly.**

Joshuto's behavior is:

- If there exists a config file, use that config. (No default or inherited values from a default config)
- If there is no config file, a default config will be used (found under `config/`)

This means Joshuto will have no themes or no mimetype entries if you have an empty `theme.toml` or `mimetype.toml` file