ELINKSKEYS(5) ELinks keybindings ELINKSKEYS(5)NAMEelinkskeys - 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 for‐
mat/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- 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 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 \" (back‐
slash 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.
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-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-left
Move one link left.
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-up
Move one link up.
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
Delete text from 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.
left Move the cursor left.
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-col‐
ors)
* 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-down‐
load-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-fol‐
low-reload)
z Abort connection (abort-connection)
{ Scroll left (scroll-left)
| Show information about the current page protocol headers
(header-info)
} Scroll right (scroll-right)
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-fol‐
low-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-fol‐
low-reload)
Tab Move to the next frame (frame-next)
Alt-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)
Ctrl-D Delete character under cursor (delete)
Ctrl-E Go to the end of the page/line (end)
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-tog‐
gle-regex)
Ctrl-F Attempt to auto-complete a local file (auto-complete-file)
Ctrl-R Attempt to unambiguously auto-complete the input (auto-com‐
plete-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 Delete text from clipboard (cut-clipboard)
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)
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)
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 Mediav‐
illa. You can thank Petr Baudis for the subtle requests for documenta‐
tion. Updated by Zas. Moved to asciidoc format and cleaned up by Jonas
Fonseca.
SEE ALSOelinks(1), elinks.conf(5)2006-01-29 ELinks keybindings ELINKSKEYS(5)
