1ELINKS.CONF(5) ELinks configuration file ELINKS.CONF(5)
2
6 elinks.conf - ELinks configuration file
7
9 set <option> = <value>
10 unset <option>
11 bind "<keymap>" "<key>" = "<action>"
12 include "<file>"
13
15 The elinks.conf file contains configuration information for ELinks. It
16 can be used to configure the behaviour of ELinks in a wide variety of
17 ways: protocol behaviour, keybindings, colors used for rendering and
18 for the user interface.
19 It is read at startup and saved only when requested. All options
21 described in this document can be fully configured from within ELinks
22 so no editing of elinks.conf is needed.
23 Note that MIME-related options used for specifying handlers of various
25 MIME types are not fully described in this document. Documentation for
26 these options can be found in the MIME chapter of the ELinks manual.
27 Keybindings can also be specified in elinks.conf. This is described in
28 elinkskeys(5).
29
31 The syntax of the configuration file is very simple. The elinks.conf
32 file is a free-form ASCII text file. The file may contain extra tabs
33 and newlines for formatting purposes. Keywords in the file are
34 case-sensitive. Comments may be placed anywhere within the file (except
35 within quotes). Comments begin with the # character and end at the end
36 of the line.
37
39 Some sample settings:
40 # Use asynchronous DNS resolver?
42 set connection.async_dns = 1
43 # horizontal text margin.
44 set document.browse.margin_width = 3
45 # Default document codepage.
46 set document.codepage.assume = "ISO-8859-1"
47 # User defined protocol handlers
48 set protocol.user.mailto.unix = "mutt %h -s \"%s\""
49
51 Generated using output from ELinks version 0.12pre6.
52 bookmarks (Bookmarks)
54 Bookmark options.
55 bookmarks.file_format <num> (default: 0)
57 File format for bookmarks (affects both reading and saving):
58 · 0 is the default native ELinks format
60 · 1 is XBEL universal XML bookmarks format
62 bookmarks.folder_state [0|1] (default: 1)
64 When saving bookmarks also store whether folders are expanded or
65 not, so the look of the bookmark dialog is kept across ELinks
66 sessions. If disabled all folders will appear unexpanded next time
67 ELinks is run.
68 config (Configuration system)
70 Configuration handling options.
71 config.comments <num> (default: 3)
73 Amount of comments automatically written to the config file:
74 · 0 is no comments are written
76 · 1 is only the "blurb" (name+type) is written
78 · 2 is only the description is written
80 · 3 is full comments are written
82 config.indentation <num> (default: 2)
84 Shift width of one indentation level in the configuration file.
85 Zero means that no indentation is performed at all when saving the
86 configuration.
87 config.saving_style <num> (default: 3)
89 Determines what happens when you tell ELinks to save options:
90 · 0 is only values of current options are altered
92 · 1 is values of current options are altered and missing options
94 are added at the end of the file
95 · 2 is the configuration file is rewritten from scratch
97 · 3 is values of current options are altered and missing options
99 CHANGED during this ELinks session are added at the end of the
100 file
101 config.i18n [0|1] (default: 0)
103 If set to 1, comments in the configuration file will be translated
104 to the language used by UI. Note that if you have different
105 language set in different terminals, the language used in the
106 configuration file MAY be the same as on the terminal where you
107 saved the file, but it should be generally considered
108 unpredictable.
109 config.saving_style_w [0|1] (default: 0)
111 This is internal option used when displaying a warning about
112 obsolete config.saving_style. You shouldn't touch it.
113 config.show_template [0|1] (default: 0)
115 Show template options in autocreated trees in the options manager
116 and save them to the configuration file.
117 connection (Connections)
119 Connection options.
120 connection.async_dns [0|1] (default: 1)
122 Whether to use asynchronous DNS resolving.
123 connection.max_connections <num> (default: 10)
125 Maximum number of concurrent connections.
126 connection.max_connections_to_host <num> (default: 2)
128 Maximum number of concurrent connections to a given host.
129 connection.receive_timeout <num> (default: 120)
131 Receive timeout (in seconds).
132 connection.retries <num> (default: 3)
134 Number of tries to establish a connection. Zero means try forever.
135 connection.try_ipv4 [0|1] (default: 1)
137 Whether to try to connect to a host over IPv4. Note that if
138 connection.try_ipv6 is enabled too, it takes precedence. And better
139 do not touch this at all unless you are sure what are you doing.
140 Note that you can also force a given protocol to be used on a
142 per-connection basis by using a URL in the style of e.g.
143 http4://elinks.cz/.
144 connection.try_ipv6 [0|1] (default: 1)
146 Whether to try to connect to a host over IPv6.
147 Note that you can also force a given protocol to be used on a
149 per-connection basis by using a URL in the style of e.g.
150 http6://elinks.cz/.
151 connection.unrestartable_receive_timeout <num> (default: 600)
153 Timeout for non-restartable connections (in seconds).
154 connection.ssl (SSL)
156 SSL options.
157 connection.ssl.cert_verify [0|1] (default: 0)
159 Verify the peer's SSL certificate. Note that this needs extensive
160 configuration of OpenSSL by the user.
161 connection.ssl.client_cert (Client Certificates)
163 X509 client certificate options.
164 connection.ssl.client_cert.enable [0|1] (default: 0)
166 Enable or not the sending of X509 client certificates to servers
167 which request them.
168 connection.ssl.client_cert.file <str> (default: "")
170 The location of a file containing the client certificate and
171 unencrypted private key in PEM format. If unset, the file pointed
172 to by the X509_CLIENT_CERT variable is used instead.
173 cookies (Cookies)
175 Cookies options.
176 cookies.accept_policy <num> (default: 2)
178 Cookies accepting policy:
179 · 0 is accept no cookies
181 · 1 is ask for confirmation before accepting cookie
183 · 2 is accept all cookies
185 cookies.max_age <num> (default: -1)
187 Cookie maximum age (in days):
188 · -1 is use cookie's expiration date if any
190 · 0 is force expiration at the end of session, ignoring cookie's
192 expiration date
193 · 1+ is use cookie's expiration date, but limit age to the given
195 number of days
196 cookies.paranoid_security [0|1] (default: 0)
198 When enabled, we'll require three dots in cookies domain for all
199 non-international domains (instead of just two dots). Some
200 countries have generic second level domains (eg. .com.pl, .co.uk)
201 and allowing sites to set cookies for these generic domains could
202 potentially be very bad. Note, it is off by default as it breaks a
203 lot of sites.
204 cookies.save [0|1] (default: 1)
206 Whether cookies should be loaded from and saved to disk.
207 cookies.resave [0|1] (default: 1)
209 Save cookies after each change in cookies list? No effect when
210 cookie saving (cookies.save) is off.
211 document (Document)
213 Document options.
214 document.browse (Browsing)
216 Document browsing options (mainly interactivity).
217 document.browse.margin_width <num> (default: 3)
219 Horizontal text margin.
220 document.browse.refresh [0|1] (default: 1)
222 Automatically follow document-specified refresh directives ('<meta>
223 refresh' tags). Web-page authors use these to instruct the browser
224 to reload a document at a given interval or to load another page.
225 Regardless of the value the refresh URI is accessible as a link.
226 Use the document.browse.minimum_refresh_time to control the minimum
228 number of seconds a refresh will wait.
229 document.browse.minimum_refresh_time <num> (default: 1000)
231 The minimum number of milliseconds that should pass before
232 refreshing. If set to zero the document refresh time is used
233 unchanged. It can fix going back in history for some sites that use
234 refreshing with zero values.
235 document.browse.table_move_order [0|1] (default: 0)
237 Move by columns in table, instead of rows.
238 document.browse.accesskey (Access keys)
240 Options for handling of link access keys. An HTML document can use the
241 ACCESSKEY attribute to assign an access key to an element. When an
242 access key is pressed, the corresponding element will be given focus.
243 document.browse.accesskey.auto_follow [0|1] (default: 0)
245 Automatically follow a link or submit a form if appropriate
246 accesskey is pressed – this is the standard behaviour, but it's
247 considered dangerous.
248 document.browse.accesskey.display [0|1] (default: 0)
250 Display access key in link info.
251 document.browse.accesskey.priority <num> (default: 0)
253 Priority of 'accesskey' HTML attribute:
254 · 0 is first try all normal bindings; if it fails, check
256 accesskey
257 · 1 is first try only frame bindings; if it fails, check
259 accesskey
260 · 2 is first check accesskey (this can be dangerous)
262 document.browse.forms (Forms)
264 Options for handling of the forms interaction.
265 document.browse.forms.auto_submit [0|1] (default: 1)
267 Automagically submit a form when enter is pressed with a text field
268 selected.
269 document.browse.forms.confirm_submit [0|1] (default: 1)
271 Ask for confirmation when submitting a form.
272 document.browse.forms.input_size <num> (default: 20)
274 Default form input size if none is specified.
275 document.browse.forms.insert_mode [0|1] (default: 1)
277 The setting for this option affects how key presses are handled
278 when one selects a text-input form-field. When enabled, one must
279 explicitly 'enter' a selected text-field to edit it; this prevents
280 text fields from capturing key presses, such as presses of a scroll
281 key, when it is inadvertently selected. When disabled, key presses
282 are always inserted into a selected text field.
283 document.browse.forms.editor <str> (default: "")
285 Path to the executable that ELinks should launch when the user
286 requests to edit a textarea with an external editor.
287 If this is blank, ELinks will use the value of the environmental
289 variable $EDITOR. If $EDITOR is empty or not set, ELinks will then
290 default to vi.
291 document.browse.forms.show_formhist [0|1] (default: 0)
293 Ask if a login form should be saved to file or not. This option
294 only disables the dialog, already saved login forms are unaffected.
295 document.browse.images (Images)
297 Options for handling of images.
298 document.browse.images.display_style <num> (default: 2)
300 Display style for image tags when displayed:
301 · 0 means always display IMG
303 · 1 means always display filename
305 · 2 means display alt/title attribute if possible, IMG if not
307 · 3 means display alt/title attribute if possible, filename if
309 not
310 document.browse.images.filename_maxlen <num> (default: 0)
312 Maximum length of image filename when displayed:
313 · 0 means always display full filename
315 · 1-500 means display filename with this maximal length; if it is
317 longer, the middle is substituted by an asterisk
318 document.browse.images.image_link_tagging <num> (default: 1)
320 When to enclose image links:
321 · 0 means never
323 · 1 means never if alt or title are provided (old behavior)
325 · 2 means always
327 document.browse.images.image_link_prefix <str> (default: "[")
329 Prefix string to use to mark image links.
330 document.browse.images.image_link_suffix <str> (default: "]")
332 Suffix string to use to mark image links.
333 document.browse.images.label_maxlen <num> (default: 0)
335 Maximum length of image label (alt/title):
336 · 0 means always display full label
338 · 1-500 means display label with this maximal length; if it is
340 longer, the middle is substituted by an asterisk
341 document.browse.images.show_as_links [0|1] (default: 0)
343 Display links to images without an alt attribute. If this option is
344 off, these images are completely invisible.
345 document.browse.images.show_any_as_links [0|1] (default: 1)
347 Display links to any images in the document, regardless of them
348 having an alt attribute or not. If this option is off, the alt
349 attribute contents is shown, but as normal text, not selectable as
350 a link.
351 document.browse.links (Links)
353 Options for handling of links to other documents.
354 document.browse.links.color_dirs [0|1] (default: 1)
356 Highlight links to directories in FTP and local directory listing.
357 document.browse.links.numbering [0|1] (default: 0)
359 Display numbers next to the links.
360 document.browse.links.target_blank <num> (default: 0)
362 Define how to handle links having target=_blank set:
363 · 0 means open link in current tab
365 · 1 means open link in new tab in foreground
367 · 2 means open link in new tab in background
369 · 3 means open link in new window
371 document.browse.links.use_tabindex [0|1] (default: 1)
373 Whether to navigate links using tabindex specified ordering. The
374 TABINDEX attribute in HTML elements specifies the order in which
375 links should receive focus when using the keyboard to navigate the
376 document.
377 document.browse.links.missing_fragment [0|1] (default: 1)
379 Open a message box when document has no tag with given id.
380 document.browse.links.number_keys_select_link <num> (default: 1)
382 Number keys select links rather than specify command prefixes. This
383 is a tristate:
384 · 0 means never
386 · 1 means if document.browse.links.numbering = 1
388 · 2 means always
390 document.browse.links.warn_malicious [0|1] (default: 1)
392 When following a link the user ID part of the URI is checked and if
393 a maliciously crafted URI is detected a warning dialog will ask
394 before following the link.
395 document.browse.links.wraparound [0|1] (default: 0)
397 When pressing 'down' on the last link, jump to the first one, and
398 vice versa.
399 document.browse.links.active_link (Active link)
401 Options for the active link.
402 document.browse.links.active_link.enable_color [0|1] (default: 0)
404 Enable use of the active link background and text color settings
405 instead of the link colors from the document.
406 document.browse.links.active_link.bold [0|1] (default: 0)
408 Make the active link text bold.
409 document.browse.links.active_link.invert [0|1] (default: 1)
411 Invert the fore- and background color so the link stands out.
412 document.browse.links.active_link.underline [0|1] (default: 0)
414 Underline the active link.
415 document.browse.links.active_link.colors (Colors)
417 Active link colors.
418 document.browse.links.active_link.colors.background <color|#rrggbb>
420 (default: blue)
421 Default background color.
422 document.browse.links.active_link.colors.text <color|#rrggbb> (default:
424 black)
425 Default text color.
426 document.browse.scrolling (Scrolling)
428 Scrolling options.
429 document.browse.scrolling.horizontal_extended [0|1] (default: 1)
431 Whether to allow horizontal scrolling when the document does not
432 extend off the screen. Useful for copy/paste operations.
433 document.browse.scrolling.horizontal_step <num> (default: 8)
435 Number of columns to scroll when a key bound to scroll-left or
436 scroll-right is pressed and no prefix was given.
437 document.browse.scrolling.margin <num> (default: 3)
439 Size of the virtual margin – when you click inside of that margin,
440 document scrolls in that direction.
441 document.browse.scrolling.vertical_step <num> (default: 2)
443 Number of lines to scroll when a key bound to scroll-up or
444 scroll-down is pressed and no prefix was given.
445 document.browse.search (Searching)
447 Options for searching.
448 document.browse.search.case [0|1] (default: 0)
450 Whether the search should match the document text while maintaining
451 case sensitivity.
452 document.browse.search.regex <num> (default: 0)
454 Enable searching with regular expressions:
455 · 0 for plain text searching
457 · 1 for basic regular expression searches
459 · 2 for extended regular expression searches
461 document.browse.search.show_hit_top_bottom [0|1] (default: 1)
463 Whether to show a dialog when the search hits the top or bottom of
464 the document.
465 document.browse.search.wraparound [0|1] (default: 1)
467 Wrap around when searching. Currently only used for typeahead.
468 document.browse.search.show_not_found <num> (default: 2)
470 How to inform the user when nothing is matched:
471 · 0 means do nothing
473 · 1 means beep the terminal
475 · 2 means pop up message box
477 document.browse.search.typeahead <num> (default: 0)
479 Start typeahead searching when an unbound key is pressed without
480 any modifiers. Note that most keys have default bindings, so this
481 feature will not be useful unless you unbind them.
482 · 0 disables this feature; typeahead searching will only be used
484 when you press a key bound to search-typeahead or similar
485 · 1 automatically starts typeahead searching thru link text
487 · 2 automatically starts typeahead searching thru all document
489 text
490 document.cache (Cache)
492 Cache options.
493 document.cache.cache_redirects [0|1] (default: 0)
495 Cache even redirects sent by server (usually thru HTTP by a 302
496 HTTP code and a Location header). This was the original behaviour
497 for quite some time, but it causes problems in a situation very
498 common to various web login systems – frequently, when accessing a
499 certain location, they will redirect you to a login page if they
500 don't receive an auth cookie, the login page then gives you the
501 cookie and redirects you back to the original page, but there you
502 have already cached redirect back to the login page! If this option
503 has value of 0, this malfunction is fixed, but occasionally you may
504 get superfluous (depends on how you take it ;-) requests to the
505 server. If this option has value of 1, experienced users can still
506 workaround it by clever combination of usage of reload, jumping
507 around in session history and hitting ctrl+enter.
508 Note that this option is checked when retrieving the information
510 from cache, not when saving it to cache – thus if you enable it,
511 even previous redirects will be taken from cache instead of asking
512 the server.
513 document.cache.ignore_cache_control [0|1] (default: 1)
515 Ignore Cache-Control and Pragma server headers. When set, the
516 document is cached even with 'Cache-Control: no-cache'.
517 document.cache.revalidation_interval <num> (default: -1)
519 Period in seconds that a cache entry is considered to be
520 up-to-date. When a document is loaded and this interval has elapsed
521 since the document was initially loaded or most recently
522 revalidated with the server, the server will be checked in case
523 there is a more up-to-date version of the document.
524 A value of -1 disables automatic revalidation.
526 document.cache.format (Formatted documents)
528 Format cache options.
529 document.cache.format.size <num> (default: 5)
531 Number of cached formatted pages. Do not get too generous here,
532 'formatted' means that all the accompanying structures are kept in
533 memory so that you get the cached document immediatelly, but these
534 structures may take a lot – 2x the size of the HTML source is
535 probably not unusual, but it can be even more if the document
536 consists of a lot of short lines (padded right, if possible) and
537 links and not much other markup. So if you set this to 256 and then
538 you don't like your ELinks eating 90M, don't come complaining to
539 us. ;-)
540 Also note that the format cache itself is not counted to the memory
542 cache size, but the HTML source of the formatted documents is
543 always cached, even if it is over the memory cache size threshold.
544 (Then of course no other documents can be cached.)
545 document.cache.memory (Memory cache)
547 Memory cache options.
548 document.cache.memory.size <num> (default: 1048576)
550 Memory cache size (in bytes).
551 document.codepage (Charset)
553 Charset options.
554 document.codepage.assume <codepage> (default: System)
556 Default document codepage. 'System' stands for a codepage
557 determined by a selected locale.
558 document.codepage.force_assumed [0|1] (default: 0)
560 Ignore charset info sent by server.
561 document.colors (Default color settings)
563 Default document color settings.
564 document.colors.text <color|#rrggbb> (default: gray75)
566 Default text color.
567 document.colors.background <color|#rrggbb> (default: black)
569 Default background color.
570 document.colors.link <color|#rrggbb> (default: blue)
572 Default link color.
573 document.colors.vlink <color|#rrggbb> (default: yellow)
575 Default visited link color.
576 document.colors.image <color|#rrggbb> (default: darkolivegreen)
578 Default image link color.
579 document.colors.bookmark <color|#rrggbb> (default: hotpink)
581 Default bookmarked link color.
582 document.colors.dirs <color|#rrggbb> (default: yellow)
584 Default directory color.
585 See document.browse.links.color_dirs option.
587 document.colors.increase_contrast [0|1] (default: 1)
589 Increase the contrast between the foreground and background colors
590 to ensure readability. For example it disallows dark colors on a
591 black background. Note, this is different from ensuring the
592 contrast with the ensure_contrast option.
593 document.colors.ensure_contrast [0|1] (default: 1)
595 Makes sure that the back- and foreground colors are never equal.
596 document.colors.use_document_colors <num> (default: 2)
598 Use colors specified in document:
599 · 0 is use always the default settings
601 · 1 is use document colors if available, except background
603 · 2 is use document colors, including background. This can mostly
605 look very impressive, but some sites will appear really ugly.
606 Note, that obviously if the background is not black, it will
607 break the behaviour of transparency.
608 document.css (Cascading Style Sheets)
610 Options concerning how to use CSS for styling documents.
611 document.css.enable [0|1] (default: 1)
613 Enable adding of CSS style info to documents.
614 document.css.import [0|1] (default: 1)
616 When enabled any external style sheets that are imported from
617 either CSS itself using the @import keyword or from the HTML using
618 <link> tags in the document header will also be downloaded.
619 document.css.stylesheet <str> (default: "")
621 The path to the file containing the default user defined Cascading
622 Style Sheet. It can be used to control the basic layout of HTML
623 documents. The path is assumed to be relative to ELinks' home
624 directory.
625 Leave as "" to use built-in document styling.
627 document.download (Downloading)
629 Options regarding files downloading and handling.
630 document.download.directory <str> (default: "./")
632 Default download directory.
633 document.download.set_original_time [0|1] (default: 0)
635 Set the timestamp of each downloaded file to the timestamp stored
636 on the server.
637 document.download.overwrite <num> (default: 2)
639 Prevent overwriting the local files:
640 · 0 is files will silently be overwritten
642 · 1 is add a suffix .{number} (for example '.1') to the name
644 · 2 is ask the user
646 document.download.notify_bell <num> (default: 0)
648 Audio notification when download is completed:
649 · 0 is never
651 · 1 is when background notification is active
653 · 2 is always
655 document.dump (Dump output)
657 Dump output options.
658 document.dump.codepage <codepage> (default: System)
660 Codepage used in dump output. 'System' stands for a codepage
661 determined by a selected locale.
662 document.dump.color_mode <num> (default: -1)
664 Color mode for dumps.
665 Some modes may have been disabled at compile time. The Setup ->
667 Terminal options dialog lists the modes supported by this
668 executable. If you select an unsupported mode, ELinks uses 16
669 colors.
670 The color modes are:
672 · -1 is standard dump mode
674 · 0 is mono mode
676 · 1 is 16 color mode
678 · 2 is 88 color mode
680 · 3 is 256 color mode
682 · 4 is true color mode
684 document.dump.footer <str> (default: "")
686 Footer string used in dumps. %u is substituted by URL.
687 document.dump.header <str> (default: "")
689 Header string used in dumps. %u is substituted by URL.
690 document.dump.numbering [0|1] (default: 1)
692 Whether to print link numbers in dump output.
693 document.dump.references [0|1] (default: 1)
695 Whether to print references (URIs) of document links in dump
696 output.
697 document.dump.separator <str> (default: " ")
699 String which separates two dumps.
700 document.dump.width <num> (default: 80)
702 Width of screen in characters when dumping documents.
703 document.history (History)
705 History options.
706 document.history.keep_unhistory [0|1] (default: 1)
708 Keep unhistory ("forward history").
709 document.history.global (Global history)
711 Global history options.
712 document.history.global.enable [0|1] (default: 1)
714 Enable global history ("history of all pages visited").
715 document.history.global.max_items <num> (default: 1024)
717 Maximum number of entries in the global history.
718 document.history.global.display_type <num> (default: 0)
720 What to display in global history dialog:
721 · 0 is URLs
723 · 1 is page titles
725 document.html (HTML rendering)
727 Options concerning the display of HTML pages.
728 document.html.display_frames [0|1] (default: 1)
730 Display frames.
731 document.html.display_tables [0|1] (default: 1)
733 Display tables.
734 document.html.display_subs [0|1] (default: 1)
736 Display subscripts (as [thing]).
737 document.html.display_sups [0|1] (default: 1)
739 Display superscripts (as ^thing).
740 document.html.link_display <num> (default: 2)
742 How to render <link> tags from the HTML header:
743 · 0 is nothing
745 · 1 is title
747 · 2 is name in addition
749 · 3 is hreflang in addition
751 · 4 is type in addition
753 · 5 is everything
755 document.html.underline_links [0|1] (default: 0)
757 Underline links.
758 document.html.wrap_nbsp [0|1] (default: 0)
760 If set do not honour non breaking space (the nbsp entity) but allow
761 to wrap the text. This can help keeping the width of documents down
762 so no horizontal scrolling is needed.
763 document.plain (Plain rendering)
765 Options concerning the display of plain text pages.
766 document.plain.display_links [0|1] (default: 0)
768 Display URIs in the document as links.
769 document.plain.compress_empty_lines [0|1] (default: 0)
771 Compress successive empty lines to only one in displayed text.
772 document.uri_passing (URI passing)
774 Rules for passing URIs to external commands. When one rule is defined
775 the link and tab menu will have a menu item that makes it possible to
776 pass the the link, frame or tab URI to an external command. If several
777 rules are defined the link and tab menu will have a submenu of items
778 for each rule.
779 Note, this is mostly useful for launching graphical viewers, since
781 there is no support for releasing the terminal while the command runs.
782 The action and submenus are also available by binding keys to the
783 frame-external-command, the link-external-command, and the
784 tab-external-command actions.
785 document.uri_passing._template_ <str> (default: "")
787 A rule for passing URI to an external command. The format is:
788 · %c in the string means the current URL
790 · %% in the string means '%'
792 Do not put single- or double-quotes around %c.
794 ecmascript (ECMAScript)
796 ECMAScript options.
797 ecmascript.enable [0|1] (default: 0)
799 Whether to run those scripts inside of documents.
800 ecmascript.error_reporting [0|1] (default: 0)
802 Open a message box when a script reports an error.
803 ecmascript.ignore_noscript [0|1] (default: 0)
805 Whether to ignore content enclosed by the <noscript> tag when
806 ECMAScript is enabled.
807 ecmascript.max_exec_time <num> (default: 5)
809 Maximum execution time in seconds for a script.
810 ecmascript.block_window_opening [0|1] (default: 0)
812 Whether to disallow scripts to open new windows or tabs.
813 infofiles (Information files)
815 Options for information files in ~/.elinks.
816 infofiles.save_interval <num> (default: 300)
818 Interval at which to trigger information files in ~/.elinks to be
819 saved to disk if they have changed (seconds; 0 to disable)
820 infofiles.secure_save [0|1] (default: 1)
822 First write data to unique temporary file, then rename this file
823 upon successfully finishing this. Note that this relates only to
824 config files, not downloaded files. You may want to disable it if
825 you are using some exotic permissions for concerned files. Secure
826 file saving is automagically disabled if file is symlink.
827 Warning: some systems (ie. OS/2, Win32) require that destination
829 file doesn't exist when rename(3) is called, breaking atomicity,
830 and reducing reliability of this feature.
831 infofiles.secure_save_fsync [0|1] (default: 1)
833 When using secure file saving, call fsync(3), if the OS supports
834 it, to force the OS immediately to write the data to permanent
835 storage. This is optional for those who wish to avoid excessive
836 disk I/O.
837 mime (MIME)
839 MIME-related options (handlers of various MIME types).
840 mime.default_type <str> (default: "application/octet-stream")
842 Document MIME-type to assume by default (when we are unable to
843 guess it properly from known information about the document).
844 mime.extension (File extension associations)
846 Extension ↔ MIME type association.
847 mime.extension._template_ <str> (default: "")
849 MIME-type matching this file extension ('*' is used here in place
850 of '.').
851 mime.handler (File type handlers)
853 A file type handler is a set of information about how to use an
854 external program to view a file. It is possible to refer to it for
855 several MIME types — e.g., you can define an 'image' handler to which
856 mime.type.image.png, mime.type.image.jpeg, and so on will refer; or one
857 might define a handler for a more specific type of file — e.g., PDF
858 files. Note you must define both a MIME handler and a MIME type
859 association for it to work.
860 mime.handler._template_ (Template option folder)
862 Description of this handler.
863 mime.handler._template_._template_ (Template option folder)
865 System-specific handler description (ie. unix, unix-xwin, ...).
866 mime.handler._template_._template_.ask [0|1] (default: 1)
868 Ask before opening.
869 mime.handler._template_._template_.block [0|1] (default: 1)
871 Block the terminal when the handler is running.
872 mime.handler._template_._template_.program <str> (default: "")
874 External viewer for this file type. '%' in this string will be
875 substituted by a file name. Do not put single- or double-quotes
876 around the % sign.
877 mime.mailcap (Mailcap)
879 Options for mailcap support.
880 mime.mailcap.enable [0|1] (default: 1)
882 Enable mailcap support.
883 mime.mailcap.path <str> (default:
885 "~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap:/usr/share/mailcap:/usr/share/misc/mailcap")
886 Mailcap search path. Colon-separated list of files. Leave as "" to
887 use MAILCAP environment variable instead.
888 mime.mailcap.ask [0|1] (default: 1)
890 Ask before using the handlers defined by mailcap.
891 mime.mailcap.description <num> (default: 0)
893 Type of description to show in "what to do with this file" query
894 dialog:
895 · 0 is show "mailcap"
897 · 1 is show program to be run
899 · 2 is show mailcap description field if any; "mailcap" otherwise
901 mime.mailcap.prioritize [0|1] (default: 1)
903 Prioritize entries by the order of the files in the mailcap path.
904 This means that wildcard entries (like: image/*) will also be
905 checked before deciding the handler.
906 mime.mimetypes (Mimetypes files)
908 Options for the support of mime.types files. These files can be used to
909 find the content type of a URL by looking at the extension of the file
910 name.
911 mime.mimetypes.enable [0|1] (default: 1)
913 Enable mime.types support.
914 mime.mimetypes.path <str> (default:
916 "~/.mime.types:/etc/mime.types:/usr/etc/mime.types:/usr/local/etc/mime.types:/usr/share/mime.types:/usr/share/misc/mime.types")
917 The search path for mime.types files. Colon-separated list of
918 files.
919 mime.type (MIME type associations)
921 Handler ↔ MIME type association. The first sub-tree is the MIME class
922 while the second sub-tree is the MIME type (ie. image/gif handler will
923 reside at mime.type.image.gif). Each MIME type option should contain
924 (case-sensitive) name of the MIME handler (its properties are stored at
925 mime.handler.<name>).
926 mime.type._template_ (Template option folder)
928 Handler matching this MIME-type class ('*' is used here in place of
929 '.').
930 mime.type._template_._template_ <str> (default: "")
932 Handler matching this MIME-type name ('*' is used here in place of
933 '.').
934 protocol (Protocols)
936 Protocol specific options.
937 protocol.no_proxy <str> (default: "")
939 Comma separated list of domains for which the proxy (HTTP/FTP)
940 should be disabled. Optionally, a port can be specified for some
941 domains as well. If it's blank, NO_PROXY environment variable is
942 checked as well.
943 protocol.bittorrent (BitTorrent)
945 BitTorrent specific options.
946 protocol.bittorrent.piece_cache_size <num> (default: 1048576)
948 The maximum amount of memory used to hold recently downloaded
949 pieces.
950 Set to 0 to have unlimited size.
952 protocol.bittorrent.max_uploads <num> (default: 7)
954 The maximum number of uploads to allow at once.
955 protocol.bittorrent.min_uploads <num> (default: 2)
957 The minimum number of uploads which should at least be used for new
958 connections.
959 protocol.bittorrent.request_queue_size <num> (default: 5)
961 How many piece requests to continuously keep in queue. Pipelining
962 of requests is essential to saturate connections and get a good
963 connection performance and thus a faster download. However, a very
964 big queue size can lead to wasting bandwidth near the end of the
965 connection since remaining piece blocks will be requested from
966 multiple peers.
967 protocol.bittorrent.choke_interval <num> (default: 10)
969 The number of seconds between updating the connection state and
970 most importantly choke and unchoke peer connections. The choke
971 period should be big enough for newly unchoked connections to get
972 started but small enough to not allow freeriders too much room for
973 stealing bandwidth.
974 protocol.bittorrent.rarest_first_cutoff <num> (default: 4)
976 The number of pieces to obtain before switching piece selection
977 strategy from random to rarest first.
978 protocol.bittorrent.allow_blacklist [0|1] (default: 1)
980 Allow blacklisting of buggy peers.
981 protocol.bittorrent.ports (Port range)
983 Port range allowed to be used for listening on.
984 protocol.bittorrent.ports.min <num> (default: 6881)
986 The minimum port to try and listen on.
987 protocol.bittorrent.ports.max <num> (default: 6999)
989 The maximum port to try and listen on.
990 protocol.bittorrent.tracker (Tracker)
992 Tracker options.
993 protocol.bittorrent.tracker.compact [0|1] (default: 0)
995 Whether to request that the tracker returns peer info in compact
996 format. Note, the compact format only supports IPv4 addresses.
997 protocol.bittorrent.tracker.interval <num> (default: 0)
999 The number of seconds to wait between periodically contacting the
1000 tracker for announcing progress and requesting more peers. Set to
1001 zero to use the interval requested by the tracker.
1002 protocol.bittorrent.tracker.ip_address <str> (default: "")
1004 What IP address to report to the tracker. If set to "" no IP
1005 address will be sent and the tracker will automatically determine
1006 an appropriate IP address.
1007 protocol.bittorrent.tracker.key <str> (default: "")
1009 An additional identification that is not shared with any users. It
1010 is intended to allow a client to prove their identity should their
1011 IP address change. It is an optional parameter, but some trackers
1012 require this parameter. If set to "" no user key will be sent to
1013 the tracker.
1014 protocol.bittorrent.tracker.numwant <num> (default: 50)
1016 The maximum number of peers to request from the tracker. Set to 0
1017 to use the server default.
1018 protocol.bittorrent.tracker.min_skip_size <num> (default: 20)
1020 The minimum number of peers to have in the current peer info pool
1021 before skipping requesting of more peers. I.e. setting numwant to
1022 zero. Set to 0 to not have any limit.
1023 protocol.bittorrent.peerwire (Peer-wire)
1025 Lowlevel peer-wire options.
1026 protocol.bittorrent.peerwire.connections <num> (default: 55)
1028 The maximum number of allowed connections to both active and
1029 non-active peers. By increasing the number of allowed connections,
1030 the chance of finding good peers to download from is increased.
1031 However, too many connections can lead to TCP congestion. If the
1032 maximum is reached all new incoming connections will be closed.
1033 protocol.bittorrent.peerwire.max_message_length <num> (default:
1035 8388608)
1036 The maximum length of messages to accept over the wire. Larger
1037 values will cause the connection to be dropped.
1038 protocol.bittorrent.peerwire.max_request_length <num> (default:
1040 8388608)
1041 The maximum length to allow for incoming requests. Larger requests
1042 will cause the connection to be dropped.
1043 protocol.bittorrent.peerwire.request_length <num> (default: 16384)
1045 How many bytes to query for per request. This is complementary to
1046 the max_request_length option. If the configured length is bigger
1047 than the piece length it will be truncated.
1048 protocol.bittorrent.peerwire.timeout <num> (default: 300)
1050 The number of seconds to wait before closing a socket on which
1051 nothing has been received or sent.
1052 protocol.bittorrent.peerwire.pool_size <num> (default: 55)
1054 Maximum number of items in the peer pool. The peer pool contains
1055 information used for establishing connections to new peers.
1056 Set to 0 to have unlimited size.
1058 protocol.file (Local files)
1060 Options specific to local browsing.
1061 protocol.file.allow_special_files [0|1] (default: 0)
1063 Whether to allow reading from non-regular files. Note this can be
1064 dangerous; reading /dev/urandom or /dev/zero can ruin your day!
1065 protocol.file.show_hidden_files [0|1] (default: 1)
1067 When set to false, files with name starting with a dot will be
1068 hidden in local directory listings.
1069 protocol.file.try_encoding_extensions [0|1] (default: 1)
1071 When set, if we can't open a file named 'filename', we'll try to
1072 open 'filename' with some encoding extension appended (ie.
1073 'filename.gz'); it depends on the supported encodings.
1074 protocol.file.cgi (Local CGI)
1076 Local CGI specific options.
1077 protocol.file.cgi.path <str> (default: "")
1079 Colon separated list of directories, where CGI scripts are stored.
1080 protocol.file.cgi.policy [0|1] (default: 0)
1082 Whether to execute local CGI scripts.
1083 protocol.ftp (FTP)
1085 FTP specific options.
1086 protocol.ftp.anon_passwd <str> (default: "some@host.domain")
1088 FTP anonymous password to be sent.
1089 protocol.ftp.use_pasv [0|1] (default: 1)
1091 Use PASV instead of PORT (passive vs active mode, IPv4 only).
1092 protocol.ftp.use_epsv [0|1] (default: 0)
1094 Use EPSV instead of EPRT (passive vs active mode, IPv6 only).
1095 protocol.ftp.proxy (Proxy configuration)
1097 FTP proxy configuration.
1098 protocol.ftp.proxy.host <str> (default: "")
1100 Host and port-number (host:port) of the FTP proxy, or blank. If
1101 it's blank, FTP_PROXY environment variable is checked as well.
1102 protocol.http (HTTP)
1104 HTTP-specific options.
1105 protocol.http.accept_language <str> (default: "")
1107 Send Accept-Language header.
1108 protocol.http.accept_ui_language [0|1] (default: 1)
1110 Request localised versions of documents from web-servers (using the
1111 Accept-Language header) using the language you have configured for
1112 ELinks' user-interface (this also affects navigator.language
1113 ECMAScript value available to scripts). Note that some see this as
1114 a potential security risk because it tells web-masters and the FBI
1115 sniffers about your language preference.
1116 protocol.http.compression [0|1] (default: 0)
1118 If enabled, the capability to receive compressed content (gzip
1119 and/or bzip2) is announced to the server, which usually sends the
1120 reply compressed, thus saving some bandwidth at slight CPU expense.
1121 If ELinks displays a incomplete page or garbage, try disabling this
1123 option. If that helps, there may be a bug in the decompression part
1124 of ELinks. Please report such bugs.
1125 If ELinks has been compiled without compression support, this
1127 option has no effect. To check the supported features, see Help ->
1128 About.
1129 protocol.http.trace [0|1] (default: 0)
1131 If active, all HTTP requests are sent with TRACE as their method
1132 rather than GET or POST. This is useful for debugging of both
1133 ELinks and various server-side scripts — the server only returns
1134 the client's request back to the client verbatim. Note that this
1135 type of request may not be enabled on all servers.
1136 protocol.http.user_agent <str> (default: "ELinks/%v (textmode; %s;
1138 %t-%b)")
1139 Change the User Agent ID. That means identification string, which
1140 is sent to HTTP server when a document is requested. The 'textmode'
1141 token in the first field is our silent attempt to establish this as
1142 a standard for new textmode user agents, so that the webmasters can
1143 have just a single uniform test for these if they are e.g. pushing
1144 some lite version to them automagically.
1145 Use " " if you don't want any User-Agent header to be sent at all.
1147 · %v in the string means ELinks version,
1149 · %s in the string means system identification,
1151 · %t in the string means size of the terminal,
1153 · %b in the string means number of bars displayed by ELinks.
1155 protocol.http.bugs (Server bug workarounds)
1157 Server-side HTTP bugs workarounds.
1158 protocol.http.bugs.accept_charset [0|1] (default: 1)
1160 The Accept-Charset header is quite long and sending it can trigger
1161 bugs in some rarely found servers.
1162 protocol.http.bugs.allow_blacklist [0|1] (default: 1)
1164 Allow blacklisting of buggy servers.
1165 protocol.http.bugs.broken_302_redirect [0|1] (default: 1)
1167 Broken 302 redirect (violates RFC but compatible with Netscape).
1168 This is a problem for a lot of web discussion boards and the like.
1169 If they will do strange things to you, try to play with this.
1170 protocol.http.bugs.post_no_keepalive [0|1] (default: 0)
1172 Disable keepalive connection after POST request.
1173 protocol.http.bugs.http10 [0|1] (default: 0)
1175 Use HTTP/1.0 protocol instead of HTTP/1.1.
1176 protocol.http.proxy (Proxy configuration)
1178 HTTP proxy configuration.
1179 protocol.http.proxy.host <str> (default: "")
1181 Host and port-number (host:port) of the HTTP proxy, or blank. If
1182 it's blank, HTTP_PROXY environment variable is checked as well.
1183 protocol.http.proxy.user <str> (default: "")
1185 Proxy authentication username.
1186 protocol.http.proxy.passwd <str> (default: "")
1188 Proxy authentication password.
1189 protocol.http.referer (Referer sending)
1191 HTTP referer sending options. HTTP referer is a special header sent in
1192 the HTTP requests, which is supposed to contain the previous page
1193 visited by the browser.This way, the server can know what link did you
1194 follow when accessing that page. However, this behaviour can
1195 unfortunately considerably affect privacy and can lead even to a
1196 security problem on some badly designed web pages.
1197 protocol.http.referer.policy <num> (default: 3)
1199 Mode of sending HTTP referer:
1200 · 0 is send no referer
1202 · 1 is send current URL as referer
1204 · 2 is send fixed fake referer
1206 · 3 is send previous URL as referer (correct, but insecure)
1208 protocol.http.referer.fake <str> (default: "")
1210 Fake referer to be sent when policy is 2.
1211 protocol.https (HTTPS)
1213 HTTPS-specific options.
1214 protocol.https.proxy (Proxy configuration)
1216 HTTPS proxy configuration.
1217 protocol.https.proxy.host <str> (default: "")
1219 Host and port-number (host:port) of the HTTPS CONNECT proxy, or
1220 blank. If it's blank, HTTPS_PROXY environment variable is checked
1221 as well.
1222 protocol.nntp (NNTP)
1224 NNTP and news specific options.
1225 protocol.nntp.server <str> (default: "")
1227 Used when resolving news: URIs. If set to the empty string the
1228 value of the NNTPSERVER environment variable will be used.
1229 protocol.nntp.header_entries <str> (default:
1231 "Subject,From,Date,Message-ID,Newsgroups")
1232 Comma separated list of which entries in the article header to
1233 show. E.g. 'Subject' and 'From'. All header entries can be read in
1234 the header info dialog.
1235 protocol.rewrite (URI rewriting)
1237 Rules for rewriting URIs entered in the goto dialog. It makes it
1238 possible to define a set of prefixes that will be expanded if they
1239 match a string entered in the goto dialog. The prefixes can be dumb,
1240 meaning that they work only like URI abbreviations, or smart ones,
1241 making it possible to pass arguments to them like search engine
1242 keywords.
1243 protocol.rewrite.default_template <str> (default: "")
1245 Default URI template used when the string entered in the goto
1246 dialog does not appear to be a URI or a filename (i.e. contains no
1247 '.', ':' or '/' characters), and does not match any defined
1248 prefixes. Set the value to "" to disable use of the default
1249 template rewrite rule.
1250 · %c in the template means the current URL,
1252 · %s in the template means the whole string from the goto dialog,
1254 · %0,%1,...,%9 mean the 1st,2nd,...,10th space-delimited part of
1256 %s,
1257 · %% in the template means '%'.
1259 protocol.rewrite.enable-dumb [0|1] (default: 1)
1261 Enable dumb prefixes – simple URI abbreviations which can be
1262 written to the Goto URL dialog instead of actual URIs – i.e. if you
1263 write 'elinks' there, you are directed to http://elinks.cz/.
1264 protocol.rewrite.enable-smart [0|1] (default: 1)
1266 Enable smart prefixes – URI templates triggered by writing given
1267 abbreviation to the Goto URL dialog followed by a list of arguments
1268 from which the actual URI is composed – i.e. 'gg:search keywords'
1269 or 'gn search keywords for news'.
1270 protocol.rewrite.dumb (Dumb Prefixes)
1272 Dumb prefixes, see enable-dumb description for details.
1273 protocol.rewrite.dumb._template_ <str> (default: "")
1275 Replacement URI for this dumbprefix:
1276 · %c in the string means the current URL
1278 · %% in the string means '%'
1280 protocol.rewrite.smart (Smart Prefixes)
1282 Smart prefixes, see enable-smart description for details.
1283 protocol.rewrite.smart._template_ <str> (default: "")
1285 Replacement URI for this smartprefix:
1286 · %c in the string means the current URL
1288 · %s in the string means the whole argument to smartprefix
1290 · %0,%1,...,%9 means argument 0, 1, ..., 9
1292 · %% in the string means '%'
1294 protocol.user (User protocols)
1296 User protocols. Options in this tree specify external handlers for the
1297 appropriate protocols. Ie. protocol.user.mailto.unix.
1298 protocol.user._template_ (Template option folder)
1300 Handler (external program) for this protocol. Name the options in this
1301 tree after your system (ie. unix, unix-xwin).
1302 protocol.user._template_._template_ <str> (default: "")
1304 Handler (external program) for this protocol and system.
1305 · %f in the string means file name to include form data from
1307 · %h in the string means hostname (or email address)
1309 · %p in the string means port
1311 · %d in the string means path (everything after the port)
1313 · %s in the string means subject (?subject=<this>)
1315 · %u in the string means the whole URL
1317 terminal (Terminals)
1319 Terminal options.
1320 terminal._template_ (Template option folder)
1322 Options specific to this terminal type (according to $TERM value).
1323 terminal._template_.type <num> (default: 0)
1325 Terminal type; matters mostly only when drawing frames and dialog
1326 box borders:
1327 · 0 is dumb terminal type, ASCII art
1329 · 1 is VT100, simple but portable
1331 · 2 is Linux, you get double frames and other goodies
1333 · 3 is KOI-8
1335 · 4 is FreeBSD
1337 terminal._template_.latin1_title [0|1] (default: 1)
1339 When updating the window title of xterm or a similar terminal
1340 emulator, encode the title in ISO-8859-1 (Latin-1), rather than in
1341 the charset used for other text in the window. Cyrillic and other
1342 characters get replaced with Latin ones. Xterm requires this unless
1343 you explicitly enable UTF-8 titles in it.
1344 If this option does not take effect immediately, try switching to a
1346 different page so that ELinks notices it needs to update the title.
1347 terminal._template_.m11_hack [0|1] (default: 0)
1349 Switch fonts when drawing lines, enabling both local characters and
1350 lines working at the same time. ELinks uses this option only if
1351 UTF-8 I/O is disabled and the terminal type is Linux or FreeBSD.
1352 terminal._template_.utf_8_io [0|1] (default: 0)
1354 Enable I/O in UTF-8 for Unicode terminals. Note that currently,
1355 only the subset of UTF-8 according to terminal codepage is used.
1356 ELinks ignores this option if the terminal codepage is UTF-8.
1357 terminal._template_.restrict_852 [0|1] (default: 0)
1359 Restrict the characters used when drawing lines. Makes sense only
1360 with linux terminals using the cp850/852 character sets.
1361 terminal._template_.block_cursor [0|1] (default: 0)
1363 Move cursor to bottom right corner when done drawing. This is
1364 particularly useful when we have a block cursor, so that inversed
1365 text is displayed correctly.
1366 terminal._template_.colors <num> (default: 0)
1368 The color mode controls what colors are used and how they are
1369 output to the terminal.
1370 Some modes may have been disabled at compile time. The Setup ->
1372 Terminal options dialog lists the modes supported by this
1373 executable. If you select an unsupported mode, ELinks uses 16
1374 colors.
1375 The color modes are:
1377 · 0 is mono mode, only 2 colors are used
1379 · 1 is 16 color mode, uses the common ANSI colors
1381 · 2 is 88 color mode, uses XTerm RGB codes
1383 · 3 is 256 color mode, uses XTerm RGB codes
1385 · 4 is true color mode, uses konsole RGB codes
1387 terminal._template_.transparency [0|1] (default: 0)
1389 If we should not set the background to black. This is particularly
1390 useful when we have a terminal (typically in some windowing
1391 environment) with a background image or a transparent background –
1392 it will be visible in ELinks as well (but ELinks document color
1393 handling will still assume the background is black so if you have a
1394 bright background you might experience contrast problems). Note
1395 that this option makes sense only when colors are enabled.
1396 terminal._template_.underline [0|1] (default: 0)
1398 If we should use underline or enhance the color instead.
1399 terminal._template_.charset <codepage> (default: System)
1401 Codepage of charset used for displaying content on terminal.
1402 'System' stands for a codepage determined by a selected locale.
1403 ui (User interface)
1405 User interface options.
1406 ui.date_format <str> (default: "%b %e %H:%M")
1408 Date format to use in dialogs. See strftime(3).
1409 ui.language <language> (default: "System")
1411 Language of user interface. 'System' means that the language will
1412 be extracted from the environment dynamically.
1413 ui.show_menu_bar_always [0|1] (default: 0)
1415 Always show menu bar on the screen.
1416 ui.show_status_bar [0|1] (default: 1)
1418 Show status bar on the screen.
1419 ui.show_title_bar [0|1] (default: 1)
1421 Show title bar on the screen.
1422 ui.startup_goto_dialog [0|1] (default: 1)
1424 Pop up goto dialog in newly created tabs when there's no homepage
1425 set. This means also showing goto dialog on startup.
1426 ui.success_msgbox [0|1] (default: 1)
1428 When you pressed a Save button in some manager, this option will
1429 make sure that a box confirming success of the operation will pop
1430 up.
1431 ui.window_title [0|1] (default: 1)
1433 Set the window title when running in a windowing environment in an
1434 xterm-like terminal. This way the document's title is shown on the
1435 window titlebar.
1436 ui.clock (Clock)
1438 Digital clock in the status bar.
1439 ui.clock.enable [0|1] (default: 0)
1441 Whether to display a digital clock in the status bar.
1442 ui.clock.format <str> (default: "[%H:%M]")
1444 Format string for the digital clock. See the strftime(3) manpage
1445 for details.
1446 ui.colors (Color settings)
1448 Default user interface color settings.
1449 ui.colors.color (Color terminals)
1451 Color settings for color terminal.
1452 ui.colors.color.mainmenu (Main menu bar)
1454 Main menu bar colors.
1455 ui.colors.color.mainmenu.normal (Unselected main menu bar item)
1457 Unselected main menu bar item colors.
1458 ui.colors.color.mainmenu.normal.text <color|#rrggbb> (default: black)
1460 Default text color.
1461 ui.colors.color.mainmenu.normal.background <color|#rrggbb> (default:
1463 white)
1464 Default background color.
1465 ui.colors.color.mainmenu.selected (Selected main menu bar item)
1467 Selected main menu bar item colors.
1468 ui.colors.color.mainmenu.selected.text <color|#rrggbb> (default: green)
1470 Default text color.
1471 ui.colors.color.mainmenu.selected.background <color|#rrggbb> (default:
1473 black)
1474 Default background color.
1475 ui.colors.color.mainmenu.hotkey (Hotkey)
1477 Main menu hotkey colors.
1478 ui.colors.color.mainmenu.hotkey.normal (Unselected hotkey)
1480 Main menu unselected hotkey colors.
1481 ui.colors.color.mainmenu.hotkey.normal.text <color|#rrggbb> (default:
1483 darkred)
1484 Default text color.
1485 ui.colors.color.mainmenu.hotkey.normal.background <color|#rrggbb>
1487 (default: white)
1488 Default background color.
1489 ui.colors.color.mainmenu.hotkey.selected (Selected hotkey)
1491 Main menu selected hotkey colors.
1492 ui.colors.color.mainmenu.hotkey.selected.text <color|#rrggbb> (default:
1494 darkred)
1495 Default text color.
1496 ui.colors.color.mainmenu.hotkey.selected.background <color|#rrggbb>
1498 (default: green)
1499 Default background color.
1500 ui.colors.color.menu (Menu bar)
1502 Menu bar colors.
1503 ui.colors.color.menu.normal (Unselected menu item)
1505 Unselected menu item colors.
1506 ui.colors.color.menu.normal.text <color|#rrggbb> (default: black)
1508 Default text color.
1509 ui.colors.color.menu.normal.background <color|#rrggbb> (default: white)
1511 Default background color.
1512 ui.colors.color.menu.selected (Selected menu item)
1514 Selected menu item colors.
1515 ui.colors.color.menu.selected.text <color|#rrggbb> (default: black)
1517 Default text color.
1518 ui.colors.color.menu.selected.background <color|#rrggbb> (default:
1520 green)
1521 Default background color.
1522 ui.colors.color.menu.marked (Marked menu item)
1524 Marked menu item colors.
1525 ui.colors.color.menu.marked.text <color|#rrggbb> (default: red)
1527 Default text color.
1528 ui.colors.color.menu.marked.background <color|#rrggbb> (default: white)
1530 Default background color.
1531 ui.colors.color.menu.hotkey (Hotkey)
1533 Menu item hotkey colors.
1534 ui.colors.color.menu.hotkey.normal (Unselected hotkey)
1536 Menu item unselected hotkey colors.
1537 ui.colors.color.menu.hotkey.normal.text <color|#rrggbb> (default:
1539 darkred)
1540 Default text color.
1541 ui.colors.color.menu.hotkey.normal.background <color|#rrggbb> (default:
1543 white)
1544 Default background color.
1545 ui.colors.color.menu.hotkey.selected (Selected hotkey)
1547 Menu item selected hotkey colors.
1548 ui.colors.color.menu.hotkey.selected.text <color|#rrggbb> (default:
1550 darkred)
1551 Default text color.
1552 ui.colors.color.menu.hotkey.selected.background <color|#rrggbb>
1554 (default: green)
1555 Default background color.
1556 ui.colors.color.menu.frame (Menu frame)
1558 Menu frame colors.
1559 ui.colors.color.menu.frame.text <color|#rrggbb> (default: black)
1561 Default text color.
1562 ui.colors.color.menu.frame.background <color|#rrggbb> (default: white)
1564 Default background color.
1565 ui.colors.color.dialog (Dialog)
1567 Dialog colors.
1568 ui.colors.color.dialog.generic (Generic)
1570 Generic dialog colors.
1571 ui.colors.color.dialog.generic.text <color|#rrggbb> (default: black)
1573 Default text color.
1574 ui.colors.color.dialog.generic.background <color|#rrggbb> (default:
1576 white)
1577 Default background color.
1578 ui.colors.color.dialog.frame (Frame)
1580 Dialog frame colors.
1581 ui.colors.color.dialog.frame.text <color|#rrggbb> (default: black)
1583 Default text color.
1584 ui.colors.color.dialog.frame.background <color|#rrggbb> (default:
1586 white)
1587 Default background color.
1588 ui.colors.color.dialog.scrollbar (Scrollbar)
1590 Scrollbar colors.
1591 ui.colors.color.dialog.scrollbar.text <color|#rrggbb> (default: black)
1593 Default text color.
1594 ui.colors.color.dialog.scrollbar.background <color|#rrggbb> (default:
1596 blue)
1597 Default background color.
1598 ui.colors.color.dialog.scrollbar-selected (Selected scrollbar)
1600 Scrollbar selected colors.
1601 ui.colors.color.dialog.scrollbar-selected.text <color|#rrggbb>
1603 (default: black)
1604 Default text color.
1605 ui.colors.color.dialog.scrollbar-selected.background <color|#rrggbb>
1607 (default: green)
1608 Default background color.
1609 ui.colors.color.dialog.title (Title)
1611 Dialog title colors.
1612 ui.colors.color.dialog.title.text <color|#rrggbb> (default: darkred)
1614 Default text color.
1615 ui.colors.color.dialog.title.background <color|#rrggbb> (default:
1617 white)
1618 Default background color.
1619 ui.colors.color.dialog.text (Text)
1621 Dialog text colors.
1622 ui.colors.color.dialog.text.text <color|#rrggbb> (default: black)
1624 Default text color.
1625 ui.colors.color.dialog.text.background <color|#rrggbb> (default: white)
1627 Default background color.
1628 ui.colors.color.dialog.checkbox (Checkbox)
1630 Dialog checkbox colors.
1631 ui.colors.color.dialog.checkbox.text <color|#rrggbb> (default: darkred)
1633 Default text color.
1634 ui.colors.color.dialog.checkbox.background <color|#rrggbb> (default:
1636 white)
1637 Default background color.
1638 ui.colors.color.dialog.checkbox-selected (Selected checkbox)
1640 Dialog selected checkbox colors.
1641 ui.colors.color.dialog.checkbox-selected.text <color|#rrggbb> (default:
1643 yellow)
1644 Default text color.
1645 ui.colors.color.dialog.checkbox-selected.background <color|#rrggbb>
1647 (default: green)
1648 Default background color.
1649 ui.colors.color.dialog.checkbox-label (Checkbox label)
1651 Dialog checkbox label colors.
1652 ui.colors.color.dialog.checkbox-label.text <color|#rrggbb> (default:
1654 black)
1655 Default text color.
1656 ui.colors.color.dialog.checkbox-label.background <color|#rrggbb>
1658 (default: white)
1659 Default background color.
1660 ui.colors.color.dialog.button (Button)
1662 Dialog button colors.
1663 ui.colors.color.dialog.button.text <color|#rrggbb> (default: white)
1665 Default text color.
1666 ui.colors.color.dialog.button.background <color|#rrggbb> (default:
1668 blue)
1669 Default background color.
1670 ui.colors.color.dialog.button-selected (Selected button)
1672 Dialog selected button colors.
1673 ui.colors.color.dialog.button-selected.text <color|#rrggbb> (default:
1675 yellow)
1676 Default text color.
1677 ui.colors.color.dialog.button-selected.background <color|#rrggbb>
1679 (default: green)
1680 Default background color.
1681 ui.colors.color.dialog.button-shortcut (Button shortcut)
1683 Dialog button colors.
1684 ui.colors.color.dialog.button-shortcut.text <color|#rrggbb> (default:
1686 yellow)
1687 Default text color.
1688 ui.colors.color.dialog.button-shortcut.background <color|#rrggbb>
1690 (default: blue)
1691 Default background color.
1692 ui.colors.color.dialog.button-shortcut-selected (Selected button shortcut)
1694 Dialog selected button colors.
1695 ui.colors.color.dialog.button-shortcut-selected.text <color|#rrggbb>
1697 (default: white)
1698 Default text color.
1699 ui.colors.color.dialog.button-shortcut-selected.background
1701 <color|#rrggbb> (default: blue)
1702 Default background color.
1703 ui.colors.color.dialog.field (Text field)
1705 Dialog text field colors.
1706 ui.colors.color.dialog.field.text <color|#rrggbb> (default: white)
1708 Default text color.
1709 ui.colors.color.dialog.field.background <color|#rrggbb> (default: blue)
1711 Default background color.
1712 ui.colors.color.dialog.field-text (Text field text)
1714 Dialog field text colors.
1715 ui.colors.color.dialog.field-text.text <color|#rrggbb> (default:
1717 yellow)
1718 Default text color.
1719 ui.colors.color.dialog.field-text.background <color|#rrggbb> (default:
1721 blue)
1722 Default background color.
1723 ui.colors.color.dialog.meter (Meter)
1725 Dialog meter colors.
1726 ui.colors.color.dialog.meter.text <color|#rrggbb> (default: white)
1728 Default text color.
1729 ui.colors.color.dialog.meter.background <color|#rrggbb> (default: blue)
1731 Default background color.
1732 ui.colors.color.dialog.shadow (Shadow)
1734 Dialog shadow colors (see ui.shadows option).
1735 ui.colors.color.dialog.shadow.text <color|#rrggbb> (default: black)
1737 Default text color.
1738 ui.colors.color.dialog.shadow.background <color|#rrggbb> (default:
1740 black)
1741 Default background color.
1742 ui.colors.color.title (Title bar)
1744 Title bar colors.
1745 ui.colors.color.title.title-bar (Generic title bar)
1747 Generic title bar colors.
1748 ui.colors.color.title.title-bar.text <color|#rrggbb> (default: black)
1750 Default text color.
1751 ui.colors.color.title.title-bar.background <color|#rrggbb> (default:
1753 white)
1754 Default background color.
1755 ui.colors.color.title.title-text (Title bar text)
1757 Title bar text colors.
1758 ui.colors.color.title.title-text.text <color|#rrggbb> (default: black)
1760 Default text color.
1761 ui.colors.color.title.title-text.background <color|#rrggbb> (default:
1763 white)
1764 Default background color.
1765 ui.colors.color.status (Status bar)
1767 Status bar colors.
1768 ui.colors.color.status.status-bar (Generic status bar)
1770 Generic status bar colors.
1771 ui.colors.color.status.status-bar.text <color|#rrggbb> (default: black)
1773 Default text color.
1774 ui.colors.color.status.status-bar.background <color|#rrggbb> (default:
1776 white)
1777 Default background color.
1778 ui.colors.color.status.status-text (Status bar text)
1780 Status bar text colors.
1781 ui.colors.color.status.status-text.text <color|#rrggbb> (default:
1783 black)
1784 Default text color.
1785 ui.colors.color.status.status-text.background <color|#rrggbb> (default:
1787 white)
1788 Default background color.
1789 ui.colors.color.tabs (Tabs bar)
1791 Tabs bar colors.
1792 ui.colors.color.tabs.unvisited (Unvisited tab)
1794 Tab colors for tabs that have not been selected since they completed
1795 loading.
1796 ui.colors.color.tabs.unvisited.text <color|#rrggbb> (default: darkblue)
1798 Default text color.
1799 ui.colors.color.tabs.unvisited.background <color|#rrggbb> (default:
1801 white)
1802 Default background color.
1803 ui.colors.color.tabs.normal (Unselected tab)
1805 Unselected tab colors.
1806 ui.colors.color.tabs.normal.text <color|#rrggbb> (default: black)
1808 Default text color.
1809 ui.colors.color.tabs.normal.background <color|#rrggbb> (default: white)
1811 Default background color.
1812 ui.colors.color.tabs.loading (Loading tab)
1814 Tab colors for tabs that are loading in the background.
1815 ui.colors.color.tabs.loading.text <color|#rrggbb> (default: darkred)
1817 Default text color.
1818 ui.colors.color.tabs.loading.background <color|#rrggbb> (default:
1820 white)
1821 Default background color.
1822 ui.colors.color.tabs.selected (Selected tab)
1824 Selected tab colors.
1825 ui.colors.color.tabs.selected.text <color|#rrggbb> (default: black)
1827 Default text color.
1828 ui.colors.color.tabs.selected.background <color|#rrggbb> (default:
1830 green)
1831 Default background color.
1832 ui.colors.color.tabs.separator (Tab separator)
1834 Tab separator colors.
1835 ui.colors.color.tabs.separator.text <color|#rrggbb> (default: brown)
1837 Default text color.
1838 ui.colors.color.tabs.separator.background <color|#rrggbb> (default:
1840 white)
1841 Default background color.
1842 ui.colors.color.searched (Searched strings)
1844 Searched string highlight colors.
1845 ui.colors.color.searched.text <color|#rrggbb> (default: black)
1847 Default text color.
1848 ui.colors.color.searched.background <color|#rrggbb> (default: lime)
1850 Default background color.
1851 ui.colors.mono (Non-color terminals)
1853 Color settings for non-color terminal.
1854 ui.colors.mono.mainmenu (Main menu bar)
1856 Main menu bar colors.
1857 ui.colors.mono.mainmenu.normal (Unselected main menu bar item)
1859 Unselected main menu bar item colors.
1860 ui.colors.mono.mainmenu.normal.text <color|#rrggbb> (default: black)
1862 Default text color.
1863 ui.colors.mono.mainmenu.normal.background <color|#rrggbb> (default:
1865 white)
1866 Default background color.
1867 ui.colors.mono.mainmenu.selected (Selected main menu bar item)
1869 Selected main menu bar item colors.
1870 ui.colors.mono.mainmenu.selected.text <color|#rrggbb> (default: gray)
1872 Default text color.
1873 ui.colors.mono.mainmenu.selected.background <color|#rrggbb> (default:
1875 black)
1876 Default background color.
1877 ui.colors.mono.mainmenu.hotkey (Hotkey)
1879 Main menu hotkey colors.
1880 ui.colors.mono.mainmenu.hotkey.normal (Unselected hotkey)
1882 Main menu unselected hotkey colors.
1883 ui.colors.mono.mainmenu.hotkey.normal.text <color|#rrggbb> (default:
1885 black)
1886 Default text color.
1887 ui.colors.mono.mainmenu.hotkey.normal.background <color|#rrggbb>
1889 (default: white)
1890 Default background color.
1891 ui.colors.mono.mainmenu.hotkey.selected (Selected hotkey)
1893 Main menu selected hotkey colors.
1894 ui.colors.mono.mainmenu.hotkey.selected.text <color|#rrggbb> (default:
1896 black)
1897 Default text color.
1898 ui.colors.mono.mainmenu.hotkey.selected.background <color|#rrggbb>
1900 (default: white)
1901 Default background color.
1902 ui.colors.mono.menu (Menu bar)
1904 Menu bar colors.
1905 ui.colors.mono.menu.normal (Unselected menu item)
1907 Unselected menu item colors.
1908 ui.colors.mono.menu.normal.text <color|#rrggbb> (default: black)
1910 Default text color.
1911 ui.colors.mono.menu.normal.background <color|#rrggbb> (default: white)
1913 Default background color.
1914 ui.colors.mono.menu.selected (Selected menu item)
1916 Selected menu item colors.
1917 ui.colors.mono.menu.selected.text <color|#rrggbb> (default: gray)
1919 Default text color.
1920 ui.colors.mono.menu.selected.background <color|#rrggbb> (default:
1922 black)
1923 Default background color.
1924 ui.colors.mono.menu.marked (Marked menu item)
1926 Marked menu item colors.
1927 ui.colors.mono.menu.marked.text <color|#rrggbb> (default: gray)
1929 Default text color.
1930 ui.colors.mono.menu.marked.background <color|#rrggbb> (default: white)
1932 Default background color.
1933 ui.colors.mono.menu.hotkey (Hotkey)
1935 Menu item hotkey colors.
1936 ui.colors.mono.menu.hotkey.normal (Unselected hotkey)
1938 Menu item unselected hotkey colors.
1939 ui.colors.mono.menu.hotkey.normal.text <color|#rrggbb> (default: gray)
1941 Default text color.
1942 ui.colors.mono.menu.hotkey.normal.background <color|#rrggbb> (default:
1944 black)
1945 Default background color.
1946 ui.colors.mono.menu.hotkey.selected (Selected hotkey)
1948 Menu item selected hotkey colors.
1949 ui.colors.mono.menu.hotkey.selected.text <color|#rrggbb> (default:
1951 gray)
1952 Default text color.
1953 ui.colors.mono.menu.hotkey.selected.background <color|#rrggbb>
1955 (default: black)
1956 Default background color.
1957 ui.colors.mono.menu.frame (Menu frame)
1959 Menu frame colors.
1960 ui.colors.mono.menu.frame.text <color|#rrggbb> (default: black)
1962 Default text color.
1963 ui.colors.mono.menu.frame.background <color|#rrggbb> (default: white)
1965 Default background color.
1966 ui.colors.mono.dialog (Dialog)
1968 Dialog colors.
1969 ui.colors.mono.dialog.generic (Generic)
1971 Generic dialog colors.
1972 ui.colors.mono.dialog.generic.text <color|#rrggbb> (default: black)
1974 Default text color.
1975 ui.colors.mono.dialog.generic.background <color|#rrggbb> (default:
1977 white)
1978 Default background color.
1979 ui.colors.mono.dialog.frame (Frame)
1981 Dialog frame colors.
1982 ui.colors.mono.dialog.frame.text <color|#rrggbb> (default: black)
1984 Default text color.
1985 ui.colors.mono.dialog.frame.background <color|#rrggbb> (default: white)
1987 Default background color.
1988 ui.colors.mono.dialog.scrollbar (Scrollbar)
1990 Scrollbar colors.
1991 ui.colors.mono.dialog.scrollbar.text <color|#rrggbb> (default: white)
1993 Default text color.
1994 ui.colors.mono.dialog.scrollbar.background <color|#rrggbb> (default:
1996 black)
1997 Default background color.
1998 ui.colors.mono.dialog.scrollbar-selected (Selected scrollbar)
2000 Scrollbar selected colors.
2001 ui.colors.mono.dialog.scrollbar-selected.text <color|#rrggbb> (default:
2003 black)
2004 Default text color.
2005 ui.colors.mono.dialog.scrollbar-selected.background <color|#rrggbb>
2007 (default: white)
2008 Default background color.
2009 ui.colors.mono.dialog.title (Title)
2011 Dialog title colors.
2012 ui.colors.mono.dialog.title.text <color|#rrggbb> (default: gray)
2014 Default text color.
2015 ui.colors.mono.dialog.title.background <color|#rrggbb> (default: black)
2017 Default background color.
2018 ui.colors.mono.dialog.text (Text)
2020 Dialog text colors.
2021 ui.colors.mono.dialog.text.text <color|#rrggbb> (default: black)
2023 Default text color.
2024 ui.colors.mono.dialog.text.background <color|#rrggbb> (default: white)
2026 Default background color.
2027 ui.colors.mono.dialog.checkbox (Checkbox)
2029 Dialog checkbox colors.
2030 ui.colors.mono.dialog.checkbox.text <color|#rrggbb> (default: black)
2032 Default text color.
2033 ui.colors.mono.dialog.checkbox.background <color|#rrggbb> (default:
2035 white)
2036 Default background color.
2037 ui.colors.mono.dialog.checkbox-selected (Selected checkbox)
2039 Dialog selected checkbox colors.
2040 ui.colors.mono.dialog.checkbox-selected.text <color|#rrggbb> (default:
2042 white)
2043 Default text color.
2044 ui.colors.mono.dialog.checkbox-selected.background <color|#rrggbb>
2046 (default: black)
2047 Default background color.
2048 ui.colors.mono.dialog.checkbox-label (Checkbox label)
2050 Dialog checkbox label colors.
2051 ui.colors.mono.dialog.checkbox-label.text <color|#rrggbb> (default:
2053 black)
2054 Default text color.
2055 ui.colors.mono.dialog.checkbox-label.background <color|#rrggbb>
2057 (default: white)
2058 Default background color.
2059 ui.colors.mono.dialog.button (Button)
2061 Dialog button colors.
2062 ui.colors.mono.dialog.button.text <color|#rrggbb> (default: black)
2064 Default text color.
2065 ui.colors.mono.dialog.button.background <color|#rrggbb> (default:
2067 white)
2068 Default background color.
2069 ui.colors.mono.dialog.button-selected (Selected button)
2071 Dialog selected button colors.
2072 ui.colors.mono.dialog.button-selected.text <color|#rrggbb> (default:
2074 white)
2075 Default text color.
2076 ui.colors.mono.dialog.button-selected.background <color|#rrggbb>
2078 (default: black)
2079 Default background color.
2080 ui.colors.mono.dialog.button-shortcut (Button shortcut)
2082 Dialog button colors.
2083 ui.colors.mono.dialog.button-shortcut.text <color|#rrggbb> (default:
2085 white)
2086 Default text color.
2087 ui.colors.mono.dialog.button-shortcut.background <color|#rrggbb>
2089 (default: black)
2090 Default background color.
2091 ui.colors.mono.dialog.button-shortcut-selected (Selected button shortcut)
2093 Dialog selected button colors.
2094 ui.colors.mono.dialog.button-shortcut-selected.text <color|#rrggbb>
2096 (default: black)
2097 Default text color.
2098 ui.colors.mono.dialog.button-shortcut-selected.background
2100 <color|#rrggbb> (default: white)
2101 Default background color.
2102 ui.colors.mono.dialog.field (Text field)
2104 Dialog text field colors.
2105 ui.colors.mono.dialog.field.text <color|#rrggbb> (default: gray)
2107 Default text color.
2108 ui.colors.mono.dialog.field.background <color|#rrggbb> (default: black)
2110 Default background color.
2111 ui.colors.mono.dialog.field-text (Text field text)
2113 Dialog field text colors.
2114 ui.colors.mono.dialog.field-text.text <color|#rrggbb> (default: gray)
2116 Default text color.
2117 ui.colors.mono.dialog.field-text.background <color|#rrggbb> (default:
2119 black)
2120 Default background color.
2121 ui.colors.mono.dialog.meter (Meter)
2123 Dialog meter colors.
2124 ui.colors.mono.dialog.meter.text <color|#rrggbb> (default: gray)
2126 Default text color.
2127 ui.colors.mono.dialog.meter.background <color|#rrggbb> (default: black)
2129 Default background color.
2130 ui.colors.mono.dialog.shadow (Shadow)
2132 Dialog shadow colors (see ui.shadows option).
2133 ui.colors.mono.dialog.shadow.text <color|#rrggbb> (default: black)
2135 Default text color.
2136 ui.colors.mono.dialog.shadow.background <color|#rrggbb> (default:
2138 black)
2139 Default background color.
2140 ui.colors.mono.title (Title bar)
2142 Title bar colors.
2143 ui.colors.mono.title.title-bar (Generic title bar)
2145 Generic title bar colors.
2146 ui.colors.mono.title.title-bar.text <color|#rrggbb> (default: gray)
2148 Default text color.
2149 ui.colors.mono.title.title-bar.background <color|#rrggbb> (default:
2151 black)
2152 Default background color.
2153 ui.colors.mono.title.title-text (Title bar text)
2155 Title bar text colors.
2156 ui.colors.mono.title.title-text.text <color|#rrggbb> (default: gray)
2158 Default text color.
2159 ui.colors.mono.title.title-text.background <color|#rrggbb> (default:
2161 black)
2162 Default background color.
2163 ui.colors.mono.status (Status bar)
2165 Status bar colors.
2166 ui.colors.mono.status.status-bar (Generic status bar)
2168 Generic status bar colors.
2169 ui.colors.mono.status.status-bar.text <color|#rrggbb> (default: black)
2171 Default text color.
2172 ui.colors.mono.status.status-bar.background <color|#rrggbb> (default:
2174 white)
2175 Default background color.
2176 ui.colors.mono.status.status-text (Status bar text)
2178 Status bar text colors.
2179 ui.colors.mono.status.status-text.text <color|#rrggbb> (default: black)
2181 Default text color.
2182 ui.colors.mono.status.status-text.background <color|#rrggbb> (default:
2184 white)
2185 Default background color.
2186 ui.colors.mono.tabs (Tabs bar)
2188 Tabs bar colors.
2189 ui.colors.mono.tabs.unvisited (Unvisited tab)
2191 Tab colors for tabs that have not been selected since they completed
2192 loading.
2193 ui.colors.mono.tabs.unvisited.text <color|#rrggbb> (default: gray)
2195 Default text color.
2196 ui.colors.mono.tabs.unvisited.background <color|#rrggbb> (default:
2198 white)
2199 Default background color.
2200 ui.colors.mono.tabs.normal (Unselected tab)
2202 Unselected tab colors.
2203 ui.colors.mono.tabs.normal.text <color|#rrggbb> (default: black)
2205 Default text color.
2206 ui.colors.mono.tabs.normal.background <color|#rrggbb> (default: white)
2208 Default background color.
2209 ui.colors.mono.tabs.loading (Loading tab)
2211 Tab colors for tabs that are loading in the background.
2212 ui.colors.mono.tabs.loading.text <color|#rrggbb> (default: gray)
2214 Default text color.
2215 ui.colors.mono.tabs.loading.background <color|#rrggbb> (default: white)
2217 Default background color.
2218 ui.colors.mono.tabs.selected (Selected tab)
2220 Selected tab colors.
2221 ui.colors.mono.tabs.selected.text <color|#rrggbb> (default: gray)
2223 Default text color.
2224 ui.colors.mono.tabs.selected.background <color|#rrggbb> (default:
2226 black)
2227 Default background color.
2228 ui.colors.mono.tabs.separator (Tab separator)
2230 Tab separator colors.
2231 ui.colors.mono.tabs.separator.text <color|#rrggbb> (default: gray)
2233 Default text color.
2234 ui.colors.mono.tabs.separator.background <color|#rrggbb> (default:
2236 white)
2237 Default background color.
2238 ui.colors.mono.searched (Searched strings)
2240 Searched string highlight colors.
2241 ui.colors.mono.searched.text <color|#rrggbb> (default: black)
2243 Default text color.
2244 ui.colors.mono.searched.background <color|#rrggbb> (default: white)
2246 Default background color.
2247 ui.dialogs (Dialog settings)
2249 Dialogs-specific appearance and behaviour settings.
2250 ui.dialogs.listbox_min_height <num> (default: 10)
2252 Minimal height of the listbox widget (used e.g. for bookmarks or
2253 global history).
2254 ui.dialogs.shadows [0|1] (default: 0)
2256 Make dialogs drop shadows (the shadows are solid, you can adjust
2257 their color by ui.colors.*.dialog.shadow). You may also want to
2258 eliminate the wide borders by adjusting setup.h.
2259 ui.dialogs.underline_hotkeys [0|1] (default: 0)
2261 Whether to underline hotkeys in menus to make them more visible.
2262 Requires that underlining is enabled for the terminal.
2263 ui.dialogs.underline_button_shortcuts [0|1] (default: 0)
2265 Whether to underline button shortcuts to make them more visible.
2266 Requires that underlining is enabled for the terminal.
2267 ui.leds (LEDs)
2269 LEDs (visual indicators) options.
2270 ui.leds.enable [0|1] (default: 1)
2272 Enable LEDs. These visual indicators will inform you about various
2273 states.
2274 ui.sessions (Sessions)
2276 Sessions settings.
2277 ui.sessions.auto_restore [0|1] (default: 0)
2279 Automatically restore the session at start.
2280 This feature requires bookmark support.
2282 ui.sessions.auto_save [0|1] (default: 0)
2284 Automatically save the session when quitting.
2285 This feature requires bookmark support.
2287 ui.sessions.auto_save_foldername <str> (default: "Auto saved session")
2289 Name of the bookmarks folder used for auto saving and restoring
2290 session. The name has to be unique. Any folders with the same name
2291 will be deleted.
2292 This only makes sense with bookmark support.
2294 ui.sessions.homepage <str> (default: "")
2296 The URI to load either at startup time when no URI was given on the
2297 command line or when requested by the goto-url-home action. Set to
2298 "" if the environment variable WWW_HOME should be used as homepage
2299 URI instead.
2300 ui.sessions.keep_session_active [0|1] (default: 0)
2302 Keep the session active even if the last terminal exits.
2303 ui.sessions.snapshot [0|1] (default: 0)
2305 Automatically save a snapshot of all tabs periodically. This will
2306 periodically bookmark the tabs of each terminal in a separate
2307 folder for recovery after a crash.
2308 This feature requires bookmark support.
2310 ui.tabs (Window tabs)
2312 Window tabs settings.
2313 ui.tabs.show_bar <num> (default: 1)
2315 Show tabs bar on the screen:
2316 · 0 means never
2318 · 1 means only if two or more tabs are open
2320 · 2 means always
2322 ui.tabs.top [0|1] (default: 0)
2324 Whether display tab bar at top like other browsers do.
2325 ui.tabs.wraparound [0|1] (default: 1)
2327 When moving right from the last tab, jump to the first one, and
2328 vice versa.
2329 ui.tabs.confirm_close [0|1] (default: 0)
2331 When closing a tab show confirmation dialog.
2332 ui.timer (Timer options)
2334 Timed action after certain interval of user inactivity. Someone can
2335 even find this useful, although you may not believe that.
2336 ui.timer.enable <num> (default: 0)
2338 Whether to enable the timer or not:
2339 · 0 is don't count down anything
2341 · 1 is count down, but don't show the timer
2343 · 2 is count down and show the timer near LEDs
2345 ui.timer.duration <num> (default: 86400)
2347 Inactivity timeout in seconds. The maximum of one day should be
2348 enough for just everyone (TM).
2349 ui.timer.action <str> (default: "")
2351 Keybinding action to be triggered when timer reaches zero.
2352
2354 elinks(1), elinkskeys(5)
2355ELinks 0.12pre6 10/28/2012 ELINKS.CONF(5)