--- name: "linkskeys" section: "5" platform: "linux" package: "links" version: "0.96.20020409-2" release: "Debian 3.0 (Woody)" platforms: ["linux"] url: "https://new.carta.tech/linkskeys" --- # linkskeys(5) links WWW browser key bindings ## NAME linkskeys - links WWW browser key bindings ## SYNOPSIS **~/.links/user.cfg** ## DESCRIPTION Key bindings for *links* should be placed in a file called **~/.links/user.cfg**. This file will be read from but not written to, so you may put comments in there. 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. Key can be unbound using the **unbind** statement. - unbind *keymap keystroke* 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. (ELinks only) \[pasky, shouldn't this be load-cookies?\] - **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. - **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 *links* in a new window. - **open-link-in-new-window** Open the current link in a new instance of *links* 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. Not in *links* 0.96. - **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. (ELinks only) - **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. (ELinks only) ## MENU KEYMAP ACTIONS The *menu* keymap is used for navigating menus. - **left** - **right** - **up** - **down** - **home** - **end** - **page-up** - **page-down** ## DEFAULT BINDINGS The default bindings are shown below. Any bindings in *user.cfg* will override these. This list is given as an example, and may not be up to date. ``` bind main PageDown page-down bind main " " page-down bind main Ctrl-F page-down bind main PageUp page-up bind main b page-up bind main B page-up bind main Ctrl-B page-up bind main Down down bind main Up up bind main Ctrl-Insert copy-clipboard bind main Ctrl-C copy-clipboard bind main Insert scroll-up bind main Ctrl-P scroll-up bind main Delete scroll-down bind main Ctrl-N scroll-down bind main [ scroll-left bind main ] scroll-right bind main Home home bind main Ctrl-A home bind main End end bind main Ctrl-E end bind main Right enter bind main Enter enter bind main Left back bind main d download bind main D download bind main / search bind main ? search-back bind main n find-next bind main N find-next-back bind main f zoom-frame bind main F zoom-frame bind main Ctrl-R reload bind main g goto-url bind main G goto-url-current bind main a add-bookmark bind main A add-bookmark bind main s bookmark-manager bind main S bookmark-manager bind main q quit bind main Q really-quit bind main = document-info bind main | header-info bind main \\ toggle-html-plain bind main * toggle-display-images bind main Tab next-frame bind main Esc menu bind main F9 menu bind main F10 file-menu bind edit Left left bind edit Right right bind edit Home home bind edit Ctrl-A home bind edit Up Up bind edit Down down bind edit End end bind edit Ctrl-E end bind edit Ctrl-Insert copy-clipboard bind edit Ctrl-B copy-clipboard bind edit Ctrl-X cut-clipboard bind edit Ctrl-V paste-clipboard bind edit Enter enter bind edit Backspace backspace bind edit Ctrl-H backspace bind edit Delete delete bind edit Ctrl-D delete bind edit Ctrl-U kill-to-bol bind edit Ctrl-K kill-to-eol bind edit Ctrl-W auto-complete bind menu Left left bind menu Right right bind menu Home home bind menu Ctrl-A home bind menu Up up bind menu Down down bind menu End end bind menu Ctrl-E end bind menu Enter enter bind menu PageDown page-down bind menu Ctrl-F page-down bind menu PageUp page-up bind menu Ctrl-B page-up # ELinks only bind main u unback bind main U unback bind main Ctrl-K cookies-load bind edit F4 edit bind edit Ctrl-T edit # Links-Lua and ELinks bind main , lua-console ``` ## FILES **/etc/links.cfg** Site-wide configuration file. **~/.links/user.cfg** Per-user configuration file, loaded after site-wide configuration. ## 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.. ## SEE ALSO [**links**(1)](/links/1.md)