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)