keys.lua

Key bindings, aliases and emoticons. keys.lua returns all three, and config.lua sets them in the config as keys, aliases and emotes:

local keys = require("keys")

return {
  keys    = keys.bindings,
  aliases = keys.aliases,
  emotes  = keys.emotes,
  -- ...
}

bindings

Each entry names an action and the key to bind it to. Action names have hyphens in them, so they go in square brackets:

local bindings = {
  ["switcher"]    = "ctrl+p",
  ["next-buffer"] = "ctrl+n",
}

Setting an action replaces all of its default keys with the one you give. next-buffer is on both alt+down and alt+j by default, so the example above leaves it on ctrl+n alone.

An action that does not exist, or a key luir cannot read, is refused when the config loads, naming the one at fault. luir --list-actions prints every action with the keys it is on now, your changes included, and F1 shows the same inside luir.

Writing a key

A key is any number of modifiers joined with +, then the key itself: ctrl+k, alt+shift+n, f5.

Names are not case-sensitive, so shift has to be written out: alt+shift+a, not alt+A. alt+shift+a and alt+a are different keys.

Every action

alt+1 to alt+9 jump to a buffer by its number in the sidebar. They are checked before any binding and are not actions, so they cannot be moved.

tmux and alt+arrows

Inside tmux, alt+left and alt+right may never reach luir: a common tmux setup binds them to switching sessions without the prefix. That is why alt+, and alt+. switch networks too, by default, since tmux leaves those alone. To see what tmux holds:

tmux list-keys -T root | grep -E 'M-(Left|Right)'

To give the arrows back to luir, add unbind -n M-Left and unbind -n M-Right to .tmux.conf. Rebinding next-network or prev-network yourself replaces both of its default keys with the one you give.

Keys you cannot rebind

Editing in the prompt is fixed, in the readline style:

A bound action gets a key before the prompt does, which matters for a few keys the prompt also understands. ctrl+w deletes a word and ctrl+k deletes to the end of the line, but by default those keys belong to close-buffer and switcher; bind those actions to something else and the editing keys work. In the same way, alt+left and alt+right only move by a word once prev-network and next-network are off them.

alt+m, or a click on a nick, hands the keyboard to the member list, and while it has it these keys are fixed too:

o needs ops in that channel, and v and K need ops or halfops, so the status bar only offers them to someone who has what they need. The other keys give the keyboard back when they are done, but o and v keep it, since a channel is often sorted out a few people at a time.

aliases

Your own slash commands. Each maps a name to the command line it runs, and luir expands it before running the command.

local aliases = {
  shrug = "/me shrugs",
  w     = "/whois $1",
  ban   = "/mode #chat +b $1",
  op    = "/msg ChanServ OP $1 $2",
}

Yours are merged over a bundled set by name, so naming one that is already taken replaces it. /help lists every alias in force. The bundled set is the services shorthands, which go through /msg so they work on networks that do not define them, and a few others:

emotes

Emoticons for the picker. alt+e opens it over the bundled set of over three hundred (the shrug, the table flip, Lenny and the rest), searching their keywords as well as their names, so angry finds the table flip. enter drops the one you pick into the prompt at the cursor rather than sending it, since it is usually in the middle of a sentence. /emote flip table nope sends one outright, with text alongside it.

Many of the bundled ones come from ASCIImoji by jiggly, under the Beer-Ware License.

Yours are merged over the bundled set by name, so naming one that is already taken replaces it:

local emotes = {
  ["my shrug"] = "¯\\_(ツ)_/¯",
  ["tea"]      = "( ˘▽˘)っ♨",
}

These are Lua strings, so a backslash has to be written twice. "¯\_(ツ)_/¯" with a single one is an invalid escape, and the config will not load.