NAME

       elinkskeys - keybindings for ELinks

SYNOPSIS

       Information on how to configure keybinding and overview of the default keybindings.

DESCRIPTION

       Key binding for elinks should be placed in the file ~/.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. The main keymap is used for general browsing. The edit keymap
           is used for editing text fields. The menu keymap is used for navigating menus.

       <keystroke>
           is a case sensitive key, which you can prefix with Ctrl-, Alt-, or both.  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 the special none action. It may be of use if
       you accidentally type a key often.

EXAMPLE BINDINGS

       Some sample keybindings:

           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 "edit" "Ctrl-R" = "auto-complete-unambiguous"
           bind "edit" "Ctrl-W" = "auto-complete"
           bind "edit" "Ctrl-K" = "kill-to-eol"
           bind "menu" "Ctrl-B" = "page-up"
           bind "menu" "PageUp" = "page-up"
           bind "menu" "Ctrl-F" = "page-down"
           bind "menu" "PageDown" = "page-down"
           # ELinks with Lua support
           bind "main" "," = "lua-console"

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

KEYMAP ACTIONS

   MAIN ACTIONS
       abort-connection
           Abort connection.

       add-bookmark
           Add a new bookmark.

       add-bookmark-link
           Add a new bookmark using current link.

       add-bookmark-tabs
           Bookmark all open tabs.

       auth-manager
           Open authentication manager.

       backspace-prefix
           Backspace the last entered digit of the current prefix.

       bookmark-manager
           Open bookmark manager.

       cache-manager
           Open cache manager.

       cache-minimize
           Free unused cache entries.

       cookie-manager
           Open cookie manager.

       cookies-load
           Reload cookies file.

       copy-clipboard
           Copy text to clipboard.

       document-info
           Show information about the current page.

       download-manager
           Open download manager.

       exmode
           Enter ex-mode (command line).

       file-menu
           Open the File menu.

       find-next
           Find the next occurrence of the current search text.

       find-next-back
           Find the previous occurrence of the current search text.

       forget-credentials
           Forget authentication credentials.

       formhist-manager
           Open form history manager.

       frame-external-command
           Pass URI of current frame to external command.

       frame-maximize
           Maximize the current frame.

       frame-next
           Move to the next frame.

       frame-prev
           Move to the previous frame.

       goto-url
           Open "Go to URL" dialog box.

       goto-url-current
           Open "Go to URL" dialog box containing the current URL.

       goto-url-current-link
           Open "Go to URL" dialog box containing the current link URL.

       goto-url-home
           Go to the homepage.

       header-info
           Show information about the current page protocol headers.

       history-manager
           Open history manager.

       history-move-back
           Return to the previous document in history.

       history-move-forward
           Go forward in history.

       jump-to-link
           Jump to link.

       keybinding-manager
           Open keybinding manager.

       kill-backgrounded-connections
           Kill all backgrounded connections.

       link-download
           Download the current link.

       link-download-image
           Download the current image.

       link-download-resume
           Attempt to resume download of the current link.

       link-external-command
           Pass URI of current link to external command.

       link-follow
           Follow the current link.

       link-follow-reload
           Follow the current link, forcing reload of the target.

       link-menu
           Open the link context menu.

       link-form-menu
           Open the form fields menu.

       lua-console
           Open a Lua console.

       mark-goto
           Go at a specified mark.

       mark-set
           Set a mark.

       menu
           Activate the menu.

       move-cursor-down
           Move cursor down.

       move-cursor-left
           Move cursor left.

       move-cursor-line-start
           Move cursor to the start of the line.

       move-cursor-right
           Move cursor right.

       move-cursor-up
           Move cursor up.

       move-document-end
           Move to the end of the document.

       move-document-start
           Move to the start of the document.

       move-link-down
           Move one link down.

       move-link-down-line
           Move to the next line with a link.

       move-link-left
           Move one link left.

       move-link-left-line
           Move one link left or to the previous link.

       move-link-next
           Move to the next link.

       move-link-prev
           Move to the previous link.

       move-link-right
           Move one link right.

       move-link-right-line
           Move one link right or to the next link.

       move-link-up
           Move one link up.

       move-link-up-line
           Move to the previous line with a link.

       move-page-down
           Move downwards by a page.

       move-page-up
           Move upwards by a page.

       open-link-in-new-tab
           Open the current link in a new tab.

       open-link-in-new-tab-in-background
           Open the current link in a new tab in the background.

       open-link-in-new-window
           Open the current link in a new window.

       open-new-tab
           Open a new tab.

       open-new-tab-in-background
           Open a new tab in the background.

       open-new-window
           Open a new window.

       open-os-shell
           Open an OS shell.

       options-manager
           Open options manager.

       quit
           Open a quit confirmation dialog box.

       really-quit
           Quit without confirmation.

       redraw
           Redraw the terminal.

       reload
           Reload the current page.

       rerender
           Re-render the current page.

       reset-form
           Reset form items to their initial values.

       resource-info
           Show information about the currently used resources.

       save-as
           Save the current document in source form.

       save-formatted
           Save the current document in formatted form.

       save-options
           Save options.

       save-url-as
           Save URL as.

       scroll-down
           Scroll down.

       scroll-left
           Scroll left.

       scroll-right
           Scroll right.

       scroll-up
           Scroll up.

       search
           Search for a text pattern.

       search-back
           Search backwards for a text pattern.

       search-typeahead
           Search link text by typing ahead.

       search-typeahead-link
           Search link text by typing ahead.

       search-typeahead-text
           Search document text by typing ahead.

       search-typeahead-text-back
           Search document text backwards by typing ahead.

       show-term-options
           Show terminal options dialog.

       submit-form
           Submit form.

       submit-form-reload
           Submit form and reload.

       tab-close
           Close tab.

       tab-close-all-but-current
           Close all tabs but the current one.

       tab-external-command
           Pass URI of current tab to external command.

       tab-menu
           Open the tab menu.

       tab-move-left
           Move the current tab to the left.

       tab-move-right
           Move the current tab to the right.

       tab-next
           Next tab.

       tab-prev
           Previous tab.

       terminal-resize
           Open the terminal resize dialog.

       toggle-css
           Toggle rendering of page using CSS.

       toggle-display-images
           Toggle displaying of links to images.

       toggle-display-tables
           Toggle rendering of tables.

       toggle-document-colors
           Toggle usage of document specific colors.

       toggle-html-plain
           Toggle rendering page as HTML / plain text.

       toggle-mouse
           Toggle mouse handling.

       toggle-numbered-links
           Toggle displaying of links numbers.

       toggle-plain-compress-empty-lines
           Toggle plain renderer compression of empty lines.

       toggle-wrap-text
           Toggle wrapping of text.

       view-image
           View the current image.

   EDIT ACTIONS
       auto-complete
           Attempt to auto-complete the input.

       auto-complete-file
           Attempt to auto-complete a local file.

       auto-complete-unambiguous
           Attempt to unambiguously auto-complete the input.

       backspace
           Delete character in front of the cursor.

       beginning-of-buffer
           Go to the first line of the buffer.

       cancel
           Cancel current state.

       copy-clipboard
           Copy text to clipboard.

       cut-clipboard
           Cut text to clipboard.

       delete
           Delete character under cursor.

       down
           Move cursor downwards.

       end
           Go to the end of the page/line.

       end-of-buffer
           Go to the last line of the buffer.

       enter
           Follow the current link.

       home
           Go to the start of the page/line.

       kill-to-bol
           Delete to beginning of line.

       kill-to-eol
           Delete to end of line.

       kill-word-back
           Delete backwards to start of word.

       left
           Move the cursor left.

       move-backward-word
           Move cursor before current word.

       move-forward-word
           Move cursor after current word.

       next-item
           Move to the next item.

       open-external
           Open in external editor.

       paste-clipboard
           Paste text from the clipboard.

       previous-item
           Move to the previous item.

       redraw
           Redraw the terminal.

       right
           Move the cursor right.

       search-toggle-regex
           Toggle regex matching (type-ahead searching).

       up
           Move cursor upwards.

   MENU ACTIONS
       cancel
           Cancel current state.

       delete
           Delete character under cursor.

       down
           Move cursor downwards.

       end
           Go to the end of the page/line.

       enter
           Follow the current link.

       expand
           Expand item.

       home
           Go to the start of the page/line.

       left
           Move the cursor left.

       mark-item
           Mark item.

       next-item
           Move to the next item.

       page-down
           Move downwards by a page.

       page-up
           Move upwards by a page.

       previous-item
           Move to the previous item.

       redraw
           Redraw the terminal.

       right
           Move the cursor right.

       search
           Search for a text pattern.

       select
           Select current highlighted item.

       unexpand
           Collapse item.

       up
           Move cursor upwards.

