LibreSplit/docs/settings-keybinds.md

Settings and keybinds

LibreSplit uses JSON as its way to keep track of your preferences.

The settings file

Settings are saved in the settings.json file inside your XDG_CONFIG_HOME folder (it will usually be situated in ~/.config/libresplit/settings.json).

The settings file is divided in 3 main parts:

• libresplit: Which contains the general settings;
• keybinds: Which contains your key bindings;
• history: Which tracks the last splits, auto splitters, split folder and auto splitters folder you opened.

General settings

Under the libresplit section, you will find the following settings:

Setting	Type	Description	Default
start_decorated	Boolean	Start with window decorations	false
start_on_top	Boolean	Start with window as always on top	true
hide_cursor	Boolean	Hide cursor in window	false
global_hotkeys	Boolean	Enables global hotkeys	false
start_on_top	Boolean	Start with window as always on top	false
theme	String	Default theme name	"standard"
theme_variant	String	Default theme variant	""
decimals	Integer	Number of decimals to show on the timer (from 0 to 6)	2
save_run_history	Boolean	Save JSON files with old runs in the runs subdirectory	true
ask_on_gold	Boolean	Ask for confirmation before resetting a run with gold splits	true
ask_on_worse	Boolean	Ask before saving a run that is worse than PB	true

Keybind settings

Under the keybind section, you will find the following key bindings:

Keybind	Type	Description	Default
start_split	String	Start/split keybind	space
stop_reset	String	Stop/Reset keybind	Backspace
cancel	String	Cancel keybind	Delete
unsplit	String	Unsplit keybind	Page_Up
skip_split	String	Skip split keybind	Page_Down
toggle_decorations	String	Toggle window decorations keybind	Control_R
toggle_win_on_top	String	Toggle window "Always on top" state keybind	<Control>k

Keybind strings must be parsable by the gtk_accelerator_parse.

See the complete list of keynames for gdk. Modifiers are enclosed in angular brackets <>: <Shift>, <Ctrl>, <Alt>, <Meta>, <Super>, <Hyper>. Note that you should use <Alt>a instead of <Alt>-a or similar.

Modifying the default values

You can edit the settings by directly changing the settings.json file inside of LibreSplit's configuration directory.

Alternatively, you can use the settings Dialog by right clicking the LibreSplit window, and clicking on "Settings".