> For the complete documentation index, see [llms.txt](https://benz.gitbook.io/walker/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://benz.gitbook.io/walker/customization/general-config.md). # General Config ### General You can customize how Walker behaves and interacts by adjusting it's configuration to your liking.\ \ Default path for configuration file is `~/.config/walker/config.toml`. Have a look at the default configuration for a reference: ### Options | key | type | default | description | | --------------------------- | ------- | --------- | -------------------------------------------------------------------------------------------------------------------- | | as\_window | boolean | false | launch walker as a regular window instead of layer shell application | | force\_keyboard\_focus | boolean | false | force keyboard focus to stay in walker | | close\_when\_open | boolean | true | invoking walker while it's already open will close it | | click\_to\_close | boolean | true | clicking outside of the main walker box will close it | | selection\_wrap | boolean | false | will wrap the selection | | global\_argument\_delimiter | string | `#` | used to delimit arguments, f.e. `query#arg` means `arg` will be send as an argument to Elephant | | exact\_search\_prefix | string | `'` | can be used to tell Elephant to use exact search instead of fuzzy search | | theme | string | `default` | theme to use | | disable\_mouse | boolean | false | disables mouse-interaction with Walker, **except** for drag\&drop from preview pane | | hide\_quick\_activation | boolean | false | hide the quick activation hints globally | | hide\_action\_hints | boolean | false | hide the actions keybind hints | | hide\_return\_action | boolean | false | hide actions that are bound to Return | | page\_jump\_items | number | 10 | number of items to skip with Page Up/Down | | single\_click\_activation | boolean | true | activate items with a single click | | debug | boolean | false | enables debug printing in order to print various info, f.e. available/implemented actions, currently pressed keybind | | resume\_last\_query | boolean | false | open walker with the last query in place | | actions\_as\_menu | boolean | false | show actions in a menu | | autoplay\_videos | boolean | false | auto-play video previews | | shell.layer | string | "overlay" | layershell layer | | shell.anchor\_top | boolean | false | anchor for window | | shell.anchor\_bottom | boolean | false | anchor for window | | shell.anchor\_left | boolean | false | anchor for window | | shell.anchor\_right | boolean | false | anchor for window | ### List Columns You can define how many columns the list for specific providers has without creating a new theme. F.e. ```toml [columns] "symbols" = 3 ``` ### Placeholders Placeholders for the input or empty list can be configured as such: ``` [placeholders] "default" = { input = "Search", list = "No Results" } "desktopapplications" = { input = "Start", list = "No Application" } ``` If the input placeholder is prefixed with `cmd:`, it will run the command and use the output as the placeholder. ### Providers #### Global Config | key | type | default | description | | -------------------- | ------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `default` | string list | `["desktopapplications", "calc", "runner", "menus", "websearch"]` | all providers that should be queried by default | | `empty` | string list | `["desktopapplications"]` | all providers that should be queried when query is empty | | `ignore_preview` | string list | `[]` | all providers that should not display a preview. | | `max_results` | number | `50` | global max amount of results | | `argument_delimiter` | map, key: string, value: string | \`\` | used to delimit arguments, f.e. `query#arg` means `arg` will be send as an argument to Elephant | #### Sets Walker allows you to configure "sets" that you can launch, overwriting the configuration from above. Example: ``` [providers.sets.omarchy] default = [ "menus:omarchy", "menus:omarchylearn", "menus:omarchytrigger", "menus:omarchycapture", ] empty = ["menus:omarchy"] ``` Running `walker -s omarchy` launches Walker with these specified providers. `default` sets the providers that will be queried, while `empty` defines which ones will display entries, without searching. #### Emergency Mode Walker allows you to define static "emergency entries" in case Elephant isn't connected. Example: ```toml [[emergencies]] text = "Firefox" command = "firefox-developer-edition" [[emergencies]] text = "uuctl" command = "uuctl" ``` #### Prefixes Prefixes can be used to explicitly target a provider, f.e. ``` [[providers.prefixes]] prefix = ">" provider = "runner" ``` will allow you to explicitly query the `runner` provider. #### Amount of displayed results You can adjust the amount of displayed results per provider, f.e. ``` [providers.max_results_provider] # define max results per provider in here desktopapplications = 10 ``` will show at most 10 entries for the `desktopapplications` provider. #### Provider-Specific Configuration **Clipboard** | key | type | default | description | | ------------- | ------ | ------------------ | --------------------------- | | `time_format` | string | `"%d.%m. - %H:%M"` | time format of the sub-text | ### Global Keybinds The following global keybinds can be configured: * `close` * `next` * `left` * `right` * `up` * `down` * `previous` * `toggle_exact` * `resume_last_query` * `quick_activate` You can define multiple binds per actions, such as: ``` next = ["Down", "ctrl n", "ctrl j"] ```