Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ELINKS(1)		    The	Elinks text-browser		     ELINKS(1)

       elinks -	lynx-like alternative character	mode WWW browser

       elinks [OPTION]... [URL]...

       ELinks is a text	mode WWW browser, supporting colors, table rendering,
       background downloading, menu driven configuration interface, tabbed
       browsing	and slim code.

       Frames are supported. You can have different file formats associated
       with external viewers. mailto: and telnet: are supported	via external

       ELinks can handle both local files and remote URLs. The main supported
       remote URL protocols are	HTTP, HTTPS (with SSL support compiled in) and
       FTP. Additional protocol	support	exists for BitTorrent finger, Gopher,
       SMB and NNTP.

       The homepage of ELinks can be found at <>, where the
       ELinks manual is	also hosted.

       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
       roughly equivalent to the output	of running ELinks with the option

       -anonymous [0|1]	(default: 0)
	   Restricts ELinks so it can run on an	anonymous account. Local file
	   browsing, downloads,	and modification of options will be disabled.
	   Execution of	viewers	is allowed, but	entries	in the association
	   table can't be added	or modified.

       -auto-submit [0|1] (default: 0)
	   Automatically submit	the first form in the given URLs.

       -base-session <num> (default: 0)
	   Used	internally when	opening	ELinks instances in new	windows. The
	   ID maps to information that will be used when creating the new
	   instance. You don't want to use it.

       -config-dir <str> (default: "")
	   Path	of the directory ELinks	will read and write its	config and
	   runtime state files to instead of ~/.elinks.	If the path does not
	   begin with a	'/' it is assumed to be	relative to your HOME

	   Print a configuration file with options set to the built-in
	   defaults to stdout.

       -config-file <str> (default: "elinks.conf")
	   Name	of the configuration file that all configuration options will
	   be read from	and written to.	It should be relative to config-dir.

	   Print help for configuration	options	and exit.

       -default-mime-type (alias for mime.default_type)
	   The default MIME type used for documents of unknown type.

       -default-keys [0|1] (default: 0)
	   When	set, all keybindings from configuration	files will be ignored.
	   It forces use of default keybindings	and will reset user-defined
	   ones	on save.

       -dump [0|1] (default: 0)
	   Print formatted plain-text versions of given	URLs to	stdout.

       -dump-charset (alias for	document.dump.codepage)
	   Codepage used when formatting dump output.

       -dump-width (alias for document.dump.width)
	   Width of the	dump output.

	   Specify configuration file directives on the	command-line which
	   will	be evaluated after all configuration files has been read.
	   Example usage:

	       -eval 'set protocol.file.allow_special_files = 1'

	   Makes ELinks	assume documents of unknown types are HTML. Useful
	   when	using ELinks as	an external viewer from	MUAs. This is
	   equivalent to -default-mime-type text/html.

       -?, -h, -help
	   Print usage help and	exit.

       -localhost [0|1]	(default: 0)
	   Restricts ELinks to work offline and	only connect to	servers	with
	   local addresses (ie. No connections to remote servers
	   will	be permitted.

	   Print detailed usage	help and exit.

	   Look	up specified host and print all	DNS resolved IP	addresses.

       -no-connect [0|1] (default: 0)
	   Run ELinks as a separate instance instead of	connecting to an
	   existing instance. Note that	normally no runtime state files
	   (bookmarks, history,	etc.) are written to the disk when this	option
	   is used. See	also -touch-files.

       -no-home	[0|1] (default:	0)
	   Disables creation and use of	files in the user specific home
	   configuration directory (~/.elinks).	It forces default
	   configuration values	to be used and disables	saving of runtime
	   state files.

       -no-numbering (alias for	document.dump.numbering)
	   Prevents printing of	link number in dump output. Note that this
	   really affects only -dump, nothing else.

       -no-references (alias for document.dump.references)
	   Prevents printing of	references (URIs) of document links in dump
	   output. Note	that this really affects only -dump, nothing else.

	   Control a remote ELinks instance by passing commands	to it. The
	   option takes	an additional argument containing the method which
	   should be invoked and any parameters	that should be passed to it.
	   For ease of use, the	additional method argument can be omitted in
	   which case any URL arguments	will be	opened in new tabs in the
	   remote instance. Following is a list	of the supported methods:

	   o	ping():	look for a remote instance

	   o	openURL(): prompt URL in current tab

	   o	openURL(URL): open URL in current tab

	   o	openURL(URL, new-tab): open URL	in new tab

	   o	openURL(URL, new-window): open URL in new window

	   o	addBookmark(URL): bookmark URL

	   o	infoBox(text): show text in a message box

	   o	xfeDoCommand(openBrowser): open	new window

       -session-ring <num> (default: 0)
	   ID of session ring this ELinks session should connect to.  ELinks
	   works in so-called session rings, whereby all instances of ELinks
	   are interconnected and share	state (cache, bookmarks, cookies, and
	   so on). By default, all ELinks instances connect to session ring 0.
	   You can change that behaviour with 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
	   unless you're a developer and you want to do	some testing - if you
	   want	the ELinks instances each running standalone, rather use the
	   -no-connect command-line option. Also note that normally no runtime
	   state files are written to the disk when this option	is used. See
	   also	-touch-files.

       -source [0|1] (default: 0)
	   Print given URLs in source form to stdout.

       -touch-files [0|1] (default: 0)
	   When	enabled, runtime state files (bookmarks, history, etc.)	are
	   written to disk, even when -no-connect or -session-ring is used.
	   The option has no effect if not used	in conjunction with any	of
	   these options.

       -verbose	<num> (default:	1)
	   The verbose level controls what messages are	shown at start up and
	   while running:

	   o   0: means	only show serious errors

	   o   1: means	show serious errors and	warnings

	   o   2: means	show all messages

	   Print ELinks	version	information and	exit.
       Generated using output from ELinks version 0.11.7.

	   The shell used for File -> OS Shell on DOS/Windows and UNIX,

	   The program to use for external editor (when	editing	textareas).

	   The location	of the directory containing configuration files. If
	   not set the default is ~/.elinks/.

	   The command to run when selecting File -> New window	and if
	   TWDISPLAY is	defined	(default twterm	-e).

	   The command to run when selecting File -> New window	and if DISPLAY
	   is defined (default xterm -e).

	   The host to proxy the various protocol traffic through.

	   A comma separated list of URLs which	should not be proxied.

	   The path to the users home directory. Used when expanding ~/.

	   Homepage location (as in lynx(1)).

       Configuration files controlled by ELinks	are located in the user
       configuration directory,	defaulting to ~/.elinks/. In addition to the
       files listed below, a user defined CSS stylesheet can be	defined	using
       the document.css.stylesheet option.

	   Site-wide configuration file.

	   Per-user config file, loaded	after site-wide	configuration.

	   Bookmarks file.

	   Cookies file.

	   Exmode history file.

	   Form	history	file.

	   History file	containing most	recently visited URLs.

	   GoTo	URL dialog history file.

	   Browser scripting hooks.

	   Search history file.

	   Internal ELinks socket for communication between its	instances.

       ~/.mailcap, /etc/mailcap
	   Mappings of MIME types to external handlers.

       ~/.mime.types, /etc/mime.types
	   Mappings of file extensions to MIME types.

       Please report any other bugs you	find to	the either the ELinks mailing
       list at <> or if you prefer enter them
       into the	bug tracking system <>. More
       information about how to	get in contact with developers and getting
       help can	be found on the	community page

       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; version 2 of the License.

       The Links browser - on which ELinks is based - was written by Mikulas
       Patocka <>. ELinks was written by Petr
       Baudis <>. See file AUTHORS in the source tree for a	list
       of people contributing to this project.

       This manual page	was written by Peter Gervai <>, using
       excerpts	from a (yet?) unknown Links fan	for the	Debian GNU/Linux
       system (but may be used by others). Contributions from Francis A.
       Holop. Extended,	clarified and made more	up-to-date by Petr Baudis
       <>. Updated by Zas <>. The conversion to
       Asciidoc	and trimming was done by Jonas Fonseca <>.

       elinkskeys(5), elinks.conf(5), links(1),	lynx(1), w3m(1), wget(1)

ELinks 0.11.7			  08/22/2009			     ELINKS(1)


Want to link to this manual page? Use this URL:

home | help