mirror of
https://github.com/LibreSplit/LibreSplit.git
synced 2026-04-28 06:40:23 +00:00
55 lines
3.8 KiB
Markdown
55 lines
3.8 KiB
Markdown
# 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](https://docs.gtk.org/gtk4/func.accelerator_parse.html).
|
|
|
|
See the [complete list of keynames](https://github.com/GNOME/gtk/blob/main/gdk/keynames.txt) 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".
|