Configuration

By default, the configuration file is located in ~/.config/outspline/outspline.conf. A different file can be used by launching Outspline with the -c flag; see Usage for details. The file will be created with the default values the first time that Outspline is run.

See Configuration: Tips for some recommended tweaks.

Keep reading for the complete documentation.

Core options

[Log]

log_level_stdout = 1: Verbosity of stdout log messages; 0 disabled; 1 essential reports; 2 normal verbosity; 3 debug mode.

log_level_file = 0: Verbosity of file log messages; 0 disabled; 1 essential reports; 2 normal verbosity; 3 debug mode.

log_file = ~/.config/outspline/outspline.log: The path to the log file to be used.

[Save]

default_extension = osl: The Outspline file extension to be considered as default.

[History]

The history of the edits to a database is kept limited to a certain number of actions. When a new action is done, only the soft_limit most recent actions are kept, plus any exceeding actions that were done in the last time_limit minutes, but still discarding the oldest ones if the resulting number of actions to keep exceeds hard_limit. When closing a database, all the actions, except for the soft_limit most recent ones, are purged. The soft_limit is stored in the properties of each database, while time_limit and hard_limit are defined globally in the configuration file.

default_soft_limit = 60: This is the soft_limit that is saved in the properties of each database upon creation, and can be viewed and changed there.

time_limit = 15: When a new action is done, the actions done in the last number of minutes defined here will be kept, unless their total number exceeds hard_limit.

hard_limit = 120: The number of actions saved in the history of an open database will never exceed this number.

Addons

All addons are enabled by default, but you can use the enabled option to disable some; note that disabling an addon that is required by another that is left enabled will result in Outspline refusing to start and raising a dependency error.

Note that the configuration of keyboard shortcuts is treated separately in Table of keyboard shortcuts

Extensions

See Configuration: Extensions.

Interfaces

See Configuration: Interfaces.

Plugins

See Configuration: Plugins.