elinkskeys - keybindings for ELinks

Key bindings for elinks should be placed in a file called ~/.elinks/elinks.conf. Note that any information regarding their format/structure may not be up-to-date. If you will discover that, please feed us with a patch.

Key binding statements are of the form:

bind "keymap" "keystroke" = "action"

where:

keymap

is main, edit, or menu.

keystroke

is a case sensitive key, which you can prefix with Ctrl- or Alt-. Ctrl- must be followed by an uppercase key. See below for a list of valid keys.

action

is what the key should do. The actions available are dependent on the keymap, and are listed separately below.

All words/strings may all be quoted "like so". Backslashes are escape characters, even if not between quotes. Lines beginning with a hash character (#) are comments.

Keys can be unbound just by binding them to "none" action. It may be of use if you accidentally type a key often.

Valid keys are: alphanumeric characters, punctuation, Enter, Backspace, Tab, Escape, Left, Right, Up, Down, Insert, Delete, Home, End, PageUp, PageDown, F1 to F12.

Some keys will need to be quoted or escaped. For example, space can be written as " " (quote space quote), and the quote itself as \" (backslash quote). Backslash can be written as \\ (double backslash).

The main keymap is used for general browsing.

add-bookmark

Open a dialog box to add a new bookmark.

back

Return to the previous page.

bookmark-manager

Open the bookmark manager dialog.

cookies-load

Reload cookies file.

copy-clipboard

Copy the current link to the clipboard.

document-info

Show some information about the current page.

down

Move cursor downwards.

download

Start downloading the current link.

end

Go to the end of the page.

enter

Follow the current link.

file-menu

Open the File menu.

find-next

Find the next occurrence of the current search text.

find-next-back

Find the next occurrence of the current search text, in reverse.

goto-url

Open a "Go to URL" dialog box.

goto-url-current

Open a "Go to URL" dialog box containing the current URL.

goto-url-current-link

Open a "Go to URL" dialog box containing the current link.

header-info

Show the current page header information.

home

Go to the start of the page.

link-menu

Activate the contextual link menu.

lua-console

Open a Lua Console dialog box. Only available if Lua scripting support has been compiled in (Links-Lua and ELinks).

menu

Activate the menu.

next-frame

Move to the next frame.

open-new-window

Open a new instace of ELinks in a new window.

open-link-in-new-window

Open the current link in a new instance of ELinks in a new window.

page-down

Move downwards by a page.

page-up

Move upwards by a page.

paste-clipboard

Paste text from the clipboard.

previous-frame

Move to the previous frame.

quit

Open a quit confirmation dialog box.

really-quit

Quit without confirmation.

reload

Reload the current page.

scroll-down

Scroll the viewing window downwards.

scroll-left

Scroll the viewing window to the left.

scroll-right

Scroll the viewing window to the right.

scroll-up

Scroll the viewing window upwards.

search

Search for some text.

search-back

Search for some text, in reverse.

toggle-display-images

Toggle whether to display links to images.

toggle-display-tables

Toggle whether to render tables.

toggle-html-plain

Toggles between rendering the current page as HTML or plaintext.

unback

Go forwards in unhistory.

up

Move cursor upwards.

view-image

View the image under the cursor.

zoom-frame

Show the current frame using the entire screen.

The edit keymap is used for editing text fields.

up

down

left

right

home

end

backspace

delete

kill-to-bol

Delete text from cursor to beginning of line.

kill-to-eol

Delete text from cursor to end of line

auto-complete

enter

copy-clipboard

cut-clipboard

paste-clipboard

edit

Edit the current textarea in an external text editor.

The menu keymap is used for navigating menus.

left

right

up

down

home

end

page-up

page-down

You may prefix each of these keys with a number, telling its repeat count (how many times to do it). You can also re-bind keys, see elinkskeys(5) for documentation and a more complete list of keys bound by default.

PGDN

page down

Space

page down

PGUP

page up

b

page up

B

page up

DOWN

next link/down

UP

prev link/up

^INS

copy to clipboard

^C

copy to clipboard

INS

scroll up

^P

scroll up

DEL

scroll down

^N

scroll down

[

scroll left

]

scroll right

HOME

home

END

end of page

RIGHT

enter link/press button

ENTER

enter link/press button

LEFT

go back

d

download link

D

download link

F4

edit textarea in external editor (broken)

^T

edit textarea in external editor (broken)

/

search in the page

?

search back in the page

n

find next match

N

find next match backwards

f

zoom actual frame

F

zoom actual frame

^R

reload page

g

go to URL

G

go to the current URL

a

add a new bookmark

A

add a new bookmark

s

bookmark manager

S

bookmark manager

^K

reload cookies from ~/.elinks/cookies

q

quit

Q

quit

=

document information

|

header information

\

toggle HTML source/rendered view

*

toggle display of images

TAB

next frame

ESC

menu/escape

F9

menu

F10

file menu

The following keys can be used while editing a line/jumping to a URL:

RIGHT

move right

LEFT

move left

HOME

jump to the beginning

^A

jump to the beginning

END

jump to the end

^E

jump to the end

^INS

copy to clipboard

^B

copy to clipboard

^X

cut to clipboard

^V

paste from clipboard

ENTER

enter line

BACKSPACE

delete back character

^H

delete back character

DEL

delete character

^D

delete character

^U

delete from beginning of the line

^K

delete to the end of the line

^W

auto complete line

The default bindings are shown below. Any bindings in elinks.conf will override these. This list is given as an example, and may not be up to date.

bind "main" "v" = "view-image"
bind "main" "l" = "jump-to-link"
bind "main" "L" = "link-menu"
bind "main" "F10" = "file-menu"
bind "main" "F9" = "menu"
bind "main" "Escape" = "menu"
bind "main" "Tab" = "next-frame"
bind "main" "*" = "toggle-display-images"
bind "main" "." = "toggle-numbered-links"
bind "main" "\\" = "toggle-html-plain"
bind "main" "<" = "tab-prev"
bind "main" ">" = "tab-next"
bind "main" "c" = "tab-close"
bind "main" "|" = "header-info"
bind "main" "=" = "document-info"
bind "main" "Q" = "really-quit"
bind "main" "q" = "quit"
bind "main" "Ctrl-K" = "cookies-load"
bind "main" "k" = "keybinding-manager"
bind "main" "o" = "options-manager"
bind "main" "h" = "history-manager"
bind "main" "S" = "bookmark-manager"
bind "main" "s" = "bookmark-manager"
bind "main" "A" = "add-bookmark-link"
bind "main" "a" = "add-bookmark"
bind "main" "M" = "goto-url-home"
bind "main" "m" = "goto-url-home"
bind "main" "H" = "goto-url-home"
bind "main" "G" = "goto-url-current"
bind "main" "g" = "goto-url"
bind "main" "E" = "goto-url-current-link"
bind "main" "Ctrl-R" = "reload"
bind "main" "F" = "zoom-frame"
bind "main" "f" = "zoom-frame"
bind "main" "N" = "find-next-back"
bind "main" "n" = "find-next"
bind "main" "?" = "search-back"
bind "main" "/" = "search"
bind "main" "z" = "abort-connection"
bind "main" "R" = "resume-download"
bind "main" "r" = "resume-download"
bind "main" "D" = "download"
bind "main" "d" = "download"
bind "main" "U" = "unback"
bind "main" "u" = "unback"
bind "main" "Left" = "back"
bind "main" "x" = "enter-reload"
bind "main" "Ctrl-Enter" = "enter-reload"
bind "main" "Ctrl-Right" = "enter-reload"
bind "main" "Enter" = "enter"
bind "main" "Right" = "enter"
bind "main" "Ctrl-E" = "end"
bind "main" "End" = "end"
bind "main" "Ctrl-A" = "home"
bind "main" "Home" = "home"
bind "main" "}" = "scroll-right"
bind "main" "{" = "scroll-left"
bind "main" "]" = "scroll-right"
bind "main" "[" = "scroll-left"
bind "main" "Ctrl-N" = "scroll-down"
bind "main" "Delete" = "scroll-down"
bind "main" "Ctrl-P" = "scroll-up"
bind "main" "Insert" = "scroll-up"
bind "main" "Ctrl-C" = "copy-clipboard"
bind "main" "Ctrl-Insert" = "copy-clipboard"
bind "main" "Up" = "up"
bind "main" "Down" = "down"
bind "main" "Ctrl-B" = "page-up"
bind "main" "B" = "page-up"
bind "main" "b" = "page-up"
bind "main" "PageUp" = "page-up"
bind "main" "Ctrl-F" = "page-down"
bind "main" " " = "page-down"
bind "main" "PageDown" = "page-down"

bind "edit" "Ctrl-R" = "auto-complete-unambiguous" bind "edit" "Ctrl-W" = "auto-complete" bind "edit" "Ctrl-K" = "kill-to-eol" bind "edit" "Ctrl-U" = "kill-to-bol" bind "edit" "Ctrl-D" = "delete" bind "edit" "Delete" = "delete" bind "edit" "Ctrl-H" = "backspace" bind "edit" "Backspace" = "backspace" bind "edit" "Enter" = "enter" bind "edit" "Ctrl-V" = "paste-clipboard" bind "edit" "Ctrl-X" = "cut-clipboard" bind "edit" "Ctrl-C" = "copy-clipboard" bind "edit" "Ctrl-Insert" = "copy-clipboard" bind "edit" "Ctrl-T" = "edit" bind "edit" "F4" = "edit" bind "edit" "Ctrl-E" = "end" bind "edit" "End" = "end" bind "edit" "Down" = "down" bind "edit" "Up" = "up" bind "edit" "Ctrl-A" = "home" bind "edit" "Home" = "home" bind "edit" "Right" = "right" bind "edit" "Left" = "left"

bind "menu" "Ctrl-B" = "page-up" bind "menu" "PageUp" = "page-up" bind "menu" "Ctrl-F" = "page-down" bind "menu" "PageDown" = "page-down" bind "menu" "Enter" = "enter" bind "menu" "Ctrl-E" = "end" bind "menu" "End" = "end" bind "menu" "Down" = "down" bind "menu" "Up" = "up" bind "menu" "Ctrl-A" = "home" bind "menu" "Home" = "home" bind "menu" "Right" = "right" bind "menu" "Left" = "left"

# ELinks with Lua support bind "main" "," = "lua-console"

This manual page was finally written by Peter Wang (one and a half years after writing the binding code), using excerpts by David Mediavilla. You can thank Petr Baudis for the subtle requests for documentation. Updated by Zas. Moved to docbook format and cleaned up by Jonas.

elinks(1), elinks.conf(5)