Share configs

[Omnikar]

From #1335 (comment).

Post anything that you want to share from your config.toml!

[Omnikar]

Some things I have to share:

I personally flip selections much more than I collapse them, so I have ; and A-; swapped:

[keys.normal]
";" = "flip_selections"
"A-;" = "collapse_selection"

As I mentioned in #1335 (comment), I bind ge to goto_file_end in select mode, while keeping the default binding to goto_last_line in normal mode:

[keys.select]
"g" = { "e" = "goto_file_end" }

I use hover much more than I use keep_selections, so I have them rebound:

[keys.normal]
"K" = "hover"
"A-k" = "keep_selections"

[yashsf08]

cool

[python128]

This is my config so far:

theme = "bogster"

[lsp]
display-messages = true

[editor]
true-color = true

[keys.normal]
# For Kakoune like config
S-left = "extend_char_left"
S-right = "extend_char_right"
S-up = "extend_line_up"
S-down = "extend_line_down"

"#" = "toggle_comments"
C-c = "no_op"
q = { q = "wclose" }
"space" = { "space" = "keep_primary_selection",  "q" = ":buffer-close" }
"esc" = [ "normal_mode", ":format" , ":write" ] # For quick saving

A-o = "add_newline_below"
A-O = [ "open_above", "normal_mode" ] # Doesn't work.

# Windows-like movement
C-left = [ "move_prev_word_start", "move_char_left", "move_char_right" ]
C-right = [ "move_next_word_start", "move_char_left", "move_char_right" ]

"ret" = ":write"
"C-q" = ":quit!"

[keys.insert]
C-backspace = "delete_word_backward"

# Windows-like movement (again)
C-left = [ "move_prev_word_start", "move_char_left", "move_char_right" ]
C-right = [ "move_next_word_start", "move_char_left", "move_char_right" ]

C-backspace doesn't actually work(due to some crossterm issue.

[CptPotato]

