mirror of https://github.com/helix-editor/helix
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
36 lines
1.1 KiB
Markdown
36 lines
1.1 KiB
Markdown
# Configuration
|
|
|
|
To override global configuration parameters, create a `config.toml` file located in your config directory:
|
|
|
|
- Linux and Mac: `~/.config/helix/config.toml`
|
|
- Windows: `%AppData%\helix\config.toml`
|
|
|
|
> 💡 You can easily open the config file by typing `:config-open` within Helix normal mode.
|
|
|
|
Example config:
|
|
|
|
```toml
|
|
theme = "onedark"
|
|
|
|
[editor]
|
|
line-number = "relative"
|
|
mouse = false
|
|
|
|
[editor.cursor-shape]
|
|
insert = "bar"
|
|
normal = "block"
|
|
select = "underline"
|
|
|
|
[editor.file-picker]
|
|
hidden = false
|
|
```
|
|
|
|
You can use a custom configuration file by specifying it with the `-c` or
|
|
`--config` command line argument, for example `hx -c path/to/custom-config.toml`.
|
|
Additionally, you can reload the configuration file by sending the USR1
|
|
signal to the Helix process on Unix operating systems, such as by using the command `pkill -USR1 hx`.
|
|
|
|
Finally, you can have a `config.toml` local to a project by putting it under a `.helix` directory in your repository.
|
|
Its settings will be merged with the configuration directory `config.toml` and the built-in configuration.
|
|
|