ELINKS(1) General Commands Manual ELINKS(1)
NAME
elinks - lynx-like alternative character mode WWW browser
SYNOPSIS
elinks [options] URL
DESCRIPTION
ELinks is a text mode WWW browser, supporting colors, correct table rendering, background downloading, menu driven configuration interface
and slim code.
Frames are supported. You can have different file formats associated with external viewers. mailto: and telnet: are supported via external
clients.
ELinks can handle local (file://) or remote (http://, ftp:// or https:// if there's compiled-in SSL support) URLs. It has also basic sup-
port for finger:.
OPTIONS
Most options can be set in the user interface or config file, so usually you do not need to care about them. Note that this list is by no
means complete and it is not kept up-to-date. To get complete list of commandline options, start ELinks with parameter --help.
-anonymous <0>/<1>
Restrict ELinks so that it can run on an anonymous account. No local file browsing. No downloads. Executing of viewers is allowed,
but user can't add or modify entries in association table.
-auto-submit <0>/<1>
Go and submit the first form you'll stumble upon.
-base-session <number>
ID of session (ELinks instance) which we want to clone. This is internal ELinks option, you don't want to use it.
-dump Write a plain-text version of the given HTML document to stdout.
-dump-charset <charset>
Codepage used in dump output.
-dump-width <width>
Width of the dump output.
-eval <string>
Specify elinks.conf config options on the command-line: -eval 'set protocol.file.allow_special_files = 1'
-? -h -help
Print usage help and exit.
-lookup <hostname>
Make lookup for specified host.
-no-connect <0>/<1>
Run ELinks as a separate instance - instead of connecting to existing instance. Note that normally no runtime state files (I mean
bookmarks, history and so on) are written to the disk with this option on - see also -touch-files.
-no-home <0>/<1>
Don't attempt to create and/or use home rc directory (~/.elinks).
-session-ring <number>
ID of session ring this ELinks should connect to. The ELinks works in so-called session rings, where all instances of ELinks are
interconnected and share same state (cache, bookmarks, cookies and so on). By default, all ELinks instances connect to session ring
0. You can change that behaviour by this switch and form as many session rings as you want. Obviously, if the session-ring with this
number doesn't exist yet, it's created and this ELinks instance will become the master instance (that usually doesn't matter for you
as a user much). Note that you usually don't want to use this except you're a developer and you want to do some testing - if you
want the ELinks instances running each one standalone, rather use -no-connect commandline option. Also note that normally no runtime
state files are written to the disk with this option on - see also -touch-files.
-source <0>/<1>
Write the given HTML document in source form to stdout.
-stdin <0>/<1>
Open stdin as HTML document - it is fully equivalent to: -eval 'set protocol.file.allow_special_files = 1' file:///dev/stdin Use
whichever suits you more ;-). Note that reading document from stdin WORKS ONLY WHEN YOU USE -dump OR -source!! (I would like to know
why you would use -source -stdin, though ;-)
-touch-files <0>/<1>
Set to 1 to have runtime state files (bookmarks, history, ...) changed even when -no-connect is used; has no effect if not used in
connection with the -no-connect commandline option.
-version
Print ELinks version information and exit.
NAVIGATION KEYS
You may optionally prefix each of this keys with a number, telling its repeat count (how much times to do it). You can also re-bind those
keys. See elinkskeys(5) for complete documentation about keybindings and more complete list of keys bound by default. The keys you may
use for navigation are:
PGDN page down
Space page down
PGUP page up
b page up
B page up
CursorDOWN
next link/down
CursorUP
prev link/up
^INS copy to clipboard
^C copy to clipboard
INS scroll up
^P scroll up
DEL scroll down
^N scroll down
[ scroll left
] scroll right
HOME home
END end of page
CursorRIGHT
enter link/press button
ENTER enter link/press button
CursorLEFT
go back
d download link
D download link
F4 edit textarea in external editor (broken)
^T edit textarea in external editor (broken)
/ search in the page
? search back in the page
n find next match
N find next match backwards
f zoom actual frame
F zoom actual frame
^R reload page
g go to URL
G go to the current URL
a add a new bookmark
A add a new bookmark
s bookmark manager
S bookmark manager
^K reload cookies from ~/.elinks/cookies
q quit
Q quit
= document information
| header information
toggle HTML source/rendered view
* toggle display of images
TAB next frame
ESC menu/escape
F9 menu
F10 file menu
EDITING KEYS
The following keys can be used while editing a line/jumping to a URL:
CursorRIGHT
move right
CursorLEFT
move left
HOME jump to the beginning
^A jump to the beginning
END jump to the end
^E jump to the end
^INS copy to clipboard
^B copy to clipboard
^X cut to clipboard
^V paste from clipboard
ENTER enter line
BACKSPACE
delete back character
^H delete back character
DEL delete character
^D delete character
^U delete from beginning of the line
^K delete to the end of the line
^W auto complete line
ENVIRONMENT
ELINKS_CONFDIR
The location of ".elinks/" user's directory
WWW_HOME
Homepage location (as in lynx )
ELINKS_XTERM,
The command to run when selecting "File/New window" and if DISPLAY is defined (default "xterm -e")
ELINKS_TWTERM,
The command to run when selecting "File/New window" and if TWDISPLAY is defined (default "twterm -e")
SHELL Used for "File/OS Shell" menu
COMSPEC
Used for "File/OS Shell" menu in DOS/Windows
FILES
~/.elinks/elinks.conf
Per-user config file
~/.elinks/bookmarks
Bookmarks file
~/.elinks/cookies
Cookies file
~/.elinks/gotohist
GoTo URL dialog history file
~/.elinks/globhist
History file containing last 4096 URLs visited
~/.elinks/socket
Internal ELinks socket for communication between its instances.
PLATFORMS
ELinks is known to work on Linux, FreeBSD, OpenBSD, Solaris, IRIX, HPUX, Digital Unix, AIX, OS/2, BeOS and RISC OS. Port for Win32 is in
state of beta testing.
BUGS
See BUGS file coming with ELinks distribution tarball for list of known bugs.
Please report any other bugs you find to (E)Links mailing list <links-list@linuxfromscratch.org>.
LICENSE
ELinks is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your option) any later version.
AUTHOR
Links was written by Mikulas Patocka <mikulas@artax.karlin.mff.cuni.cz>. ELinks - which is based on Links
- was written by Petr Baudis <pasky@ucw.cz>. See file AUTHORS in the source tree for a list of people contributing to this project.
The homepage of ELinks can be found at http://elinks.or.cz/
This manual page was written by Peter Gervai <grin@tolna.net>, using excerpts from a (yet?) unknown Links fan for the Debian GNU/Linux sys-
tem (but may be used by others). Contributions from Francis A. Holop. Extended, clarified and made more up-to-date by Petr Baudis
<pasky@ucw.cz>. Updated by Zas <zas at norz.org>.
SEE ALSO
elinkskeys(5), elinks.conf(5), links(1), lynx(1), w3m(1), wget(1)
Nov, 2002 ELINKS(1)