DEFAULT BINDINGS

       The default bindings are shown below. Any bindings in ~/.elinks/elinks.conf will override
       these.

   MAIN KEYS
       Space
           Move downwards by a page (move-page-down)

       "#"
           Search link text by typing ahead (search-typeahead)

       "%"
           Toggle usage of document specific colors (toggle-document-colors)

       "*"
           Toggle displaying of links to images (toggle-display-images)

       ","
           Open a Lua console (lua-console)

       "."
           Toggle displaying of links numbers (toggle-numbered-links)

       "/"
           Search for a text pattern (search)

       ":"
           Enter ex-mode (command line) (exmode)

       "<"
           Previous tab (tab-prev)

       Alt-"<"
           Move the current tab to the left (tab-move-left)

       "="
           Show information about the current page (document-info)

       ">"
           Next tab (tab-next)

       Alt-">"
           Move the current tab to the right (tab-move-right)

       "?"
           Search backwards for a text pattern (search-back)

       "A"
           Add a new bookmark using current link (add-bookmark-link)

       Ctrl-"A"
           Move to the start of the document (move-document-start)

       Ctrl-"B"
           Move upwards by a page (move-page-up)

       "C"
           Open cache manager (cache-manager)

       "D"
           Open download manager (download-manager)

       "E"
           Open "Go to URL" dialog box containing the current link URL (goto-url-current-link)

       Ctrl-"E"
           Move to the end of the document (move-document-end)

       "F"
           Open form history manager (formhist-manager)

       Ctrl-"F"
           Move downwards by a page (move-page-down)

       "G"
           Open "Go to URL" dialog box containing the current URL (goto-url-current)

       "H"
           Go to the homepage (goto-url-home)

       "K"
           Open cookie manager (cookie-manager)

       Ctrl-"K"
           Reload cookies file (cookies-load)

       "L"
           Open the link context menu (link-menu)

       Ctrl-"L"
           Redraw the terminal (redraw)

       "N"
           Find the previous occurrence of the current search text (find-next-back)

       Ctrl-"N"
           Scroll down (scroll-down)

       Ctrl-"P"
           Scroll up (scroll-up)

       "Q"
           Quit without confirmation (really-quit)

       Ctrl-"R"
           Reload the current page (reload)

       "T"
           Open the current link in a new tab in the background
           (open-link-in-new-tab-in-background)

       "W"
           Toggle wrapping of text (toggle-wrap-text)

       "["
           Scroll left (scroll-left)

       "'"
           Go at a specified mark (mark-goto)

       "\"
           Toggle rendering page as HTML / plain text (toggle-html-plain)

       "]"
           Scroll right (scroll-right)

       "a"
           Add a new bookmark (add-bookmark)

       "b"
           Move upwards by a page (move-page-up)

       "c"
           Close tab (tab-close)

       "d"
           Download the current link (link-download)

       "e"
           Open the tab menu (tab-menu)

       "f"
           Maximize the current frame (frame-maximize)

       "g"
           Open "Go to URL" dialog box (goto-url)

       "h"
           Open history manager (history-manager)

       "k"
           Open keybinding manager (keybinding-manager)

       "l"
           Jump to link (jump-to-link)

       "m"
           Set a mark (mark-set)

       "n"
           Find the next occurrence of the current search text (find-next)

       "o"
           Open options manager (options-manager)

       "q"
           Open a quit confirmation dialog box (quit)

       "r"
           Attempt to resume download of the current link (link-download-resume)

       "s"
           Open bookmark manager (bookmark-manager)

       "t"
           Open a new tab (open-new-tab)

       "u"
           Go forward in history (history-move-forward)

       "v"
           View the current image (view-image)

       "x"
           Follow the current link, forcing reload of the target (link-follow-reload)

       "z"
           Abort connection (abort-connection)

       "{"
           Scroll left (scroll-left)

       "|"
           Show information about the current page protocol headers (header-info)

       "}"
           Scroll right (scroll-right)

       Backspace
           Backspace the last entered digit of the current prefix (backspace-prefix)

       Delete
           Scroll down (scroll-down)

       Down
           Move to the next link (move-link-next)

       End
           Move to the end of the document (move-document-end)

       Enter
           Follow the current link (link-follow)

       Ctrl-Enter
           Follow the current link, forcing reload of the target (link-follow-reload)

       Escape
           Activate the menu (menu)

       F10
           Open the File menu (file-menu)

       F9
           Activate the menu (menu)

       Home
           Move to the start of the document (move-document-start)

       Insert
           Scroll up (scroll-up)

       Ctrl-Insert
           Copy text to clipboard (copy-clipboard)

       Left
           Return to the previous document in history (history-move-back)

       PageDown
           Move downwards by a page (move-page-down)

       PageUp
           Move upwards by a page (move-page-up)

       Right
           Follow the current link (link-follow)

       Ctrl-Right
           Follow the current link, forcing reload of the target (link-follow-reload)

       Tab
           Move to the next frame (frame-next)

       Alt-Tab
           Move to the previous frame (frame-prev)

       Shift-Tab
           Move to the previous frame (frame-prev)

       Up
           Move to the previous link (move-link-prev)

   EDIT KEYS
       Alt-"<"
           Go to the first line of the buffer (beginning-of-buffer)

       Alt-">"
           Go to the last line of the buffer (end-of-buffer)

       Ctrl-"A"
           Go to the start of the page/line (home)

       Alt-"b"
           Move cursor before current word (move-backward-word)

       Ctrl-"D"
           Delete character under cursor (delete)

       Ctrl-"E"
           Go to the end of the page/line (end)

       Alt-"f"
           Move cursor after current word (move-forward-word)

       Ctrl-"H"
           Delete character in front of the cursor (backspace)

       Ctrl-"K"
           Delete to end of line (kill-to-eol)

       Ctrl-"L"
           Redraw the terminal (redraw)

       Alt-"r"
           Toggle regex matching (type-ahead searching) (search-toggle-regex)

       Ctrl-"F"
           Attempt to auto-complete a local file (auto-complete-file)

       Ctrl-"R"
           Attempt to unambiguously auto-complete the input (auto-complete-unambiguous)

       Ctrl-"T"
           Open in external editor (open-external)

       Ctrl-"U"
           Delete to beginning of line (kill-to-bol)

       Ctrl-"V"
           Paste text from the clipboard (paste-clipboard)

       Ctrl-"W"
           Attempt to auto-complete the input (auto-complete)

       Ctrl-"X"
           Cut text to clipboard (cut-clipboard)

       Alt-Backspace
           Delete backwards to start of word (kill-word-back)

       Backspace
           Delete character in front of the cursor (backspace)

       Delete
           Delete character under cursor (delete)

       Down
           Move cursor downwards (down)

       End
           Go to the end of the page/line (end)

       Enter
           Follow the current link (enter)

       Escape
           Cancel current state (cancel)

       F4
           Open in external editor (open-external)

       Home
           Go to the start of the page/line (home)

       Ctrl-Insert
           Copy text to clipboard (copy-clipboard)

       Left
           Move the cursor left (left)

       Right
           Move the cursor right (right)

       Tab
           Move to the next item (next-item)

       Alt-Tab
           Move to the previous item (previous-item)

       Shift-Tab
           Move to the previous item (previous-item)

       Up
           Move cursor upwards (up)

   MENU KEYS
       Space
           Select current highlighted item (select)

       "*"
           Mark item (mark-item)

       "+"
           Expand item (expand)

       "-"
           Collapse item (unexpand)

       "/"
           Search for a text pattern (search)

       "="
           Expand item (expand)

       Ctrl-"A"
           Go to the start of the page/line (home)

       Ctrl-"B"
           Move upwards by a page (page-up)

       Ctrl-"E"
           Go to the end of the page/line (end)

       Ctrl-"F"
           Move downwards by a page (page-down)

       Ctrl-"L"
           Redraw the terminal (redraw)

       Ctrl-"N"
           Move cursor downwards (down)

       Ctrl-"P"
           Move cursor upwards (up)

       Alt-"V"
           Move upwards by a page (page-up)

       Ctrl-"V"
           Move downwards by a page (page-down)

       "["
           Expand item (expand)

       "]"
           Collapse item (unexpand)

       "_"
           Collapse item (unexpand)

       Delete
           Delete character under cursor (delete)

       Down
           Move cursor downwards (down)

       End
           Go to the end of the page/line (end)

       Enter
           Follow the current link (enter)

       Escape
           Cancel current state (cancel)

       Home
           Go to the start of the page/line (home)

       Insert
           Mark item (mark-item)

       Left
           Move the cursor left (left)

       PageDown
           Move downwards by a page (page-down)

       PageUp
           Move upwards by a page (page-up)

       Right
           Move the cursor right (right)

       Tab
           Move to the next item (next-item)

       Alt-Tab
           Move to the previous item (previous-item)

       Shift-Tab
           Move to the previous item (previous-item)

       Up
           Move cursor upwards (up)

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 asciidoc format and cleaned up
       by Jonas Fonseca.

SEE ALSO

       elinks(1), elinks.conf(5)