ELINKSKEYS
Section: ELinks keybindings (5)
Updated: 10/26/2012
Page Index
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)