ELINKSKEYS(5)

NAME
elinkskeys - keybindings for ELinks

DESCRIPTION

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.

KEYS

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).

MAIN KEYMAP ACTIONS

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.

EDIT KEYMAP ACTIONS

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.

MENU KEYMAP ACTIONS

The menu keymap is used for navigating menus.

left

right

up

down

home

end

page-up

page-down

NAVIGATION KEYS

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

EDITING KEYS

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

DEFAULT BINDINGS

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"

AUTHOR

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.

SEE ALSO

elinks(1), elinks.conf(5)