tori.conf

The tori.conf file is found at the root of the configuration directory, which defaults to ~/.config/tori.

Each line must use the following format:

tori_root = ~/.local/share/tori
file_strategy = tree

The values in the example above are the default ones, meaning if you do not specify these options they are what will be considered their values.

Options

The following configuration options can be used to specify how you want tori to behave.

Application behavior

  • tori_root: The directory where you installed tori. This is useful when you installed tori by simply cloning its repository. It should point to the directory where the README.md and the tori files are.
    • ~/.local/share/tori (default)
    • <path>: Any valid filesystem path. See Syntax for possible home directory substitutions.

File management

  • file_strategy: What file structure should be used when merging the files from your ~/.config/tori/base directories. For a more detailed explanation of what each strategy does, see the configuration page.
    • tree (default): mirror the structure of the filesystem, with base being the equivalent of its root (/)

Syntax

Configuration options are case insensitive. The spaces around the = character are optional. Blank lines and lines beginning with a # are ignored.

You can use ~ and $HOME to represent your home directory. $HOME will be replaced in every occasion with your home directory, while ~ will only be replaced for the first occurrence in the configuration value.

Values containing spaces must be wrapped in double quotes.

Configuration values must not contain the character *.