I found switching x and X convinient (see #835)

[keys.normal]
x = "extend_to_line_bounds"
X = "extend_line"

[keys.select]
x = "extend_to_line_bounds"
X = "extend_line"

edit: Also, setting different cursors for different modes helped me a lot:

[editor.cursor-shape]
normal = "block"
insert = "bar"
select = "underline"

[CptPotato]

While typing, hitting Esc to perform a single action can be a bit cumbersome in some cases.
I added a number of frequent NORMAL mode binds as Alt+... combos in INSERT mode, which I find pretty straight forward and convenient to use:

[keys.insert]
A-h = "move_char_left"
A-j = "move_line_down"
A-k = "move_line_up"
A-l = "move_char_right"
A-o = "open_below"
A-O = "open_above"
# I might add more as I need them

[juniway]

Why Alt key mapping doesn't work in macOS???

[CptPotato]

This might be a better fit for a new issue.
Do you have additional information about your config and what exactly doesn't work?

[juniway]

I tried to bind <Alt><Enter> to an operation in insert mode, e.g. A-CR = Esc-o, or anything like "A-CR" = "normal_mode", basically, I wonder how can I make <Alt><Enter> to work.

[sudormrfbin]

It's A-ret as mentioned in https://docs.helix-editor.com/remapping.html.

[juniway]

I tried this, but it didn't work

[keys.insert]
A-ret = 'normal_mode'

Well, my computer is macOS and I am using iTerm2, I found that only when the option key is set as ESC+, A-ret will work, if the option key is set as Normal, A-ret won't work.

[Gryzor]

If you use Alacritty, then in the window: section, add:

window: 
   option_as_alt: OnlyLeft

(for e.g.)

This in ~/.config/alacritty/alacritty.yml

[getreu]

Mine so far (20230609):

theme = "autumn"

[editor]
auto-save = true
soft-wrap.enable = true
middle-click-paste = false
rulers = [80, 100]

[editor.lsp]
display-messages = true
display-inlay-hints = true

[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"

[editor.statusline]
left = ["mode", "spinner"]
center = ["file-name"]
right = ["diagnostics", "version-control", "selections", "position", "file-encoding", "file-line-ending", "file-type"]

[keys.insert]
j = { k = "normal_mode" } # Maps `jk` to exit insert mode.
C-h = "delete_char_backward" # Most terminals do this by default.
C-l = "move_char_right" # Useful to jump over closing parenthesises.

[keys.normal]
Z = { Z = ":wq" } # Shortcut to save and close buffer.
C-s = ["save_selection", ":w"] # Add `:w` to the default binding.

[koalazub]

I’m looking to add some maps for my Ubuntu config and I’m not sure if I’m doing something silly in my config, but I’m getting the following error when implementing the following config:

theme = "solarized_light"
[lsp]
display-messages = true
[editor]
line-number = "absolute"
mouse = true
middle-click-paste = true
true-color = true

[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"

[keys.normal]
"[0A" = "up"

│[keys.select]
"[0A" = "up"

Bad config: data did not match any variant of untagged enum KeyTrie for key keys.normal at line 20 column 1 │ │Press to continue with default config

Everything here looks right to me(might be a bit messy), so not sure what I’m messing up on. The intent was to get the arrow keys working and I was reading this issue as a reference

[the-mikedavis]

Afaik, we don't currently parse control sequences so [0A won't make sense to Helix. Also, the right-hand side should be a command name (see some in the existing keymap docs, see also the key rebinding docs)

[koalazub]

Thanks for pointing that out. It's now throwing another error which I think is what you're referring to:

Bad config: unexpected character found: \u{2502} at line 17 column 1

[koalazub]

And also, if it is the case that I'm unable to pass a sequence to register something like an arrow key, would you have a suggestion on how to go about doing so?

[the-mikedavis]

What are you trying to bind to those movements? The default bindings for the arrow keys would look like so written out as toml:

[keys.normal]
left = "move_char_left"
right = "move_char_right"
up = "move_line_up"
down = "move_line_down"

So you should be able to bind keys to those commands. I don't think there's a workaround for control sequences unless you can find a character that represents the same code as in the linked issue. I'm even surprised that remapping like that works.

[koalazub]

I've tried the suggestion you've got in your latest response, but that doesn't work. I'm trying to register a symbol that represents the character that's being hit. In this case I'm seeing that the symbol [0A is being displayed when I hit the up arrow.

I can imagine that I'm an edge case considering that I'm tapping into a terminal using SSH via an iPad that uses a Bluetooth keyboard. But this is the current issue that I'm running into. That none of the arrow keys function in Helix even with the suggestion you've made along with what I've attempted.

Just to note, the arrow keys are functional in other editors i.e. nvim as well as in the terminal itself even when using SSH

[valpackett]

So far, this:

theme = "base16_term_mod"

[editor]
line-number = "relative"
cursor-shape = { insert = "bar" }
whitespace.render = "all"
whitespace.characters = { space = " ", tab = "▏", newline = "¬" }

# Keymap for the Colemak layout and Kakoune habits (who needs a select mode)
[keys.normal]
j = "move_line_up"
k = "move_line_down"
H = "extend_char_left"
J = "extend_line_up"
K = "extend_line_down"
L = "extend_char_right"
D = "remove_primary_selection" # like in kakoune, non-obvious name for 'opposite of C'
W = "extend_next_word_start"
B = "extend_prev_word_start"
T = "extend_till_char"
F = "extend_next_char"
"A-t" = "till_prev_char"
"A-f" = "find_prev_char"
"A-T" = "extend_till_prev_char"
"A-F" = "extend_prev_char"
"C-j" = "join_selections" # instead of J
"#" = "toggle_comments"
"$" = "extend_to_line_end"
"^" = "extend_to_line_start"
"{" = "move_prev_paragraph"
"}" = "move_next_paragraph"
"left" = "goto_previous_buffer"
"right" = "goto_next_buffer"
"space" = { "q" = ":bc" }

[keys.select]
j = "extend_line_up"
k = "extend_line_down"
# "{" = "extend_prev_paragraph" # doesn't exist yet
# "}" = "extend_next_paragraph"

[Yevgnen]

How can you bind "{" = "move_prev_paragraph"? I got this error: Bad config: data did not match any variant of untagged enum KeyTrie for key keys.normal at line 37 column 1.

[Omnikar]

For the paragraph movement commands, move has been changed to goto. See https://docs.helix-editor.com/keymap.html#unimpaired

[Yevgnen]

@Omnikar Thanks!

[BonfireAtNight]

I like to keep what I'm used to, so:

theme = "onedark"

[editor]
idle-timeout = 0 # Auto-completion options should appear instantly
completion-trigger-len = 1 # 0 would block tabs
true-color = true
middle-click-paste = true

[keys.normal]
"#" = "toggle_comments"
C-c = "no_op" # turn off the default comment functionality
G = "goto_last_line"
C-o = ":open ~/.config/helix/config.toml"
d = { d = ["extend_line","delete_selection"] }
V = "extend_line"

[keys.insert]
C-backspace = "delete_word_backward" # Doesn't seem to work?

# Distinguish between modes visually
[editor.cursor-shape]
normal = "block"
insert = "bar"
select = "underline"

[editor.lsp]
display-messages = true

[Ordoviz]

My config for the recent 22.08 release:

theme = "autumn"

[editor]
idle-timeout = 30 # milliseconds
line-number = "relative"
scrolloff = 999  # center cursor
color-modes = true
auto-format = false
auto-pairs = false
rulers = [80]

[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"

[editor.whitespace]
[editor.whitespace.render]
nbsp = "all"
tab = "all"

[editor.whitespace.characters]
nbsp = "⍽"
tab = "▏"

[editor.statusline]
left = ["mode", "spinner", "diagnostics"]
center = ["file-name"]
right = ["selections", "position", "file-encoding", "file-type"]

[keys.normal.space]
# Copy entire buffer into clipboard:
"space" = ["save_selection", "select_all", "yank_main_selection_to_clipboard", "jump_backward"]

[keys.normal]
# For Kakoune users:
H = "extend_char_left"
J = "extend_line_down"
K = "extend_line_up"
L = "extend_char_right"
W = "extend_next_word_start"
B = "extend_prev_word_start"
E = "extend_next_word_end"
A-j = "join_selections"
A-k = "keep_selections"
M = ["select_mode", "match_brackets", "normal_mode" ]
"#" = "toggle_comments"
A-h = "extend_to_line_start"
A-l = "extend_to_line_end"

[lost22git]

theme = "nord"

[editor]
color-modes = false
cursorline = true
line-number = "relative"
mouse = true
middle-click-paste = true
bufferline = "multiple"
auto-completion = true
auto-format = true
auto-save = false
shell = [
  "pwsh.exe",
  "-NoLogo",
  "-NoProfile",
  "-NoProfileLoadTime",
  "-Command",
  "$PSStyle.OutputRendering='PlainText';",
]


[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "block"


[editor.indent-guides]
render = true
character = "|"
skip-levels = 1

[editor.statusline]
left = ["mode", "spinner", "diagnostics"]
center = ["file-name"]
right = [
  "selections",
  "position",
  "file-encoding",
  "file-line-ending",
  "file-type",
]
separator = "│"


[editor.terminal]
command = "wtp"
args = ["new-tab", "--title", "DEBUG", "pwsh", "-NoLogo", "-C"]


[editor.lsp]
display-messages = false      
auto-signature-help = true
display-signature-help-docs = true
display-inlay-hints = true


# ----------------------------------------- Keymaps
[keys.normal]
C-s = ":w"
C-C = ":clipboard-yank"
H = "goto_line_start"
L = "goto_line_end"
J = "goto_next_paragraph"
K = "goto_prev_paragraph"
C-l = ":fmt"
ret = "increment"
backspace = "decrement"
tab = ":buffer-next"
S-tab = ":buffer-previous"
C-x = ":buffer-close"
A-k = [
  "extend_to_line_bounds",
  "delete_selection",
  "move_line_up",
  "paste_before",
]
A-j = ["extend_to_line_bounds", "delete_selection", "paste_after"]


[keys.insert]
j = { k = "normal_mode" }
"C-[" = "normal_mode"

[keys.select]
H = "goto_line_start"
L = "goto_line_end"
J = "goto_next_paragraph"
K = "goto_prev_paragraph"
i = { i = "normal_mode" }
u = "switch_to_lowercase"
U = "switch_to_uppercase"
C-C = ":clipboard-yank"

[lost22git]

Till now I don't know how to configure powershell lsp ;-(

[koalazub]

Ask on the matrix channel. Someone is bound to help

[koalazub]

theme = "night_owl"

[editor]
line-number = "relative"
mouse = true
middle-click-paste = true
true-color = true
bufferline = "multiple"
rulers = [120]
text-width = 120

[editor.lsp]
display-messages = true
display-inlay-hints = true

[editor.file-picker]
hidden = false

[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"

[editor.statusline]
left = ["mode", "spinner", "file-name"]
center = ["position"]
right = ["selections", "file-encoding", "version-control"]
separator = "|"
mode.normal = "N"
mode.insert = "I"
mode.select = "S"

[keys.normal]
left = "move_char_left"
right = "move_char_right"
up= "move_line_up"
down = "move_line_down"
H = ["select_mode", "goto_line_start", "normal_mode"]
L = ["select_mode", "goto_line_end", "normal_mode"]
K = "extend_next_word"

[keys.select]
left = "move_char_left"
right = "move_char_right"
up= "move_line_up"
down = "move_line_down"

[koalazub]

I want to add a line swap at some point

[00sapo]

nice H, L, and K

[00sapo]

Here is the part I'm more proud of:

[keys.select]
# just to homogenize with the command below, see comments below
"A-;" = "collapse_selection"
";" = "flip_selections"

[keys.normal]
C-s = ":update" # C-s for saving
x = ["extend_line", "select_mode"] # prefer selection with movement: hjkl
X = ["extend_line", "select_mode", "flip_selections"] # same as the above but prepare for going up
# the cursor should show where you are going to as in any text editor, let's change a and i
 i = ["collapse_selection", "insert_mode"]
a = ["collapse_selection", "append_mode"]
# same thing for D and R
D = ["collapse_selection", "delete_selection"]
R = ["collapse_selection", "replace"]
C-r = ["replace_with_yanked"] # this is mapped to R by default...
# with these changes, collapse selection is not needed so much, let's swap it with flip_selection
"A-;" = "collapse_selection"
";" = "flip_selections"

# let's selections easily
A-j = ["extend_to_line_bounds", "delete_selection", "paste_after"]
A-k = [
  "extend_to_line_bounds",
  "delete_selection",
  "move_line_up",
  "paste_before",
]

### External commands ###

# I need a snippet, but they are still not available AFAIK
# so let's input it via shortcut
A-i = [
  "open_above",
  ":insert-output echo '__import__(\"ipdb\").set_trace()'",
  "normal_mode",
  ":w",
]

# ChatGPT
A-g = ":pipe sgpt --code --temperature 0.3 --no-cache 'Using this code, apply changes as indicated in the comments starting with \"GPT:\"'"

# ChatGPT inline (copilot-like)
C-n = [
  ":insert-output echo '# FILL'",
  "join_selections",
  "extend_line_above",
  "extend_line_above",
  "extend_line_above",
  "extend_line_above",
  "extend_line_above",
  "extend_line_above",
  "extend_line_above",
  "extend_line_above",
  "extend_line_below",
  "extend_line_below",
  "extend_line_below",
  "extend_line_below",
  "extend_line_below",
  "extend_line_below",
  "extend_line_below",
  ":pipe sgpt --code --model gpt-3.5-turbo --temperature 0.3 --no-cache 'Using this code, fill the line below the comment \"# FILL\" appears. Return the whole code, including previous and next lines and tabs as in the input.'",
]


# Use neovim for find-replace globally, e.g. using vim-esearch
A-n = ":sh kitty nvim"

H = ["select_mode", "goto_line_start", "normal_mode"]
L = ["select_mode", "goto_line_end", "normal_mode"]
K = "extend_next_word_end"

[keys.normal."space"]
# I like changing colors during the day:
t = { d = ":theme tokyonight_storm", l = ":theme catppuccin_latte", s = ":theme everforest_light", b = ":theme boo_berry" }

# I like searching my .venv directory sometimes:
F = { a = ":toggle file-picker.git-ignore", F = "file_picker_in_current_directory"}

[rahil627]

as in any text editor

lol, 🔥

i've made a billion errors due to select->insert/append 😭. Now looking at it, w->i and b->a is definitely one of the problems. thaaaank youuuuuuuu!!! i can't believe i never got around changing this thing!

flip_selections is so soooo goood! i was def missing this key!!

x = ["extend_line", "select_mode"] # prefer selection with movement: hjkl

this is fantastic. it forces/teaches one to use select_mode wayyyy more often! Though the way of selection -> do something is good, i feel select_mode -> do something has been kinda neglected. it's quite a major change as x is used so often. And pressing `y/d' afterward all work seamlessly, as they automatically go back to normal mode.

[gyreas]

theme = "base16_transparent"
[editor]
auto-completion = true
bufferline = "always"
color-modes = true
rulers = [80]
cursorline = true
line-number = "relative"
true-color = true
mouse = true
soft-wrap.enable = true
soft-wrap.max-indent-retain = 900
soft-wrap.max-wrap = 80
soft-wrap.wrap-indicator = "~"

[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"

[editor.statusline]
left = ["mode", "file-name", "spinner"]
center = ["position", "separator", "total-line-numbers", "spacer", "diagnostics"]
right = ["position-percentage", "file-type", "separator", "file-line-ending", "separator", "selections", "file-encoding"]
separator = "|"
mode.insert = "INSERT"
mode.normal = "NORMAL"
mode.select = "SELECT"

[editor.whitespace.render]
#space = "all"
newline = "all"
tab = "all"

[editor.whitespace.characters]
nbsp = "⍽"
newline = "⏎"
space = "·"
tab = "→"
tabpad = "·"

[editor.indent-guides]
character = "╎" #"▏"  
render = true
skip-levels = 1

[keys.insert]
C-v = ["paste_clipboard_before"]
C-h = ["move_prev_word_start", "collapse_selection"]
C-l = ["move_next_word_start", "collapse_selection", "move_char_right"]


[keys.normal]
"$" = "goto_line_end"
"0" = "goto_line_start"
"ret" = ["open_below", "normal_mode"]
#A-i = "jump_forward"
"A-/" = ":write"
"A-8" = ":config-reload"
A-w = "wclose"
C-k = ["extend_to_line_bounds", "delete_selection", "move_line_up", "paste_before"]
C-j = ["extend_to_line_bounds", "delete_selection", "paste_after"]
C-v = ["paste_clipboard_before"]
"tab" = "command_mode"
#C-l = "rotate_view"

[SoraTenshi]

cool thread! my config is already heavily screwed, because i am using my own fork of helix.

but in general:

icons = "nerdfonts"
theme = "tokyonight_storm"

[editor]
bufferline = "always"
color-modes = true
completion-replace = true
cursor-word = true
cursorline = true
gutters = ["diagnostics", "line-numbers", "spacer", "diff"]
idle-timeout = 1
line-number = "relative"
popup-border = "all"
rainbow-brackets = true
rulers = [100]
scrolloff = 5
true-color = true

[editor.indent-guides]
rainbow-option = "normal"
render = true

[editor.lsp]
display-inlay-hints = true
display-messages = true

[editor.file-picker]
git-global = true
git-ignore = true

[editor.soft-wrap]
enable = true

[editor.statusline]
center = []
left = ["mode", "selections", "spinner", "file-name"]
mode-separator = ""
right = ["version-control", "workspace-diagnostics", "diagnostics", "file-encoding", "file-line-ending", "file-type", "position-percentage", "position", "spacer", "total-line-numbers"]
separator = ""

[editor.statusline.mode]
insert = "INSERT"
normal = "NORMAL"
select = "SELECT"

[editor.sticky-context]
enable = true
follow-cursor = true

[editor.whitespace]
render = "all"

[editor.whitespace.characters]
nbsp = "⍽"
newline = "⤶"
space = "·"
tab = "→"

[keys.normal]
C-d = ["half_page_down", "align_view_center"]
C-q = ":bc"
C-u = ["half_page_up", "align_view_center"]
X = "extend_line_above"

[keys.normal."\\"]
t = ":o ~/todo.md"

i will most likely create some sort of custom mode for all the keybinds that use Alt to any degree.
I will update this post once i got to the point doing that :)

[Aras14HD]

Just set it up to my liking:

# A dark theme with strongly different colors (even separate mut) and a visible selection
theme = "ayu_evolve"

[editor]
line-number = "relative"

# I like my cursor types easily differentiable and box fits more to select than normal
[editor.cursor-shape]
insert = "bar"
normal = "underline"
select = "block"

# Mostly standard statusline but with git brach and total lines
[editor.statusline]
left = ["mode", "spinner", "version-control", "file-name", "file-modification-indicator"]
right = ["diagnostics", "selections", "position", "separator", "file-encoding", "total-line-numbers"]

[editor.lsp]
display-inlay-hints = true
auto-signature-help = true

# <> Pair for generics, doesn't seem to be working everywhere
[editor.auto-pairs]
'<' = '>'
'[' = ']'
'(' = ')'
'{' = '}'
'"' = '"'
'`' = '`'
"'" = "'"

# Indent guides cause I like em
[editor.indent-guides]
render = true
character = "┊"
skip-levels = 1

# I like soft wrapping
[editor.soft-wrap]
enable = true
max-wrap = 25

Mostly just aesthetics.
No keybinds yet, the default ones seem to be good enough.

[realeinherjar]

theme = "catppuccin_mocha"
[editor]
bufferline = "multiple"
color-modes = true
line-number = "relative"
mouse = true
rulers = [80]
scrolloff = 8
true-color = true

[editor.cursor-shape]
insert = "bar"
normal = "block"
select = "underline"

[editor.file-picker]
hidden = false

[editor.indent-guides]
render = true

[editor.lsp]
display-inlay-hints = true
display-messages = true

[editor.statusline]
center = ["file-name"]
left = ["mode", "spinner", "version-control"]
right = ["diagnostics", "selections", "position-percentage", "position", "file-encoding", "file-line-ending", "file-type"]
separator = "│"

[editor.statusline.mode]
insert = "INSERT"
normal = "NORMAL"
select = "SELECT"

[keys]
[keys.normal]
A-j = ["ensure_selections_forward", "extend_to_line_bounds", "extend_char_right", "extend_char_left", "delete_selection", "add_newline_below", "move_line_down", "replace_with_yanked"]
A-k = ["ensure_selections_forward", "extend_to_line_bounds", "extend_char_right", "extend_char_left", "delete_selection", "move_line_up", "add_newline_above", "move_line_up", "replace_with_yanked"]
A-x = "extend_to_line_bounds"
X = ["extend_line_up", "extend_to_line_bounds"]
esc = ["collapse_selection", "keep_primary_selection"]

[keys.normal.space]
q = ":quit"
w = ":write"

[keys.select]
A-x = "extend_to_line_bounds"
X = ["extend_line_up", "extend_to_line_bounds"]

[jeronimobarea]

I'm running a custom gruvbox theme: https://github.com/jeronimobarea/helix_gruvbox_community

theme = "gruvbox_community"

[editor.indent-guides]
render = true
character = "│"

[editor.statusline]
left = ["mode", "spacer", "version-control", "spacer", "diagnostics", "file-name"]
right = ["position-percentage", "spacer", "position"]
mode.normal = "N"
mode.insert = "I"
mode.select = "S"

[editor]
scrolloff = 8
rulers = [80]
line-number = "relative"
cursorline = true
bufferline = "always"
true-color = true
mouse = false
color-modes = true

[editor.file-picker]
hidden = false

[editor.lsp]
display-messages = true

[keys.normal]
"esc" = [ "normal_mode", ":format" , ":write" ] # For quick saving
"#" = "toggle_comments"
"{" = "goto_prev_paragraph"
"}" = "goto_next_paragraph"

[keys.normal.space]
q = ":bc"
o = "file_picker_in_current_buffer_directory"

[keys.normal.space.w]
r = ":rla"

[sdoerner]

Kakoune-style selection can also extend to goto and match mode:

[keys.normal.g]
H = ["select_mode", "goto_line_start", "normal_mode"]
L = ["select_mode", "goto_line_end", "normal_mode"]
S = ["select_mode", "goto_first_nonwhitespace", "normal_mode"]
E = ["select_mode", "goto_last_line", "normal_mode"]
G = ["select_mode", "goto_file_start", "normal_mode"]

[keys.normal.m]
M = ["select_mode", "match_brackets", "normal_mode"]

[rahil627]

for complete current configs

still have to create a pop-up menu / minor-mode for my terminal and buffers, but here's a few sane defaults 'n things i most commonly use (posted before i stole from everyone else's configs 😅):

[keys.normal]
C-j = "page_down" # was C-f, C-d; NOTE: goto_window_top by default
C-k = ["page_up", "goto_window_top"] # was C-b, C-u
# for keyboards without home/end buttons:
C-h = "goto_first_nonwhitespace" # gh # NOTE: does not select by default, use H/L key-maps instead
C-l = "goto_line_end"  # gl;

# extend selection
# shift commonly signifies extend selection
B = "extend_prev_word_start" # or long_word
W = "extend_next_word_start"
E = "extend_next_word_end"

# the next few are among my most used mappings

# H = "extend_to_first_nonwhitespace" # vgh[esc]
# L = "extend_to_line_end" # vgl[esc]
H = "extend_parent_node_start" # thanks to pierrelgol below!!
L = "extend_parent_node_end"

# NOTE: doesn't yank, only knows how to kill
# C-S-h = "kill_to_line_start" # can conflict with buffer shortcuts
# C-S-l = "kill_to_line_end"

# possibly the most IMPORTANT: selection mapping, along with x; it's what happens when you double click in most ide's; cycles through m,i/o mode (match inside/outside); 
C-o = "expand_selection" # A-o/i by default; word -> inside comment or parameters (repeated) -> line -> block -> buffer; it just works via tree-sitter not lsp TODO: remove final select entire buffer expansion
C-S-o = "shrink_selection" # selects current word at minimum; since i'm holding control already, it felt natural to just add shift instead of c-i

# @00sapo is genius
# x = "extend_to_line_bounds" # /shrink, strangely, this was the default..??
x = ["extend_line", "select_mode"] # fantastic mapping, teaches you to use select_mode in the process, allowing precise selection, at the cost of one key to exit
X = ["extend_line", "select_mode", "flip_selections"] # same as the above but prepare for going up by flipping the cursor to the beginning of the selection
C-x = "extend_line_below" # the sane default, press again to extend one more line
C-X = "extend_line_above"
  # matches C-ret/C-ret for adding lines down/up


# tab was completely unmapped by default..?? TODO: PR: maybe discuss for sane config
tab = "goto_next_buffer"
S-tab = "goto_previous_buffer"
C-tab = "rotate_view" # TODO: not working, maybe a windows os problem.., use c-s-h/l
C-S-tab = "rotate_view_reverse"

# return was completely unmapped by default
# it's often simpler to think starting from the beginning of a line
ret = ["move_line_down", "goto_first_nonwhitespace"]
S-ret = ["move_line_up", "goto_first_nonwhitespace"]
# NOTE: also c+j/k in insert-mode, but use it commonly enough..
C-ret = "add_newline_below" # similar to vs-code
C-S-ret = "add_newline_above"

# NOTE: these select/highlight by default
"C-[" = "goto_prev_paragraph"
"C-]" = "goto_next_paragraph"
"C-{" = "jump_backward" # TODO: not working :(
"C-}" = "jump_forward"

# r<->R: i don't understand the use of r for more than one char, whereas R is used more often, replacing a selection, and works well with search (search and replace); can just use c to replace a single char, at the cost of one more key-press..??
r = "replace_with_yanked"  # matches y/p
R = "replace" # char

# these are also in the space pop-up menu
# TODO: could just use the clipboard only, and avoid using the main register " completely
C-y = "yank_joined_to_clipboard" # maybe had better formatting for junk copied from the web?..
C-S-y = "yank_to_clipboard" # space-y
C-p = "paste_clipboard_before" # space,P, usually this is the one i want
C-S-p = "paste_clipboard_after" # space,p
C-r = "replace_selections_with_clipboard" #space,R, :clipboard-paste-replace?

# actually legit, lol
minus = "decrement" # 'minus' not '-', for parsing reasons
"=" = "increment" # default is format_selections via LSP


# explicitly free (and note!) some keys that changed after sensible defaults
# it will throw an error when you map something twice
C-b = "no_op" # "page_up"
C-f = "no_op" # "page_down" # TODO: "search" matches windows os, "file_picker" matches terminal file-manager, fzf
C-u = "no_op" # half_page_up"
C-d = "no_op" # "half_page_down"

C-i = "no_op" # "jump_forward" # also mapped to C-S-} and ],j
# C-o = "no_op" # "jump_backward"
C-s = "no_op" # "save_selection" # also mapped to [,s and ]


# i haven't quite decided on which modifier key works best on a windows laptop keyboard layout.. i think i prefer control+shift.. but do NOTE: i have control and alt keys swapped at an OS level! (the key next to space is the only one i use)

# buffer
C-S-j = "goto_next_buffer" # gn, :bn TODO: gj/gk, currently gn/gp
C-S-k = "goto_previous_buffer" # gp, :bp
C-S-n = ":new" # :n
C-S-w = ":buffer-close" # :bc # matches close tab
# C-S-c = ":buffer-close" # :bc # (c)lose
C-S-q = ":buffer-close" # q feels stronger than w/c

# split-views
# NOTE: you can goto_next_buffer within a view! so still need to rotate_view
C-S-h = "rotate_view" # TODO: gh/hl is taken, so gn/gp or gc-j/gc-k or gc-n/gc-p
C-S-l = "rotate_view_reverse"
 # NOTE: replaces kill_to_line_start/end
C-S-s = ":hsplit-new" # s > h
C-S-v = ":vsplit-new" # vs vsplit (opens current buffer in the new split)
# C-S-q = ":quit" # closes current view, but not the buffer
C-S-c = ":quit" # although q works for :quit command, it shouldn't have been named quit to begin with. q feels stronger, use either c and/or w
# 'C-S-;' = ":quit" # closes current view # TODO: BUG: not working

# NOTE: i also re-mapped the terminal pane keys to match helix, but use the key further away from space. wezterm actually has a leader-key feature, but i don't have much use for alt otherwise, so it's fine for now... also , i don't think the leader-key feature has a pop-up menu... yet!



[keys.normal."backspace"] # backspace seems unused in normal mode.., and it's a big button! :)
# it feels better to do these here, more tactile than c-s/c-q/c-r
# many keys to choose from!: esc (caps lock), c-space, \, f1..
s = ":write"
S = ":write!"
q = ":quit"
Q = ":quit!"
r = ":reload"
R = ":reload-all"

f = ":format"

# shortcuts to most used files could go here: other configs, main todo, snippets, etc.
c = ":config-open" # vs h, :o ~/.config/helix/config.toml"
C = [":config-reload", ":reload-all"] # great for quickly editing the config! kinda confusing key..
l = ":o ~/.config/helix/languages.toml"
# w = wezzzzzterm config

[keys.normal."["]
j = "jump_backward"
s = "save_selection"
[keys.normal."]"]
j = "jump_forward"
s = "save_selection"

[David-Else]

C-j = "page_down" # was C-f, C-d; NOTE: goto_window_top by default
C-k = ["page_up", "goto_window_top"] # was C-b, C-u

Is fantastic. Why not goto_window_top by default on the original bindings on up and down? I don't get the thinking behind it.

[rahil627]

i don't quite remember... iirc, i think it originally left the cursor at the bottom third, when going up, and i liked to keep it at the same position, top third. something strange.

also thinking about just mapping C-j/k to goto_next/prev_paragraph, and find something else for page down/up.. i use that so often.

[rahil627]

ohhh, i think i read that wrong: you mean, why are those the default bindings? LOL. no clue!

[valpackett]

the backspace menu is very clever! totally stealing that

[rahil627]

there's so many keys to choose from! my escape key (mapped to caps lock) is tiny on my laptop keyboard... as is the entire function key row.. but '\', return, and backspace are all pretty big and unused..! i was thinking c-space is another good one, as a sort of alt-space-mode. 😃 (as long as the OS isn't using it..)

[pierrelgol]

My config is massive, and some options are technically just the defaults, but I like to have all the options available without having to look at the documentation.

################################################################################
#                                    HELIX                                     #
################################################################################

###################
# THEME           #
###################
theme = "rose_pine"

###################
# CONFIG          #
###################

[editor]
auto-completion                    = true
auto-format                        = true
auto-info                          = true
auto-save                          = true
bufferline                         = "always"
color-modes                        = true
completion-replace                 = true
completion-timeout                 = 5
completion-trigger-len             = 1
cursorcolumn                       = true
cursorline                         = true
default-line-ending                = "lf"
idle-timeout                       = 5
indent-heuristic                   = "hybrid"
insert-final-newline               = true
jump-label-alphabet                = "asdfghjklweruio"
line-number                        = "relative"
middle-click-paste                 = true
mouse                              = true
preview-completion-insert          = true
rulers                             = [80]
scroll-lines                       = 5
scrolloff                          = 5
text-width                         = 80
true-color                         = true
undercurl                          = true

[editor.cursor-shape]
insert                             = "bar"
normal                             = "block"
select                             = "underline"

[editor.file-picker]
hidden                             = true
follow-symlinks                    = true
deduplicate-links                  = true
parents                            = true
ignore                             = true
git-ignore                         = true
git-global                         = true
git-exclude                        = true
max-depth                          = 5

[editor.gutters]
layout                             = ["line-numbers","diagnostics","diff"]

[editor.indent-guides]
character                          = "|"
render                             = true
skip-levels                        = 0

[editor.lsp]
auto-signature-help                = true
display-inlay-hints                = true
display-messages                   = true
display-signature-help-docs        = true
enable                             = true
goto-reference-include-declaration = true
snippets                           = true

[editor.search]
smart-case                         = false

[editor.smart-tab]
enable                             = false

[editor.soft-wrap]
enable                             = false

[editor.statusline]
left                               = ["mode","spinner","version-control", "file-name","file-modification-indicator",]
center                             = ["workspace-diagnostics","spacer"]
right                              = ["primary-selection-length","spacer","register","spacer","position","separator","total-line-numbers","separator","position-percentage","file-type","file-encoding","file-line-ending"]
separator                          = ":"
mode.insert                        = "INSERT"
mode.normal                        = "NORMAL"
mode.select                        = "SELECT"

###################
# KEYBINDINGS     #
###################

[keys.normal]
esc      = ["collapse_selection", "keep_primary_selection"]
ret      = ["align_view_center", "goto_word"]
S-tab    = [":bp"]
tab      = [":bn"]
S        = ["surround_add"]
h        = ["move_char_left", "align_view_center"]
j        = ["move_line_down","align_view_center"]
k        = ["move_line_up","align_view_center"]
l        = ["move_char_right", "align_view_center"]
C-k      = ["extend_to_line_bounds","delete_selection", "move_line_up","paste_before"]
C-j      = ["extend_to_line_bounds","delete_selection", "move_line_down","paste_before"]
C-b      = ["goto_line_start"]
C-e      = ["goto_line_end"]
"*"      = ["move_prev_word_start", "move_next_word_end", "search_selection"]
A-h      = ["extend_parent_node_start"]
A-l      = ["extend_parent_node_end"]

[keys.normal.space]
","      = ["save_selection", "goto_line_end", ":append-output echo ','", "collapse_selection", "delete_selection", "jump_backward"]
";"      = ["save_selection", "goto_line_end", ":append-output echo ';'", "collapse_selection", "delete_selection", "jump_backward"]


[keys.normal.space.t]
a        = ":toggle-option auto-completion"
s        = ":toggle-option auto-save"
f        = ":toggle-option auto-format"
h        = ":toggle-option lsp.display-inlay-hints"
l        = ":toggle-option lsp.enable"

[keys.normal.space.c]
l        = ":o ~/.config/helix/languages.toml"
o        = ":config-open"
r        = [":w", ":config-reload",":reload-all"]

[keys.insert]
A-j      = ["normal_mode","extend_to_line_bounds","delete_selection", "move_line_down","paste_before", "insert_mode"]
A-k      = ["normal_mode","extend_to_line_bounds","delete_selection", "move_line_up","paste_before", "insert_mode"]
C-b      = ["insert_at_line_start","align_view_center"]
C-e      = ["insert_at_line_end","align_view_center"]
C-h      = ["move_char_left","align_view_center"]
C-j      = ["move_line_down","align_view_center"]
C-k      = ["move_line_up","align_view_center"]
C-l      = ["move_char_right","align_view_center"]

[keys.select]
pageup   = ["half_page_up"]
pagedown = ["half_page_down"]
"C-u"    = ["half_page_up"]
"C-d"    = ["half_page_down"]
esc      = ["collapse_selection", "normal_mode"]
c        = ["trim_selections", "change_selection"]
";"      = ["flip_selections"]
","      = ["repeat_last_motion"]

[keys.select."]"]
"]"      = ["goto_prev_paragraph"]

[keys.select."["]
"["      = ["goto_next_paragraph"]

[rahil627]

adding the ,/; to the end of line!! genius, lol.

ahhh i forgot that can go to another mode from space mode... that indeed might be the way to go... that mode is just so full of stuff already..