AERC-BINDS(5) # NAME aerc-binds - key bindings configuration file format for *aerc*(1) # SYNOPSIS The _binds.conf_ file is used for configuring keybindings used in the aerc interactive client. It is expected to be in your XDG config home plus _aerc_, which defaults to _~/.config/aerc/binds.conf_. If the file does not exist, the built-in default will be installed. This file is written in the ini format with key bindings defined as: ** = __ Where ** is the keystrokes pressed (in order) to invoke this keybinding, and __ specifies keystrokes that aerc will simulate when the keybinding is invoked. Generally this is used to execute commands, for example: *rq* = _:reply -q_ Pressing *r*, then *q*, will simulate typing in _:reply -q_, and execute *:reply -q* accordingly. It is also possible to invoke keybindings recursively in a similar fashion. You may configure different keybindings for different contexts by writing them into different *[sections]* of the ini file. # CONTEXTS The available contexts are: *[messages]* keybindings for the message list *[view]* keybindings for the message viewer *[view::passthrough]* keybindings for the viewer, when in key passthrough mode (toggled with *:toggle-key-passthrough*) *[compose]* keybindings for the message composer *[compose::editor]* keybindings for the composer, when the editor is focused *[compose::review]* keybindings for the composer, when reviewing the email before it's sent *[terminal]* keybindings for terminal tabs You may also configure account specific key bindings for each context: *[context:account=*_AccountName_*]* keybindings for this context and account, where _AccountName_ matches the account name you provided in _accounts.conf_. Folder-specific bindings can be configured for message lists: *[messages:folder=*_FolderName_*]* keybindings under this section will be specific to the folder named _FolderName_. Keybindings from a folder specifier will take precedence over account specifiers You can use regex to match account or folder names: *[context:folder~*_Regex_*]* Add folder specific bindings for folders whose names match the regular expression. Examples: ``` [messages:account=Mailbox] c = :cf path:mailbox/** and [compose::editor:account=Mailbox2] [messages:folder=Drafts] = :recall [messages:folder~Archive/\d+/.*] gi = :cf Inbox ... ``` You may also configure global keybindings by placing them at the beginning of the file, before specifying any context-specific sections. # SPECIAL OPTIONS In addition of user defined key sequences, the following special options are available in each binding context: *$noinherit* = _true_|_false_ If set to _true_, global keybindings will not be effective in this context. Default: _false_ *$ex* = __ This can be set to a keystroke which will bring up the command input in this context. Default: _:_ # SUPPORTED KEYS In addition to letters and some characters (e.g. *a*, *RR*, *gu*, *?*, *!*, etc.), special keys may be specified in **. The following special keys are supported: [[ *Name* :- *Description* | ** : " " | ** : ; | ** : Tab | ** : Enter | ** : Up arrow | ** : Ctrl+Up | ** : Alt+Up | ** : Down arrow | ** : Ctrl+Down | ** : Alt+Down | ** : Right arrow | ** : Ctrl+Right | ** : Alt+Right | ** : Left arrow | ** : Ctrl+Left | ** : Alt+Left | ** : Page Up | ** : Ctrl+PageUp | ** : Alt+PageUp | ** : Page Down | ** : Ctrl+PageDn | ** : Alt+PageDn | ** : Home | ** : End | ** : Insert | ** : Delete | ** : Exit | ** : Cancel | ** : Print screen | ** : Pause | ** : Shift+Tab | ** : Ctrl+Space | ** : Alt+Space | ** : Ctrl+a | ** : Alt+a | ** : Ctrl+b | ** : Alt+b | ** : Ctrl+c | ** : Alt+c | ** : Ctrl+d | ** : Alt+d | ** : Ctrl+e | ** : Alt+e | ** : Ctrl+f | ** : Alt+f | ** : Ctrl+g | ** : Alt+g | ** : Ctrl+h | ** : Alt+h | ** : Ctrl+i | ** : Alt+i | ** : Ctrl+j | ** : Alt+j | ** : Ctrl+k | ** : Alt+k | ** : Ctrl+l | ** : Alt+l | ** : Ctrl+m | ** : Alt+m | ** : Ctrl+n | ** : Alt+n | ** : Ctrl+o | ** : Alt+o | ** : Ctrl+p | ** : Alt+p | ** : Ctrl+q | ** : Alt+q | ** : Ctrl+r | ** : Alt+r | ** : Ctrl+s | ** : Alt+s | ** : Ctrl+t | ** : Alt+t | ** : Ctrl+u | ** : Alt+u | ** : Ctrl+v | ** : Alt+v | ** : Ctrl+w | ** : Alt+w | ** : Ctrl+x | ** : Alt+x | ** : Ctrl+y | ** : Alt+y | ** : Ctrl+z | ** : Alt+z | ** : Ctrl+] | ** : Alt+] | ** : Ctrl+[ | ** : Alt+[ | ** : Ctrl+^ | ** : Alt+^ | ** : Ctrl+\_ | ** : Alt+\_ # SEE ALSO *aerc*(1) *aerc-config*(5) # AUTHORS Originally created by Drew DeVault and maintained by Robin Jarry who is assisted by other open source contributors. For more information about aerc development, see https://sr.ht/~rjarry/aerc/.