1ELINKS.CONF(5) ELinks configuration file ELINKS.CONF(5)
2
6 elinks.conf - ELinks configuration file
7
9 set <option> = <value>
10 set_domain <domain> <option> = <value>
11 unset <option>
12 bind "<keymap>" "<key>" = "<action>"
13 include "<file>"
14
16 The elinks.conf file contains configuration information for ELinks. It
17 can be used to configure the behaviour of ELinks in a wide variety of
18 ways: protocol behaviour, keybindings, colors used for rendering and
19 for the user interface.
20 It is read at startup and saved only when requested. All options
22 described in this document can be fully configured from within ELinks
23 so no editing of elinks.conf is needed.
24 Note that MIME-related options used for specifying handlers of various
26 MIME types are NOT described in this document. Documentation for these
27 options can be found at the ELinks homepage. Keybindings can also be
28 specified in elinks.conf. This is described in elinkskeys(5).
29
32 The syntax of the configuration file is very simple. The elinks.conf
33 file is a free-form ASCII text file. The file may contain extra tabs
34 and newlines for formatting purposes. Keywords in the file are
35 case-sensitive. Comments may be placed anywhere within the file (except
36 within quotes). Comments begin with the # character and end at the end
37 of the line.
38
41 Some sample settings:
42 # Use asynchronous DNS resolver?
45 set connection.async_dns = 1
46 # horizontal text margin.
47 set document.browse.margin_width = 3
48 # Default document codepage.
49 set document.codepage.assume = "ISO-8859-1"
50 # User defined protocol handlers
51 set protocol.user.mailto.unix = "mutt %h -s \"%s\""
52
54 Generated using output from ELinks version 0.13.GIT.
55 bookmarks (Bookmarks)
58 Bookmark options.
59 bookmarks.file_format <num> (default: 0)
61 File format for bookmarks (affects both reading and saving):
62 • 0 is the default native ELinks format
64 • 1 is XBEL universal XML bookmarks format
66 bookmarks.folder_state [0|1] (default: 1)
68 When saving bookmarks also store whether folders are expanded or
69 not, so the look of the bookmark dialog is kept across ELinks
70 sessions. If disabled all folders will appear unexpanded next time
71 ELinks is run.
72 config (Configuration system)
74 Configuration handling options.
75 config.comments <num> (default: 3)
77 Amount of comments automatically written to the config file:
78 • 0 is no comments are written
80 • 1 is only the "blurb" (name+type) is written
82 • 2 is only the description is written
84 • 3 is full comments are written
86 config.indentation <num> (default: 2)
88 Shift width of one indentation level in the configuration file.
89 Zero means that no indentation is performed at all when saving the
90 configuration.
91 config.saving_style <num> (default: 3)
93 Determines what happens when you tell ELinks to save options:
94 • 0 is only values of current options are altered
96 • 1 is values of current options are altered and missing options
98 are added at the end of the file
99 • 2 is the configuration file is rewritten from scratch
101 • 3 is values of current options are altered and missing options
103 CHANGED during this ELinks session are added at the end of the
104 file
105 config.i18n [0|1] (default: 0)
107 If set to 1, comments in the configuration file will be translated
108 to the language used by UI. Note that if you have different
109 language set in different terminals, the language used in the
110 configuration file MAY be the same as on the terminal where you
111 saved the file, but it should be generally considered
112 unpredictable.
113 config.saving_style_w [0|1] (default: 0)
115 This is internal option used when displaying a warning about
116 obsolete config.saving_style. You shouldn´t touch it.
117 config.show_template [0|1] (default: 0)
119 Show template options in autocreated trees in the options manager
120 and save them to the configuration file.
121 connection (Connections)
123 Connection options.
124 connection.async_dns [0|1] (default: 1)
126 Whether to use asynchronous DNS resolving.
127 connection.max_connections <num> (default: 10)
129 Maximum number of concurrent connections.
130 connection.max_connections_to_host <num> (default: 2)
132 Maximum number of concurrent connections to a given host.
133 connection.receive_timeout <num> (default: 120)
135 Receive timeout (in seconds).
136 connection.retries <num> (default: 3)
138 Number of tries to establish a connection. Zero means try forever.
139 connection.try_ipv4 [0|1] (default: 1)
141 Whether to try to connect to a host over IPv4. Note that if
142 connection.try_ipv6 is enabled too, it takes precedence. And better
143 do not touch this at all unless you are sure what are you doing.
144 Note that you can also force a given protocol to be used on a
146 per-connection basis by using a URL in the style of e.g.
147 http4://elinks.cz/.
148 connection.try_ipv6 [0|1] (default: 1)
150 Whether to try to connect to a host over IPv6.
151 Note that you can also force a given protocol to be used on a
153 per-connection basis by using a URL in the style of e.g.
154 http6://elinks.cz/.
155 connection.unrestartable_receive_timeout <num> (default: 600)
157 Timeout for non-restartable connections (in seconds).
158 connection.ssl (SSL)
160 SSL options.
161 connection.ssl.cert_verify [0|1] (default: 0)
163 Verify the peer´s SSL certificate. Note that this needs extensive
164 configuration of OpenSSL by the user.
165 connection.ssl.https_by_default [0|1] (default: 0)
167 Use HTTPS when a URL scheme is not provided.
168 connection.ssl.client_cert (Client Certificates)
170 X509 client certificate options.
171 connection.ssl.client_cert.enable [0|1] (default: 0)
173 Enable or not the sending of X509 client certificates to servers
174 which request them.
175 connection.ssl.client_cert.file <str> (default: "")
177 The location of a file containing the client certificate and
178 unencrypted private key in PEM format. If unset, the file pointed
179 to by the X509_CLIENT_CERT variable is used instead.
180 cookies (Cookies)
182 Cookies options.
183 cookies.accept_policy <num> (default: 2)
185 Cookies accepting policy:
186 • 0 is accept no cookies
188 • 1 is ask for confirmation before accepting cookie
190 • 2 is accept all cookies
192 cookies.max_age <num> (default: -1)
194 Cookie maximum age (in days):
195 • -1 is use cookie´s expiration date if any
197 • 0 is force expiration at the end of session, ignoring cookie´s
199 expiration date
200 • 1+ is use cookie´s expiration date, but limit age to the given
202 number of days
203 cookies.paranoid_security [0|1] (default: 0)
205 When enabled, we´ll require three dots in cookies domain for all
206 non-international domains (instead of just two dots). Some
207 countries have generic second level domains (eg. .com.pl, .co.uk)
208 and allowing sites to set cookies for these generic domains could
209 potentially be very bad. Note, it is off by default as it breaks a
210 lot of sites.
211 cookies.save [0|1] (default: 1)
213 Whether cookies should be loaded from and saved to disk.
214 cookies.resave [0|1] (default: 1)
216 Save cookies after each change in cookies list? No effect when
217 cookie saving (cookies.save) is off.
218 document (Document)
220 Document options.
221 document.browse (Browsing)
224 Document browsing options (mainly interactivity).
225 document.browse.margin_width <num> (default: 3)
227 Horizontal text margin.
228 document.browse.refresh [0|1] (default: 1)
230 Automatically follow document-specified refresh directives (´<meta>
231 refresh´ tags). Web-page authors use these to instruct the browser
232 to reload a document at a given interval or to load another page.
233 Regardless of the value the refresh URI is accessible as a link.
234 Use the document.browse.minimum_refresh_time to control the minimum
236 number of seconds a refresh will wait.
237 document.browse.minimum_refresh_time <num> (default: 1000)
239 The minimum number of milliseconds that should pass before
240 refreshing. If set to zero the document refresh time is used
241 unchanged. It can fix going back in history for some sites that use
242 refreshing with zero values.
243 document.browse.table_move_order [0|1] (default: 0)
245 Move by columns in table, instead of rows.
246 document.browse.accesskey (Access keys)
248 Options for handling of link access keys. An HTML document can use the
249 ACCESSKEY attribute to assign an access key to an element. When an
250 access key is pressed, the corresponding element will be given focus.
251 document.browse.accesskey.auto_follow [0|1] (default: 0)
253 Automatically follow a link or submit a form if appropriate
254 accesskey is pressed – this is the standard behaviour, but it´s
255 considered dangerous.
256 document.browse.accesskey.display [0|1] (default: 0)
258 Display access key in link info.
259 document.browse.accesskey.priority <num> (default: 0)
261 Priority of ´accesskey´ HTML attribute:
262 • 0 is first try all normal bindings; if it fails, check
264 accesskey
265 • 1 is first try only frame bindings; if it fails, check
267 accesskey
268 • 2 is first check accesskey (this can be dangerous)
270 document.browse.forms (Forms)
272 Options for handling of the forms interaction.
273 document.browse.forms.auto_submit [0|1] (default: 1)
275 Automagically submit a form when enter is pressed with a text field
276 selected.
277 document.browse.forms.confirm_submit [0|1] (default: 1)
279 Ask for confirmation when submitting a form.
280 document.browse.forms.input_size <num> (default: 20)
282 Default form input size if none is specified.
283 document.browse.forms.insert_mode [0|1] (default: 1)
285 The setting for this option affects how key presses are handled
286 when one selects a text-input form-field. When enabled, one must
287 explicitly ´enter´ a selected text-field to edit it; this prevents
288 text fields from capturing key presses, such as presses of a scroll
289 key, when it is inadvertently selected. When disabled, key presses
290 are always inserted into a selected text field.
291 document.browse.forms.editor <str> (default: "")
293 Path to the executable that ELinks should launch when the user
294 requests to edit a textarea with an external editor.
295 If this is blank, ELinks will use the value of the environmental
297 variable $EDITOR. If $EDITOR is empty or not set, ELinks will then
298 default to vi.
299 document.browse.forms.show_formhist [0|1] (default: 0)
301 Ask if a login form should be saved to file or not. This option
302 only disables the dialog, already saved login forms are unaffected.
303 document.browse.images (Images)
305 Options for handling of images.
306 document.browse.images.display_style <num> (default: 2)
308 Display style for image tags when displayed:
309 • 0 means always display IMG
311 • 1 means always display filename
313 • 2 means display alt/title attribute if possible, IMG if not
315 • 3 means display alt/title attribute if possible, filename if
317 not
318 document.browse.images.filename_maxlen <num> (default: 0)
320 Maximum length of image filename when displayed:
321 • 0 means always display full filename
323 • 1-500 means display filename with this maximal length; if it is
325 longer, the middle is substituted by an asterisk
326 document.browse.images.image_link_tagging <num> (default: 1)
328 When to enclose image links:
329 • 0 means never
331 • 1 means never if alt or title are provided (old behavior)
333 • 2 means always
335 document.browse.images.image_link_prefix <str> (default: "[")
337 Prefix string to use to mark image links.
338 document.browse.images.image_link_suffix <str> (default: "]")
340 Suffix string to use to mark image links.
341 document.browse.images.label_maxlen <num> (default: 0)
343 Maximum length of image label (alt/title):
344 • 0 means always display full label
346 • 1-500 means display label with this maximal length; if it is
348 longer, the middle is substituted by an asterisk
349 document.browse.images.show_as_links [0|1] (default: 0)
351 Display links to images without an alt attribute. If this option is
352 off, these images are completely invisible.
353 document.browse.images.show_any_as_links [0|1] (default: 1)
355 Display links to any images in the document, regardless of them
356 having an alt attribute or not. If this option is off, the alt
357 attribute contents is shown, but as normal text, not selectable as
358 a link.
359 document.browse.links (Links)
361 Options for handling of links to other documents.
362 document.browse.links.color_dirs [0|1] (default: 1)
364 Highlight links to directories in FTP and local directory listing.
365 document.browse.links.numbering [0|1] (default: 0)
367 Display numbers next to the links.
368 document.browse.links.target_blank <num> (default: 0)
370 Define how to handle links having target=_blank set:
371 • 0 means open link in current tab
373 • 1 means open link in new tab in foreground
375 • 2 means open link in new tab in background
377 • 3 means open link in new window
379 document.browse.links.use_tabindex [0|1] (default: 1)
381 Whether to navigate links using tabindex specified ordering. The
382 TABINDEX attribute in HTML elements specifies the order in which
383 links should receive focus when using the keyboard to navigate the
384 document.
385 document.browse.links.missing_fragment [0|1] (default: 1)
387 Open a message box when document has no tag with given id.
388 document.browse.links.number_keys_select_link <num> (default: 1)
390 Number keys select links rather than specify command prefixes. This
391 is a tristate:
392 • 0 means never
394 • 1 means if document.browse.links.numbering = 1
396 • 2 means always
398 document.browse.links.warn_malicious [0|1] (default: 1)
400 When following a link the user ID part of the URI is checked and if
401 a maliciously crafted URI is detected a warning dialog will ask
402 before following the link.
403 document.browse.links.wraparound [0|1] (default: 0)
405 When pressing ´down´ on the last link, jump to the first one, and
406 vice versa.
407 document.browse.links.active_link (Active link)
409 Options for the active link.
410 document.browse.links.active_link.enable_color [0|1] (default: 0)
412 Enable use of the active link background and text color settings
413 instead of the link colors from the document.
414 document.browse.links.active_link.bold [0|1] (default: 0)
416 Make the active link text bold.
417 document.browse.links.active_link.invert [0|1] (default: 1)
419 Invert the fore- and background color so the link stands out.
420 document.browse.links.active_link.underline [0|1] (default: 0)
422 Underline the active link.
423 document.browse.links.active_link.colors (Colors)
425 Active link colors.
426 document.browse.links.active_link.colors.background <color|#rrggbb>
428 (default: blue)
429 Default background color.
430 document.browse.links.active_link.colors.text <color|#rrggbb> (default:
432 black)
433 Default text color.
434 document.browse.scrolling (Scrolling)
436 Scrolling options.
437 document.browse.scrolling.horizontal_extended [0|1] (default: 1)
439 Whether to allow horizontal scrolling when the document does not
440 extend off the screen. Useful for copy/paste operations.
441 document.browse.scrolling.horizontal_step <num> (default: 8)
443 Number of columns to scroll when a key bound to scroll-left or
444 scroll-right is pressed and no prefix was given.
445 document.browse.scrolling.margin <num> (default: 3)
447 Size of the virtual margin – when you click inside of that margin,
448 document scrolls in that direction.
449 document.browse.scrolling.vertical_overlap <num> (default: 0)
451 Number of overlapping lines between the new page displayed and the
452 previous one when scrolling one page up or down.
453 document.browse.scrolling.vertical_step <num> (default: 2)
455 Number of lines to scroll when a key bound to scroll-up or
456 scroll-down is pressed and no prefix was given.
457 document.browse.search (Searching)
459 Options for searching.
460 document.browse.search.case [0|1] (default: 0)
462 Whether the search should match the document text while maintaining
463 case sensitivity.
464 document.browse.search.regex <num> (default: 0)
466 Enable searching with regular expressions:
467 • 0 for plain text searching
469 • 1 for basic regular expression searches
471 • 2 for extended regular expression searches
473 document.browse.search.show_hit_top_bottom [0|1] (default: 1)
475 Whether to show a dialog when the search hits the top or bottom of
476 the document.
477 document.browse.search.wraparound [0|1] (default: 1)
479 Wrap around when searching. Currently only used for typeahead.
480 document.browse.search.show_not_found <num> (default: 2)
482 How to inform the user when nothing is matched:
483 • 0 means do nothing
485 • 1 means beep the terminal
487 • 2 means pop up message box
489 document.browse.search.typeahead <num> (default: 0)
491 Start typeahead searching when an unbound key is pressed without
492 any modifiers. Note that most keys have default bindings, so this
493 feature will not be useful unless you unbind them.
494 • 0 disables this feature; typeahead searching will only be used
496 when you press a key bound to search-typeahead or similar
497 • 1 automatically starts typeahead searching thru link text
499 • 2 automatically starts typeahead searching thru all document
501 text
502 document.cache (Cache)
504 Cache options.
505 document.cache.cache_redirects [0|1] (default: 0)
507 Cache even redirects sent by server (usually thru HTTP by a 302
508 HTTP code and a Location header). This was the original behaviour
509 for quite some time, but it causes problems in a situation very
510 common to various web login systems – frequently, when accessing a
511 certain location, they will redirect you to a login page if they
512 don´t receive an auth cookie, the login page then gives you the
513 cookie and redirects you back to the original page, but there you
514 have already cached redirect back to the login page! If this option
515 has value of 0, this malfunction is fixed, but occasionally you may
516 get superfluous (depends on how you take it ;-) requests to the
517 server. If this option has value of 1, experienced users can still
518 workaround it by clever combination of usage of reload, jumping
519 around in session history and hitting ctrl+enter.
520 Note that this option is checked when retrieving the information
522 from cache, not when saving it to cache – thus if you enable it,
523 even previous redirects will be taken from cache instead of asking
524 the server.
525 document.cache.ignore_cache_control [0|1] (default: 1)
527 Ignore Cache-Control and Pragma server headers. When set, the
528 document is cached even with ´Cache-Control: no-cache´.
529 document.cache.revalidation_interval <num> (default: -1)
531 Period in seconds that a cache entry is considered to be
532 up-to-date. When a document is loaded and this interval has elapsed
533 since the document was initially loaded or most recently
534 revalidated with the server, the server will be checked in case
535 there is a more up-to-date version of the document.
536 A value of -1 disables automatic revalidation.
538 document.cache.format (Formatted documents)
540 Format cache options.
541 document.cache.format.size <num> (default: 5)
543 Number of cached formatted pages. Do not get too generous here,
544 ´formatted´ means that all the accompanying structures are kept in
545 memory so that you get the cached document immediately, but these
546 structures may take a lot – 2x the size of the HTML source is
547 probably not unusual, but it can be even more if the document
548 consists of a lot of short lines (padded right, if possible) and
549 links and not much other markup. So if you set this to 256 and then
550 you don´t like your ELinks eating 90M, don´t come complaining to
551 us. ;-)
552 Also note that the format cache itself is not counted to the memory
554 cache size, but the HTML source of the formatted documents is
555 always cached, even if it is over the memory cache size threshold.
556 (Then of course no other documents can be cached.)
557 document.cache.memory (Memory cache)
559 Memory cache options.
560 document.cache.memory.size <num> (default: 1048576)
562 Memory cache size (in bytes).
563 document.codepage (Charset)
565 Charset options.
566 document.codepage.assume <codepage> (default: System)
568 Default document codepage. ´System´ stands for a codepage
569 determined by a selected locale.
570 document.codepage.force_assumed [0|1] (default: 0)
572 Ignore charset info sent by server.
573 document.colors (Default color settings)
575 Default document color settings.
576 document.colors.text <color|#rrggbb> (default: gray75)
578 Default text color.
579 document.colors.background <color|#rrggbb> (default: black)
581 Default background color.
582 document.colors.link <color|#rrggbb> (default: blue)
584 Default link color.
585 document.colors.vlink <color|#rrggbb> (default: yellow)
587 Default visited link color.
588 document.colors.image <color|#rrggbb> (default: darkolivegreen)
590 Default image link color.
591 document.colors.bookmark <color|#rrggbb> (default: hotpink)
593 Default bookmarked link color.
594 document.colors.dirs <color|#rrggbb> (default: yellow)
596 Default directory color.
597 See document.browse.links.color_dirs option.
599 document.colors.increase_contrast [0|1] (default: 1)
601 Increase the contrast between the foreground and background colors
602 to ensure readability. For example it disallows dark colors on a
603 black background. Note, this is different from ensuring the
604 contrast with the ensure_contrast option.
605 document.colors.ensure_contrast [0|1] (default: 1)
607 Makes sure that the back- and foreground colors are never equal.
608 document.colors.use_document_colors <num> (default: 2)
610 Use colors specified in document:
611 • 0 is use always the default settings
613 • 1 is use document colors if available, except background
615 • 2 is use document colors, including background. This can mostly
617 look very impressive, but some sites will appear really ugly.
618 Note, that obviously if the background is not black, it will
619 break the behaviour of transparency.
620 document.css (Cascading Style Sheets)
622 Options concerning how to use CSS for styling documents.
623 document.css.enable [0|1] (default: 1)
625 Enable adding of CSS style info to documents.
626 document.css.ignore_display_none [0|1] (default: 1)
628 When enabled, elements are rendered, even when their display
629 property has the value "none". Because ELinks´s CSS support is
630 still very incomplete, this setting can improve the way that some
631 documents are rendered.
632 document.css.import [0|1] (default: 1)
634 When enabled any external style sheets that are imported from
635 either CSS itself using the @import keyword or from the HTML using
636 <link> tags in the document header will also be downloaded.
637 document.css.media <str> (default: "tty")
639 CSS media types that ELinks claims to support, separated with
640 commas. The "all" type is implied. Currently, only ASCII characters
641 work reliably here. See CSS2 section 7:
642 http://www.w3.org/TR/1998/REC-CSS2-19980512/media.html
643 document.css.stylesheet <str> (default: "")
645 The path to the file containing the default user defined Cascading
646 Style Sheet. It can be used to control the basic layout of HTML
647 documents. The path is assumed to be relative to ELinks´ home
648 directory.
649 Leave as "" to use built-in document styling.
651 document.download (Downloading)
653 Options regarding files downloading and handling.
654 document.download.directory <str> (default: "./")
656 Default download directory.
657 document.download.set_original_time [0|1] (default: 0)
659 Set the timestamp of each downloaded file to the timestamp stored
660 on the server.
661 document.download.overwrite <num> (default: 2)
663 Prevent overwriting the local files:
664 • 0 is files will silently be overwritten
666 • 1 is add a suffix .{number} (for example ´.1´) to the name
668 • 2 is ask the user
670 document.download.notify_bell <num> (default: 0)
672 Audio notification when download is completed:
673 • 0 is never
675 • 1 is when background notification is active
677 • 2 is always
679 document.dump (Dump output)
681 Dump output options.
682 document.dump.codepage <codepage> (default: System)
684 Codepage used in dump output. ´System´ stands for a codepage
685 determined by a selected locale.
686 document.dump.color_mode <num> (default: -1)
688 Color mode for dumps.
689 Some modes may have been disabled at compile time. The Setup ->
691 Terminal options dialog lists the modes supported by this
692 executable. If you select an unsupported mode, ELinks uses 16
693 colors.
694 The color modes are:
696 • -1 is standard dump mode
698 • 0 is mono mode
700 • 1 is 16 color mode
702 • 2 is 88 color mode
704 • 3 is 256 color mode
706 • 4 is true color mode
708 document.dump.footer <str> (default: "")
710 Footer string used in dumps. %u is substituted by URL.
711 document.dump.header <str> (default: "")
713 Header string used in dumps. %u is substituted by URL.
714 document.dump.numbering [0|1] (default: 1)
716 Whether to print link numbers in dump output.
717 document.dump.references [0|1] (default: 1)
719 Whether to print references (URIs) of document links in dump
720 output.
721 document.dump.separator <str> (default: " ")
723 String which separates two dumps.
724 document.dump.width <num> (default: 80)
726 Width of screen in characters when dumping documents.
727 document.history (History)
729 History options.
730 document.history.keep_unhistory [0|1] (default: 1)
732 Keep unhistory ("forward history").
733 document.history.global (Global history)
735 Global history options.
736 document.history.global.enable [0|1] (default: 1)
738 Enable global history ("history of all pages visited").
739 document.history.global.max_items <num> (default: 1024)
741 Maximum number of entries in the global history.
742 document.history.global.display_type <num> (default: 0)
744 What to display in global history dialog:
745 • 0 is URLs
747 • 1 is page titles
749 document.html (HTML rendering)
751 Options concerning the display of HTML pages.
752 document.html.display_frames [0|1] (default: 1)
754 Display frames.
755 document.html.display_tables [0|1] (default: 1)
757 Display tables.
758 document.html.display_subs [0|1] (default: 1)
760 Display subscripts (as [thing]).
761 document.html.display_sups [0|1] (default: 1)
763 Display superscripts (as ^thing).
764 document.html.link_display <num> (default: 2)
766 How to render <link> tags from the HTML header:
767 • 0 is nothing
769 • 1 is title
771 • 2 is name in addition
773 • 3 is hreflang in addition
775 • 4 is type in addition
777 • 5 is everything
779 document.html.underline_links [0|1] (default: 0)
781 Underline links.
782 document.html.wrap_nbsp [0|1] (default: 0)
784 If set do not honour non breaking space (the nbsp entity) but
785 allows one to wrap the text. This can help keeping the width of
786 documents down so no horizontal scrolling is needed.
787 document.plain (Plain rendering)
789 Options concerning the display of plain text pages.
790 document.plain.display_links [0|1] (default: 0)
792 Display URIs in the document as links.
793 document.plain.compress_empty_lines [0|1] (default: 0)
795 Compress successive empty lines to only one in displayed text.
796 document.uri_passing (URI passing)
798 Rules for passing URIs to external commands. When one rule is defined
799 the link and tab menu will have a menu item that makes it possible to
800 pass the link, frame or tab URI to an external command. If several
801 rules are defined the link and tab menu will have a submenu of items
802 for each rule. The commands are also available by binding keys to the
803 frame-external-command, the link-external-command and the tab-external-
804 command actions.
805 document.uri_passing._template_ (URI passing)
807 Definition of an external program that can be passed URIs.
808 document.uri_passing._template_.command <str> (default: "")
810 A rule for passing URI to an external command. The format is:
811 • %c in the string means the current URL
813 • %% in the string means ´%´
815 Do not put single- or double-quotes around %c.
817 document.uri_passing._template_.foreground (default: 0)
819 External commands run in the background by default: elinks is still
820 active, and they do not receive standard input. This suboption
821 allows reverses this behaviour: the command receives standard input
822 and elinks is blocked.
823 ecmascript (ECMAScript)
825 ECMAScript options.
826 ecmascript.enable [0|1] (default: 0)
828 Whether to run those scripts inside of documents.
829 ecmascript.error_reporting [0|1] (default: 0)
831 Open a message box when a script reports an error.
832 ecmascript.ignore_noscript [0|1] (default: 0)
834 Whether to ignore content enclosed by the <noscript> tag when
835 ECMAScript is enabled.
836 ecmascript.max_exec_time <num> (default: 5)
838 Maximum execution time in seconds for a script.
839 ecmascript.block_window_opening [0|1] (default: 0)
841 Whether to disallow scripts to open new windows or tabs.
842 infofiles (Information files)
844 Options for information files in ~/.elinks.
845 infofiles.save_interval <num> (default: 300)
847 Interval at which to trigger information files in ~/.elinks to be
848 saved to disk if they have changed (seconds; 0 to disable)
849 infofiles.secure_save [0|1] (default: 1)
851 First write data to unique temporary file, then rename this file
852 upon successfully finishing this. Note that this relates only to
853 config files, not downloaded files. You may want to disable it if
854 you are using some exotic permissions for concerned files. Secure
855 file saving is automagically disabled if file is symlink.
856 Warning: some systems (ie. OS/2, Win32) require that destination
858 file doesn´t exist when rename(3) is called, breaking atomicity,
859 and reducing reliability of this feature.
860 infofiles.secure_save_fsync [0|1] (default: 1)
862 When using secure file saving, call fsync(3), if the OS supports
863 it, to force the OS immediately to write the data to permanent
864 storage. This is optional for those who wish to avoid excessive
865 disk I/O.
866 mime (MIME)
868 MIME-related options (handlers of various MIME types).
869 mime.default_type <str> (default: "application/octet-stream")
871 Document MIME-type to assume by default (when we are unable to
872 guess it properly from known information about the document).
873 mime.extension (File extension associations)
875 Extension ↔ MIME type association.
876 mime.extension._template_ <str> (default: "")
878 MIME-type matching this file extension (´*´ is used here in place
879 of ´.´).
880 mime.handler (File type handlers)
882 A file type handler is a set of information about how to use an
883 external program to view a file. It is possible to refer to it for
884 several MIME types — e.g., you can define an ´image´ handler to which
885 mime.type.image.png, mime.type.image.jpeg, and so on will refer; or one
886 might define a handler for a more specific type of file — e.g., PDF
887 files. Note you must define both a MIME handler and a MIME type
888 association for it to work.
889 mime.handler._template_ (Template option folder)
892 Description of this handler.
893 mime.handler._template_._template_ (Template option folder)
896 System-specific handler description (ie. unix, unix-xwin, ...).
897 mime.handler._template_._template_.ask [0|1] (default: 1)
899 Ask before opening.
900 mime.handler._template_._template_.block [0|1] (default: 1)
902 Block the terminal when the handler is running.
903 mime.handler._template_._template_.program <str> (default: "")
905 External viewer for this file type. ´%´ in this string will be
906 substituted by a file name. Do not put single- or double-quotes
907 around the % sign.
908 mime.mailcap (Mailcap)
910 Options for mailcap support.
911 mime.mailcap.enable [0|1] (default: 1)
913 Enable mailcap support.
914 mime.mailcap.path <str> (default:
916 "~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap:/usr/share/mailcap:/usr/share/misc/mailcap")
917 Mailcap search path. Colon-separated list of files. Leave as "" to
918 use MAILCAP environment variable instead.
919 mime.mailcap.ask [0|1] (default: 1)
921 Ask before using the handlers defined by mailcap.
922 mime.mailcap.description <num> (default: 0)
924 Type of description to show in "what to do with this file" query
925 dialog:
926 • 0 is show "mailcap"
928 • 1 is show program to be run
930 • 2 is show mailcap description field if any; "mailcap" otherwise
932 mime.mailcap.prioritize [0|1] (default: 1)
934 Prioritize entries by the order of the files in the mailcap path.
935 This means that wildcard entries (like: image/*) will also be
936 checked before deciding the handler.
937 mime.mimetypes (Mimetypes files)
939 Options for the support of mime.types files. These files can be used to
940 find the content type of a URL by looking at the extension of the file
941 name.
942 mime.mimetypes.enable [0|1] (default: 1)
944 Enable mime.types support.
945 mime.mimetypes.path <str> (default:
947 "~/.mime.types:/etc/mime.types:/usr/etc/mime.types:/usr/local/etc/mime.types:/usr/share/mime.types:/usr/share/misc/mime.types")
948 The search path for mime.types files. Colon-separated list of
949 files.
950 mime.type (MIME type associations)
952 Handler ↔ MIME type association. The first sub-tree is the MIME class
953 while the second sub-tree is the MIME type (ie. image/gif handler will
954 reside at mime.type.image.gif). Each MIME type option should contain
955 (case-sensitive) name of the MIME handler (its properties are stored at
956 mime.handler.<name>).
957 mime.type._template_ (Template option folder)
960 Handler matching this MIME-type class (´*´ is used here in place of
961 ´.´).
962 mime.type._template_._template_ <str> (default: "")
964 Handler matching this MIME-type name (´*´ is used here in place of
965 ´.´).
966 protocol (Protocols)
968 Protocol specific options.
969 protocol.no_proxy <str> (default: "")
971 Comma separated list of domains for which the proxy (HTTP/FTP)
972 should be disabled. Optionally, a port can be specified for some
973 domains as well. If it´s blank, NO_PROXY environment variable is
974 checked as well.
975 protocol.bittorrent (BitTorrent)
977 BitTorrent specific options.
978 protocol.bittorrent.piece_cache_size <num> (default: 1048576)
980 The maximum amount of memory used to hold recently downloaded
981 pieces.
982 Set to 0 to have unlimited size.
984 protocol.bittorrent.max_uploads <num> (default: 7)
986 The maximum number of uploads to allow at once.
987 protocol.bittorrent.min_uploads <num> (default: 2)
989 The minimum number of uploads which should at least be used for new
990 connections.
991 protocol.bittorrent.request_queue_size <num> (default: 5)
993 How many piece requests to continuously keep in queue. Pipelining
994 of requests is essential to saturate connections and get a good
995 connection performance and thus a faster download. However, a very
996 big queue size can lead to wasting bandwidth near the end of the
997 connection since remaining piece blocks will be requested from
998 multiple peers.
999 protocol.bittorrent.choke_interval <num> (default: 10)
1001 The number of seconds between updating the connection state and
1002 most importantly choke and unchoke peer connections. The choke
1003 period should be big enough for newly unchoked connections to get
1004 started but small enough to not allow freeriders too much room for
1005 stealing bandwidth.
1006 protocol.bittorrent.rarest_first_cutoff <num> (default: 4)
1008 The number of pieces to obtain before switching piece selection
1009 strategy from random to rarest first.
1010 protocol.bittorrent.allow_blacklist [0|1] (default: 1)
1012 Allow blacklisting of buggy peers.
1013 protocol.bittorrent.ports (Port range)
1015 Port range allowed to be used for listening on.
1016 protocol.bittorrent.ports.min <num> (default: 6881)
1018 The minimum port to try and listen on.
1019 protocol.bittorrent.ports.max <num> (default: 6999)
1021 The maximum port to try and listen on.
1022 protocol.bittorrent.tracker (Tracker)
1024 Tracker options.
1025 protocol.bittorrent.tracker.compact [0|1] (default: 0)
1027 Whether to request that the tracker returns peer info in compact
1028 format. Note, the compact format only supports IPv4 addresses.
1029 protocol.bittorrent.tracker.interval <num> (default: 0)
1031 The number of seconds to wait between periodically contacting the
1032 tracker for announcing progress and requesting more peers. Set to
1033 zero to use the interval requested by the tracker.
1034 protocol.bittorrent.tracker.ip_address <str> (default: "")
1036 What IP address to report to the tracker. If set to "" no IP
1037 address will be sent and the tracker will automatically determine
1038 an appropriate IP address.
1039 protocol.bittorrent.tracker.key <str> (default: "")
1041 An additional identification that is not shared with any users. It
1042 is intended to allow a client to prove their identity should their
1043 IP address change. It is an optional parameter, but some trackers
1044 require this parameter. If set to "" no user key will be sent to
1045 the tracker.
1046 protocol.bittorrent.tracker.numwant <num> (default: 50)
1048 The maximum number of peers to request from the tracker. Set to 0
1049 to use the server default.
1050 protocol.bittorrent.tracker.min_skip_size <num> (default: 20)
1052 The minimum number of peers to have in the current peer info pool
1053 before skipping requesting of more peers. I.e. setting numwant to
1054 zero. Set to 0 to not have any limit.
1055 protocol.bittorrent.peerwire (Peer-wire)
1057 Lowlevel peer-wire options.
1058 protocol.bittorrent.peerwire.connections <num> (default: 55)
1060 The maximum number of allowed connections to both active and
1061 non-active peers. By increasing the number of allowed connections,
1062 the chance of finding good peers to download from is increased.
1063 However, too many connections can lead to TCP congestion. If the
1064 maximum is reached all new incoming connections will be closed.
1065 protocol.bittorrent.peerwire.max_message_length <num> (default:
1067 8388608)
1068 The maximum length of messages to accept over the wire. Larger
1069 values will cause the connection to be dropped.
1070 protocol.bittorrent.peerwire.max_request_length <num> (default:
1072 8388608)
1073 The maximum length to allow for incoming requests. Larger requests
1074 will cause the connection to be dropped.
1075 protocol.bittorrent.peerwire.request_length <num> (default: 16384)
1077 How many bytes to query for per request. This is complementary to
1078 the max_request_length option. If the configured length is bigger
1079 than the piece length it will be truncated.
1080 protocol.bittorrent.peerwire.timeout <num> (default: 300)
1082 The number of seconds to wait before closing a socket on which
1083 nothing has been received or sent.
1084 protocol.bittorrent.peerwire.pool_size <num> (default: 55)
1086 Maximum number of items in the peer pool. The peer pool contains
1087 information used for establishing connections to new peers.
1088 Set to 0 to have unlimited size.
1090 protocol.file (Local files)
1092 Options specific to local browsing.
1093 protocol.file.allow_special_files [0|1] (default: 0)
1095 Whether to allow reading from non-regular files. Note this can be
1096 dangerous; reading /dev/urandom or /dev/zero can ruin your day!
1097 protocol.file.show_hidden_files [0|1] (default: 1)
1099 When set to false, files with name starting with a dot will be
1100 hidden in local directory listings.
1101 protocol.file.try_encoding_extensions [0|1] (default: 1)
1103 When set, if we can´t open a file named ´filename´, we´ll try to
1104 open ´filename´ with some encoding extension appended (ie.
1105 ´filename.gz´); it depends on the supported encodings.
1106 protocol.file.cgi (Local CGI)
1108 Local CGI specific options.
1109 protocol.file.cgi.path <str> (default: "")
1111 Colon separated list of directories, where CGI scripts are stored.
1112 protocol.file.cgi.policy [0|1] (default: 0)
1114 Whether to execute local CGI scripts.
1115 protocol.ftp (FTP)
1117 FTP specific options.
1118 protocol.ftp.anon_passwd <str> (default: "some@host.domain")
1120 FTP anonymous password to be sent.
1121 protocol.ftp.use_pasv [0|1] (default: 1)
1123 Use PASV instead of PORT (passive vs active mode, IPv4 only).
1124 protocol.ftp.use_epsv [0|1] (default: 0)
1126 Use EPSV instead of EPRT (passive vs active mode, IPv6 only).
1127 protocol.ftp.proxy (Proxy configuration)
1129 FTP proxy configuration.
1130 protocol.ftp.proxy.host <str> (default: "")
1132 Host and port-number (host:port) of the FTP proxy, or blank. If
1133 it´s blank, FTP_PROXY environment variable is checked as well.
1134 protocol.http (HTTP)
1136 HTTP-specific options.
1137 protocol.http.accept_language <str> (default: "")
1139 Send Accept-Language header.
1140 protocol.http.accept_ui_language [0|1] (default: 1)
1142 Request localised versions of documents from web-servers (using the
1143 Accept-Language header) using the language you have configured for
1144 ELinks´ user-interface (this also affects navigator.language
1145 ECMAScript value available to scripts). Note that some see this as
1146 a potential security risk because it tells web-masters and the FBI
1147 sniffers about your language preference.
1148 protocol.http.compression [0|1] (default: 0)
1150 If enabled, the capability to receive compressed content (gzip
1151 and/or bzip2) is announced to the server, which usually sends the
1152 reply compressed, thus saving some bandwidth at slight CPU expense.
1153 If ELinks displays a incomplete page or garbage, try disabling this
1155 option. If that helps, there may be a bug in the decompression part
1156 of ELinks. Please report such bugs.
1157 If ELinks has been compiled without compression support, this
1159 option has no effect. To check the supported features, see Help ->
1160 About.
1161 protocol.http.trace [0|1] (default: 0)
1163 If active, all HTTP requests are sent with TRACE as their method
1164 rather than GET or POST. This is useful for debugging of both
1165 ELinks and various server-side scripts — the server only returns
1166 the client´s request back to the client verbatim. Note that this
1167 type of request may not be enabled on all servers.
1168 protocol.http.user_agent <str> (default: "ELinks/%v (textmode; %s;
1170 %t-%b)")
1171 Change the User Agent ID. That means identification string, which
1172 is sent to HTTP server when a document is requested. The ´textmode´
1173 token in the first field is our silent attempt to establish this as
1174 a standard for new textmode user agents, so that the webmasters can
1175 have just a single uniform test for these if they are e.g. pushing
1176 some lite version to them automagically.
1177 Use " " if you don´t want any User-Agent header to be sent at all.
1179 • %v in the string means ELinks version,
1181 • %s in the string means system identification,
1183 • %t in the string means size of the terminal,
1185 • %b in the string means number of bars displayed by ELinks.
1187 protocol.http.bugs (Server bug workarounds)
1189 Server-side HTTP bugs workarounds.
1190 protocol.http.bugs.accept_charset [0|1] (default: 1)
1192 The Accept-Charset header is quite long and sending it can trigger
1193 bugs in some rarely found servers.
1194 protocol.http.bugs.allow_blacklist [0|1] (default: 1)
1196 Allow blacklisting of buggy servers.
1197 protocol.http.bugs.broken_302_redirect [0|1] (default: 1)
1199 Broken 302 redirect (violates RFC but compatible with Netscape).
1200 This is a problem for a lot of web discussion boards and the like.
1201 If they will do strange things to you, try to play with this.
1202 protocol.http.bugs.post_no_keepalive [0|1] (default: 0)
1204 Disable keepalive connection after POST request.
1205 protocol.http.bugs.http10 [0|1] (default: 0)
1207 Use HTTP/1.0 protocol instead of HTTP/1.1.
1208 protocol.http.proxy (Proxy configuration)
1210 HTTP proxy configuration.
1211 protocol.http.proxy.host <str> (default: "")
1213 Host and port-number (host:port) of the HTTP proxy, or blank. If
1214 it´s blank, HTTP_PROXY environment variable is checked as well.
1215 protocol.http.proxy.user <str> (default: "")
1217 Proxy authentication username.
1218 protocol.http.proxy.passwd <str> (default: "")
1220 Proxy authentication password.
1221 protocol.http.referer (Referer sending)
1223 HTTP referer sending options. HTTP referer is a special header sent in
1224 the HTTP requests, which is supposed to contain the previous page
1225 visited by the browser.This way, the server can know what link did you
1226 follow when accessing that page. However, this behaviour can
1227 unfortunately considerably affect privacy and can lead even to a
1228 security problem on some badly designed web pages.
1229 protocol.http.referer.policy <num> (default: 3)
1231 Mode of sending HTTP referer:
1232 • 0 is send no referer
1234 • 1 is send current URL as referer
1236 • 2 is send fixed fake referer
1238 • 3 is send previous URL as referer (correct, but insecure)
1240 protocol.http.referer.fake <str> (default: "")
1242 Fake referer to be sent when policy is 2.
1243 protocol.https (HTTPS)
1245 HTTPS-specific options.
1246 protocol.https.proxy (Proxy configuration)
1249 HTTPS proxy configuration.
1250 protocol.https.proxy.host <str> (default: "")
1252 Host and port-number (host:port) of the HTTPS CONNECT proxy, or
1253 blank. If it´s blank, HTTPS_PROXY environment variable is checked
1254 as well.
1255 protocol.nntp (NNTP)
1257 NNTP and news specific options.
1258 protocol.nntp.server <str> (default: "")
1260 Used when resolving news: URIs. If set to the empty string the
1261 value of the NNTPSERVER environment variable will be used.
1262 protocol.nntp.header_entries <str> (default:
1264 "Subject,From,Date,Message-ID,Newsgroups")
1265 Comma separated list of which entries in the article header to
1266 show. E.g. ´Subject´ and ´From´. All header entries can be read in
1267 the header info dialog.
1268 protocol.rewrite (URI rewriting)
1270 Rules for rewriting URIs entered in the goto dialog. It makes it
1271 possible to define a set of prefixes that will be expanded if they
1272 match a string entered in the goto dialog. The prefixes can be dumb,
1273 meaning that they work only like URI abbreviations, or smart ones,
1274 making it possible to pass arguments to them like search engine
1275 keywords.
1276 protocol.rewrite.default_template <str> (default: "")
1278 Default URI template used when the string entered in the goto
1279 dialog does not appear to be a URI or a filename (i.e. contains no
1280 ´.´, ´:´ or ´/´ characters), and does not match any defined
1281 prefixes. Set the value to "" to disable use of the default
1282 template rewrite rule.
1283 • %c in the template means the current URL,
1285 • %s in the template means the whole string from the goto dialog,
1287 • %0,%1,...,%9 mean the 1st,2nd,...,10th space-delimited part of
1289 %s,
1290 • %% in the template means ´%´.
1292 protocol.rewrite.enable-dumb [0|1] (default: 1)
1294 Enable dumb prefixes – simple URI abbreviations which can be
1295 written to the Goto URL dialog instead of actual URIs – i.e. if you
1296 write ´elinks´ there, you are directed to http://elinks.cz/.
1297 protocol.rewrite.enable-smart [0|1] (default: 1)
1299 Enable smart prefixes – URI templates triggered by writing given
1300 abbreviation to the Goto URL dialog followed by a list of arguments
1301 from which the actual URI is composed – i.e. ´gg:search keywords´
1302 or ´gn search keywords for news´.
1303 protocol.rewrite.dumb (Dumb Prefixes)
1305 Dumb prefixes, see enable-dumb description for details.
1306 protocol.rewrite.dumb._template_ <str> (default: "")
1308 Replacement URI for this dumbprefix:
1309 • %c in the string means the current URL
1311 • %% in the string means ´%´
1313 protocol.rewrite.smart (Smart Prefixes)
1315 Smart prefixes, see enable-smart description for details.
1316 protocol.rewrite.smart._template_ <str> (default: "")
1318 Replacement URI for this smartprefix:
1319 • %c in the string means the current URL
1321 • %s in the string means the whole argument to smartprefix
1323 • %0,%1,...,%9 means argument 0, 1, ..., 9
1325 • %% in the string means ´%´
1327 protocol.user (User protocols)
1329 User protocols. Options in this tree specify external handlers for the
1330 appropriate protocols. Ie. protocol.user.mailto.unix.
1331 protocol.user._template_ (Template option folder)
1334 Handler (external program) for this protocol. Name the options in this
1335 tree after your system (ie. unix, unix-xwin).
1336 protocol.user._template_._template_ <str> (default: "")
1338 Handler (external program) for this protocol and system.
1339 • %f in the string means file name to include form data from
1341 • %h in the string means hostname (or email address)
1343 • %p in the string means port
1345 • %d in the string means path (everything after the port)
1347 • %s in the string means subject (?subject=<this>)
1349 • %u in the string means the whole URL
1351 terminal (Terminals)
1353 Terminal options.
1354 terminal._template_ (Template option folder)
1357 Options specific to this terminal type (according to $TERM value).
1358 terminal._template_.type <num> (default: 0)
1360 Terminal type; matters mostly only when drawing frames and dialog
1361 box borders:
1362 • 0 is dumb terminal type, ASCII art
1364 • 1 is VT100, simple but portable
1366 • 2 is Linux, you get double frames and other goodies
1368 • 3 is KOI-8
1370 • 4 is FreeBSD
1372 • 5 is fbterm
1374 terminal._template_.latin1_title [0|1] (default: 1)
1376 When updating the window title of xterm or a similar terminal
1377 emulator, encode the title in ISO-8859-1 (Latin-1), rather than in
1378 the charset used for other text in the window. Cyrillic and other
1379 characters get replaced with Latin ones. Xterm requires this unless
1380 you explicitly enable UTF-8 titles in it.
1381 If this option does not take effect immediately, try switching to a
1383 different page so that ELinks notices it needs to update the title.
1384 terminal._template_.m11_hack [0|1] (default: 0)
1386 Switch fonts when drawing lines, enabling both local characters and
1387 lines working at the same time. ELinks uses this option only if
1388 UTF-8 I/O is disabled and the terminal type is Linux or FreeBSD.
1389 terminal._template_.utf_8_io [0|1] (default: 0)
1391 Enable I/O in UTF-8 for Unicode terminals. Note that currently,
1392 only the subset of UTF-8 according to terminal codepage is used.
1393 ELinks ignores this option if the terminal codepage is UTF-8.
1394 terminal._template_.combine [0|1] (default: 0)
1396 Enable combining characters. It works only with the xterm in UTF-8
1397 mode.
1398 terminal._template_.restrict_852 [0|1] (default: 0)
1400 Restrict the characters used when drawing lines. Makes sense only
1401 with linux terminals using the cp850/852 character sets.
1402 terminal._template_.block_cursor [0|1] (default: 0)
1404 Move cursor to bottom right corner when done drawing. This is
1405 particularly useful when we have a block cursor, so that inversed
1406 text is displayed correctly.
1407 terminal._template_.colors <num> (default: 0)
1409 The color mode controls what colors are used and how they are
1410 output to the terminal.
1411 Some modes may have been disabled at compile time. The Setup ->
1413 Terminal options dialog lists the modes supported by this
1414 executable. If you select an unsupported mode, ELinks uses 16
1415 colors.
1416 The color modes are:
1418 • 0 is mono mode, only 2 colors are used
1420 • 1 is 16 color mode, uses the common ANSI colors
1422 • 2 is 88 color mode, uses XTerm RGB codes
1424 • 3 is 256 color mode, uses XTerm RGB codes
1426 • 4 is true color mode, uses konsole RGB codes
1428 terminal._template_.transparency [0|1] (default: 0)
1430 If we should not set the background to black. This is particularly
1431 useful when we have a terminal (typically in some windowing
1432 environment) with a background image or a transparent background –
1433 it will be visible in ELinks as well (but ELinks document color
1434 handling will still assume the background is black so if you have a
1435 bright background you might experience contrast problems). Note
1436 that this option makes sense only when colors are enabled.
1437 terminal._template_.italic [0|1] (default: 0)
1439 If we should use italics.
1440 terminal._template_.underline [0|1] (default: 0)
1442 If we should use underline or enhance the color instead.
1443 terminal._template_.charset <codepage> (default: System)
1445 Codepage of charset used for displaying content on terminal.
1446 ´System´ stands for a codepage determined by a selected locale.
1447 ui (User interface)
1449 User interface options.
1450 ui.date_format <str> (default: "%b %e %H:%M")
1452 Date format to use in dialogs. See strftime(3).
1453 ui.language <language> (default: "System")
1455 Language of user interface. ´System´ means that the language will
1456 be extracted from the environment dynamically.
1457 ui.mouse_disable [0|1] (default: 0)
1459 Disable the mouse. Changes take effect at the next ELinks restart.
1460 ui.show_ip [0|1] (default: 0)
1462 Whether to display the IP address of the document in the status
1463 bar.
1464 ui.show_menu_bar_always [0|1] (default: 0)
1466 Always show menu bar on the screen.
1467 ui.show_status_bar [0|1] (default: 1)
1469 Show status bar on the screen.
1470 ui.show_title_bar [0|1] (default: 1)
1472 Show title bar on the screen.
1473 ui.startup_goto_dialog [0|1] (default: 1)
1475 Pop up goto dialog in newly created tabs when there´s no homepage
1476 set. This means also showing goto dialog on startup.
1477 ui.success_msgbox [0|1] (default: 1)
1479 When you pressed a Save button in some manager, this option will
1480 make sure that a box confirming success of the operation will pop
1481 up.
1482 ui.window_title [0|1] (default: 1)
1484 Set the window title when running in a windowing environment in an
1485 xterm-like terminal. This way the document´s title is shown on the
1486 window titlebar.
1487 ui.clock (Clock)
1489 Digital clock in the status bar.
1490 ui.clock.enable [0|1] (default: 0)
1492 Whether to display a digital clock in the status bar.
1493 ui.clock.format <str> (default: "[%H:%M]")
1495 Format string for the digital clock. See the strftime(3) manpage
1496 for details.
1497 ui.colors (Color settings)
1499 Default user interface color settings.
1500 ui.colors.color (Color terminals)
1503 Color settings for color terminal.
1504 ui.colors.color.mainmenu (Main menu bar)
1507 Main menu bar colors.
1508 ui.colors.color.mainmenu.normal (Unselected main menu bar item)
1511 Unselected main menu bar item colors.
1512 ui.colors.color.mainmenu.normal.text <color|#rrggbb> (default: black)
1514 Default text color.
1515 ui.colors.color.mainmenu.normal.background <color|#rrggbb> (default:
1517 white)
1518 Default background color.
1519 ui.colors.color.mainmenu.selected (Selected main menu bar item)
1521 Selected main menu bar item colors.
1522 ui.colors.color.mainmenu.selected.text <color|#rrggbb> (default: green)
1524 Default text color.
1525 ui.colors.color.mainmenu.selected.background <color|#rrggbb> (default:
1527 black)
1528 Default background color.
1529 ui.colors.color.mainmenu.hotkey (Hotkey)
1531 Main menu hotkey colors.
1532 ui.colors.color.mainmenu.hotkey.normal (Unselected hotkey)
1535 Main menu unselected hotkey colors.
1536 ui.colors.color.mainmenu.hotkey.normal.text <color|#rrggbb> (default:
1538 darkred)
1539 Default text color.
1540 ui.colors.color.mainmenu.hotkey.normal.background <color|#rrggbb>
1542 (default: white)
1543 Default background color.
1544 ui.colors.color.mainmenu.hotkey.selected (Selected hotkey)
1546 Main menu selected hotkey colors.
1547 ui.colors.color.mainmenu.hotkey.selected.text <color|#rrggbb> (default:
1549 darkred)
1550 Default text color.
1551 ui.colors.color.mainmenu.hotkey.selected.background <color|#rrggbb>
1553 (default: green)
1554 Default background color.
1555 ui.colors.color.menu (Menu bar)
1557 Menu bar colors.
1558 ui.colors.color.menu.normal (Unselected menu item)
1561 Unselected menu item colors.
1562 ui.colors.color.menu.normal.text <color|#rrggbb> (default: black)
1564 Default text color.
1565 ui.colors.color.menu.normal.background <color|#rrggbb> (default: white)
1567 Default background color.
1568 ui.colors.color.menu.selected (Selected menu item)
1570 Selected menu item colors.
1571 ui.colors.color.menu.selected.text <color|#rrggbb> (default: black)
1573 Default text color.
1574 ui.colors.color.menu.selected.background <color|#rrggbb> (default:
1576 green)
1577 Default background color.
1578 ui.colors.color.menu.marked (Marked menu item)
1580 Marked menu item colors.
1581 ui.colors.color.menu.marked.text <color|#rrggbb> (default: red)
1583 Default text color.
1584 ui.colors.color.menu.marked.background <color|#rrggbb> (default: white)
1586 Default background color.
1587 ui.colors.color.menu.hotkey (Hotkey)
1589 Menu item hotkey colors.
1590 ui.colors.color.menu.hotkey.normal (Unselected hotkey)
1593 Menu item unselected hotkey colors.
1594 ui.colors.color.menu.hotkey.normal.text <color|#rrggbb> (default:
1596 darkred)
1597 Default text color.
1598 ui.colors.color.menu.hotkey.normal.background <color|#rrggbb> (default:
1600 white)
1601 Default background color.
1602 ui.colors.color.menu.hotkey.selected (Selected hotkey)
1604 Menu item selected hotkey colors.
1605 ui.colors.color.menu.hotkey.selected.text <color|#rrggbb> (default:
1607 darkred)
1608 Default text color.
1609 ui.colors.color.menu.hotkey.selected.background <color|#rrggbb>
1611 (default: green)
1612 Default background color.
1613 ui.colors.color.menu.frame (Menu frame)
1615 Menu frame colors.
1616 ui.colors.color.menu.frame.text <color|#rrggbb> (default: black)
1618 Default text color.
1619 ui.colors.color.menu.frame.background <color|#rrggbb> (default: white)
1621 Default background color.
1622 ui.colors.color.dialog (Dialog)
1624 Dialog colors.
1625 ui.colors.color.dialog.generic (Generic)
1628 Generic dialog colors.
1629 ui.colors.color.dialog.generic.text <color|#rrggbb> (default: black)
1631 Default text color.
1632 ui.colors.color.dialog.generic.background <color|#rrggbb> (default:
1634 white)
1635 Default background color.
1636 ui.colors.color.dialog.frame (Frame)
1638 Dialog frame colors.
1639 ui.colors.color.dialog.frame.text <color|#rrggbb> (default: black)
1641 Default text color.
1642 ui.colors.color.dialog.frame.background <color|#rrggbb> (default:
1644 white)
1645 Default background color.
1646 ui.colors.color.dialog.scrollbar (Scrollbar)
1648 Scrollbar colors.
1649 ui.colors.color.dialog.scrollbar.text <color|#rrggbb> (default: black)
1651 Default text color.
1652 ui.colors.color.dialog.scrollbar.background <color|#rrggbb> (default:
1654 blue)
1655 Default background color.
1656 ui.colors.color.dialog.scrollbar-selected (Selected scrollbar)
1658 Scrollbar selected colors.
1659 ui.colors.color.dialog.scrollbar-selected.text <color|#rrggbb>
1661 (default: black)
1662 Default text color.
1663 ui.colors.color.dialog.scrollbar-selected.background <color|#rrggbb>
1665 (default: green)
1666 Default background color.
1667 ui.colors.color.dialog.title (Title)
1669 Dialog title colors.
1670 ui.colors.color.dialog.title.text <color|#rrggbb> (default: darkred)
1672 Default text color.
1673 ui.colors.color.dialog.title.background <color|#rrggbb> (default:
1675 white)
1676 Default background color.
1677 ui.colors.color.dialog.text (Text)
1679 Dialog text colors.
1680 ui.colors.color.dialog.text.text <color|#rrggbb> (default: black)
1682 Default text color.
1683 ui.colors.color.dialog.text.background <color|#rrggbb> (default: white)
1685 Default background color.
1686 ui.colors.color.dialog.checkbox (Checkbox)
1688 Dialog checkbox colors.
1689 ui.colors.color.dialog.checkbox.text <color|#rrggbb> (default: darkred)
1691 Default text color.
1692 ui.colors.color.dialog.checkbox.background <color|#rrggbb> (default:
1694 white)
1695 Default background color.
1696 ui.colors.color.dialog.checkbox-selected (Selected checkbox)
1698 Dialog selected checkbox colors.
1699 ui.colors.color.dialog.checkbox-selected.text <color|#rrggbb> (default:
1701 yellow)
1702 Default text color.
1703 ui.colors.color.dialog.checkbox-selected.background <color|#rrggbb>
1705 (default: green)
1706 Default background color.
1707 ui.colors.color.dialog.checkbox-label (Checkbox label)
1709 Dialog checkbox label colors.
1710 ui.colors.color.dialog.checkbox-label.text <color|#rrggbb> (default:
1712 black)
1713 Default text color.
1714 ui.colors.color.dialog.checkbox-label.background <color|#rrggbb>
1716 (default: white)
1717 Default background color.
1718 ui.colors.color.dialog.button (Button)
1720 Dialog button colors.
1721 ui.colors.color.dialog.button.text <color|#rrggbb> (default: white)
1723 Default text color.
1724 ui.colors.color.dialog.button.background <color|#rrggbb> (default:
1726 blue)
1727 Default background color.
1728 ui.colors.color.dialog.button-selected (Selected button)
1730 Dialog selected button colors.
1731 ui.colors.color.dialog.button-selected.text <color|#rrggbb> (default:
1733 yellow)
1734 Default text color.
1735 ui.colors.color.dialog.button-selected.background <color|#rrggbb>
1737 (default: green)
1738 Default background color.
1739 ui.colors.color.dialog.button-shortcut (Button shortcut)
1741 Dialog button colors.
1742 ui.colors.color.dialog.button-shortcut.text <color|#rrggbb> (default:
1744 yellow)
1745 Default text color.
1746 ui.colors.color.dialog.button-shortcut.background <color|#rrggbb>
1748 (default: blue)
1749 Default background color.
1750 ui.colors.color.dialog.button-shortcut-selected (Selected button shortcut)
1752 Dialog selected button colors.
1753 ui.colors.color.dialog.button-shortcut-selected.text <color|#rrggbb>
1755 (default: white)
1756 Default text color.
1757 ui.colors.color.dialog.button-shortcut-selected.background
1759 <color|#rrggbb> (default: blue)
1760 Default background color.
1761 ui.colors.color.dialog.field (Text field)
1763 Dialog text field colors.
1764 ui.colors.color.dialog.field.text <color|#rrggbb> (default: white)
1766 Default text color.
1767 ui.colors.color.dialog.field.background <color|#rrggbb> (default: blue)
1769 Default background color.
1770 ui.colors.color.dialog.field-text (Text field text)
1772 Dialog field text colors.
1773 ui.colors.color.dialog.field-text.text <color|#rrggbb> (default:
1775 yellow)
1776 Default text color.
1777 ui.colors.color.dialog.field-text.background <color|#rrggbb> (default:
1779 blue)
1780 Default background color.
1781 ui.colors.color.dialog.meter (Meter)
1783 Dialog meter colors.
1784 ui.colors.color.dialog.meter.text <color|#rrggbb> (default: white)
1786 Default text color.
1787 ui.colors.color.dialog.meter.background <color|#rrggbb> (default: blue)
1789 Default background color.
1790 ui.colors.color.dialog.shadow (Shadow)
1792 Dialog shadow colors (see ui.shadows option).
1793 ui.colors.color.dialog.shadow.text <color|#rrggbb> (default: black)
1795 Default text color.
1796 ui.colors.color.dialog.shadow.background <color|#rrggbb> (default:
1798 black)
1799 Default background color.
1800 ui.colors.color.title (Title bar)
1802 Title bar colors.
1803 ui.colors.color.title.title-bar (Generic title bar)
1806 Generic title bar colors.
1807 ui.colors.color.title.title-bar.text <color|#rrggbb> (default: black)
1809 Default text color.
1810 ui.colors.color.title.title-bar.background <color|#rrggbb> (default:
1812 white)
1813 Default background color.
1814 ui.colors.color.title.title-text (Title bar text)
1816 Title bar text colors.
1817 ui.colors.color.title.title-text.text <color|#rrggbb> (default: black)
1819 Default text color.
1820 ui.colors.color.title.title-text.background <color|#rrggbb> (default:
1822 white)
1823 Default background color.
1824 ui.colors.color.status (Status bar)
1826 Status bar colors.
1827 ui.colors.color.status.status-bar (Generic status bar)
1830 Generic status bar colors.
1831 ui.colors.color.status.status-bar.text <color|#rrggbb> (default: black)
1833 Default text color.
1834 ui.colors.color.status.status-bar.background <color|#rrggbb> (default:
1836 white)
1837 Default background color.
1838 ui.colors.color.status.status-text (Status bar text)
1840 Status bar text colors.
1841 ui.colors.color.status.status-text.text <color|#rrggbb> (default:
1843 black)
1844 Default text color.
1845 ui.colors.color.status.status-text.background <color|#rrggbb> (default:
1847 white)
1848 Default background color.
1849 ui.colors.color.tabs (Tabs bar)
1851 Tabs bar colors.
1852 ui.colors.color.tabs.unvisited (Unvisited tab)
1855 Tab colors for tabs that have not been selected since they completed
1856 loading.
1857 ui.colors.color.tabs.unvisited.text <color|#rrggbb> (default: darkblue)
1859 Default text color.
1860 ui.colors.color.tabs.unvisited.background <color|#rrggbb> (default:
1862 white)
1863 Default background color.
1864 ui.colors.color.tabs.normal (Unselected tab)
1866 Unselected tab colors.
1867 ui.colors.color.tabs.normal.text <color|#rrggbb> (default: black)
1869 Default text color.
1870 ui.colors.color.tabs.normal.background <color|#rrggbb> (default: white)
1872 Default background color.
1873 ui.colors.color.tabs.loading (Loading tab)
1875 Tab colors for tabs that are loading in the background.
1876 ui.colors.color.tabs.loading.text <color|#rrggbb> (default: darkred)
1878 Default text color.
1879 ui.colors.color.tabs.loading.background <color|#rrggbb> (default:
1881 white)
1882 Default background color.
1883 ui.colors.color.tabs.selected (Selected tab)
1885 Selected tab colors.
1886 ui.colors.color.tabs.selected.text <color|#rrggbb> (default: black)
1888 Default text color.
1889 ui.colors.color.tabs.selected.background <color|#rrggbb> (default:
1891 green)
1892 Default background color.
1893 ui.colors.color.tabs.separator (Tab separator)
1895 Tab separator colors.
1896 ui.colors.color.tabs.separator.text <color|#rrggbb> (default: brown)
1898 Default text color.
1899 ui.colors.color.tabs.separator.background <color|#rrggbb> (default:
1901 white)
1902 Default background color.
1903 ui.colors.color.searched (Searched strings)
1905 Searched string highlight colors.
1906 ui.colors.color.searched.text <color|#rrggbb> (default: black)
1908 Default text color.
1909 ui.colors.color.searched.background <color|#rrggbb> (default: lime)
1911 Default background color.
1912 ui.colors.mono (Non-color terminals)
1914 Color settings for non-color terminal.
1915 ui.colors.mono.mainmenu (Main menu bar)
1918 Main menu bar colors.
1919 ui.colors.mono.mainmenu.normal (Unselected main menu bar item)
1922 Unselected main menu bar item colors.
1923 ui.colors.mono.mainmenu.normal.text <color|#rrggbb> (default: black)
1925 Default text color.
1926 ui.colors.mono.mainmenu.normal.background <color|#rrggbb> (default:
1928 white)
1929 Default background color.
1930 ui.colors.mono.mainmenu.selected (Selected main menu bar item)
1932 Selected main menu bar item colors.
1933 ui.colors.mono.mainmenu.selected.text <color|#rrggbb> (default: gray)
1935 Default text color.
1936 ui.colors.mono.mainmenu.selected.background <color|#rrggbb> (default:
1938 black)
1939 Default background color.
1940 ui.colors.mono.mainmenu.hotkey (Hotkey)
1942 Main menu hotkey colors.
1943 ui.colors.mono.mainmenu.hotkey.normal (Unselected hotkey)
1946 Main menu unselected hotkey colors.
1947 ui.colors.mono.mainmenu.hotkey.normal.text <color|#rrggbb> (default:
1949 black)
1950 Default text color.
1951 ui.colors.mono.mainmenu.hotkey.normal.background <color|#rrggbb>
1953 (default: white)
1954 Default background color.
1955 ui.colors.mono.mainmenu.hotkey.selected (Selected hotkey)
1957 Main menu selected hotkey colors.
1958 ui.colors.mono.mainmenu.hotkey.selected.text <color|#rrggbb> (default:
1960 black)
1961 Default text color.
1962 ui.colors.mono.mainmenu.hotkey.selected.background <color|#rrggbb>
1964 (default: white)
1965 Default background color.
1966 ui.colors.mono.menu (Menu bar)
1968 Menu bar colors.
1969 ui.colors.mono.menu.normal (Unselected menu item)
1972 Unselected menu item colors.
1973 ui.colors.mono.menu.normal.text <color|#rrggbb> (default: black)
1975 Default text color.
1976 ui.colors.mono.menu.normal.background <color|#rrggbb> (default: white)
1978 Default background color.
1979 ui.colors.mono.menu.selected (Selected menu item)
1981 Selected menu item colors.
1982 ui.colors.mono.menu.selected.text <color|#rrggbb> (default: gray)
1984 Default text color.
1985 ui.colors.mono.menu.selected.background <color|#rrggbb> (default:
1987 black)
1988 Default background color.
1989 ui.colors.mono.menu.marked (Marked menu item)
1991 Marked menu item colors.
1992 ui.colors.mono.menu.marked.text <color|#rrggbb> (default: gray)
1994 Default text color.
1995 ui.colors.mono.menu.marked.background <color|#rrggbb> (default: white)
1997 Default background color.
1998 ui.colors.mono.menu.hotkey (Hotkey)
2000 Menu item hotkey colors.
2001 ui.colors.mono.menu.hotkey.normal (Unselected hotkey)
2004 Menu item unselected hotkey colors.
2005 ui.colors.mono.menu.hotkey.normal.text <color|#rrggbb> (default: gray)
2007 Default text color.
2008 ui.colors.mono.menu.hotkey.normal.background <color|#rrggbb> (default:
2010 black)
2011 Default background color.
2012 ui.colors.mono.menu.hotkey.selected (Selected hotkey)
2014 Menu item selected hotkey colors.
2015 ui.colors.mono.menu.hotkey.selected.text <color|#rrggbb> (default:
2017 gray)
2018 Default text color.
2019 ui.colors.mono.menu.hotkey.selected.background <color|#rrggbb>
2021 (default: black)
2022 Default background color.
2023 ui.colors.mono.menu.frame (Menu frame)
2025 Menu frame colors.
2026 ui.colors.mono.menu.frame.text <color|#rrggbb> (default: black)
2028 Default text color.
2029 ui.colors.mono.menu.frame.background <color|#rrggbb> (default: white)
2031 Default background color.
2032 ui.colors.mono.dialog (Dialog)
2034 Dialog colors.
2035 ui.colors.mono.dialog.generic (Generic)
2038 Generic dialog colors.
2039 ui.colors.mono.dialog.generic.text <color|#rrggbb> (default: black)
2041 Default text color.
2042 ui.colors.mono.dialog.generic.background <color|#rrggbb> (default:
2044 white)
2045 Default background color.
2046 ui.colors.mono.dialog.frame (Frame)
2048 Dialog frame colors.
2049 ui.colors.mono.dialog.frame.text <color|#rrggbb> (default: black)
2051 Default text color.
2052 ui.colors.mono.dialog.frame.background <color|#rrggbb> (default: white)
2054 Default background color.
2055 ui.colors.mono.dialog.scrollbar (Scrollbar)
2057 Scrollbar colors.
2058 ui.colors.mono.dialog.scrollbar.text <color|#rrggbb> (default: white)
2060 Default text color.
2061 ui.colors.mono.dialog.scrollbar.background <color|#rrggbb> (default:
2063 black)
2064 Default background color.
2065 ui.colors.mono.dialog.scrollbar-selected (Selected scrollbar)
2067 Scrollbar selected colors.
2068 ui.colors.mono.dialog.scrollbar-selected.text <color|#rrggbb> (default:
2070 black)
2071 Default text color.
2072 ui.colors.mono.dialog.scrollbar-selected.background <color|#rrggbb>
2074 (default: white)
2075 Default background color.
2076 ui.colors.mono.dialog.title (Title)
2078 Dialog title colors.
2079 ui.colors.mono.dialog.title.text <color|#rrggbb> (default: gray)
2081 Default text color.
2082 ui.colors.mono.dialog.title.background <color|#rrggbb> (default: black)
2084 Default background color.
2085 ui.colors.mono.dialog.text (Text)
2087 Dialog text colors.
2088 ui.colors.mono.dialog.text.text <color|#rrggbb> (default: black)
2090 Default text color.
2091 ui.colors.mono.dialog.text.background <color|#rrggbb> (default: white)
2093 Default background color.
2094 ui.colors.mono.dialog.checkbox (Checkbox)
2096 Dialog checkbox colors.
2097 ui.colors.mono.dialog.checkbox.text <color|#rrggbb> (default: black)
2099 Default text color.
2100 ui.colors.mono.dialog.checkbox.background <color|#rrggbb> (default:
2102 white)
2103 Default background color.
2104 ui.colors.mono.dialog.checkbox-selected (Selected checkbox)
2106 Dialog selected checkbox colors.
2107 ui.colors.mono.dialog.checkbox-selected.text <color|#rrggbb> (default:
2109 white)
2110 Default text color.
2111 ui.colors.mono.dialog.checkbox-selected.background <color|#rrggbb>
2113 (default: black)
2114 Default background color.
2115 ui.colors.mono.dialog.checkbox-label (Checkbox label)
2117 Dialog checkbox label colors.
2118 ui.colors.mono.dialog.checkbox-label.text <color|#rrggbb> (default:
2120 black)
2121 Default text color.
2122 ui.colors.mono.dialog.checkbox-label.background <color|#rrggbb>
2124 (default: white)
2125 Default background color.
2126 ui.colors.mono.dialog.button (Button)
2128 Dialog button colors.
2129 ui.colors.mono.dialog.button.text <color|#rrggbb> (default: black)
2131 Default text color.
2132 ui.colors.mono.dialog.button.background <color|#rrggbb> (default:
2134 white)
2135 Default background color.
2136 ui.colors.mono.dialog.button-selected (Selected button)
2138 Dialog selected button colors.
2139 ui.colors.mono.dialog.button-selected.text <color|#rrggbb> (default:
2141 white)
2142 Default text color.
2143 ui.colors.mono.dialog.button-selected.background <color|#rrggbb>
2145 (default: black)
2146 Default background color.
2147 ui.colors.mono.dialog.button-shortcut (Button shortcut)
2149 Dialog button colors.
2150 ui.colors.mono.dialog.button-shortcut.text <color|#rrggbb> (default:
2152 white)
2153 Default text color.
2154 ui.colors.mono.dialog.button-shortcut.background <color|#rrggbb>
2156 (default: black)
2157 Default background color.
2158 ui.colors.mono.dialog.button-shortcut-selected (Selected button shortcut)
2160 Dialog selected button colors.
2161 ui.colors.mono.dialog.button-shortcut-selected.text <color|#rrggbb>
2163 (default: black)
2164 Default text color.
2165 ui.colors.mono.dialog.button-shortcut-selected.background
2167 <color|#rrggbb> (default: white)
2168 Default background color.
2169 ui.colors.mono.dialog.field (Text field)
2171 Dialog text field colors.
2172 ui.colors.mono.dialog.field.text <color|#rrggbb> (default: gray)
2174 Default text color.
2175 ui.colors.mono.dialog.field.background <color|#rrggbb> (default: black)
2177 Default background color.
2178 ui.colors.mono.dialog.field-text (Text field text)
2180 Dialog field text colors.
2181 ui.colors.mono.dialog.field-text.text <color|#rrggbb> (default: gray)
2183 Default text color.
2184 ui.colors.mono.dialog.field-text.background <color|#rrggbb> (default:
2186 black)
2187 Default background color.
2188 ui.colors.mono.dialog.meter (Meter)
2190 Dialog meter colors.
2191 ui.colors.mono.dialog.meter.text <color|#rrggbb> (default: gray)
2193 Default text color.
2194 ui.colors.mono.dialog.meter.background <color|#rrggbb> (default: black)
2196 Default background color.
2197 ui.colors.mono.dialog.shadow (Shadow)
2199 Dialog shadow colors (see ui.shadows option).
2200 ui.colors.mono.dialog.shadow.text <color|#rrggbb> (default: black)
2202 Default text color.
2203 ui.colors.mono.dialog.shadow.background <color|#rrggbb> (default:
2205 black)
2206 Default background color.
2207 ui.colors.mono.title (Title bar)
2209 Title bar colors.
2210 ui.colors.mono.title.title-bar (Generic title bar)
2213 Generic title bar colors.
2214 ui.colors.mono.title.title-bar.text <color|#rrggbb> (default: gray)
2216 Default text color.
2217 ui.colors.mono.title.title-bar.background <color|#rrggbb> (default:
2219 black)
2220 Default background color.
2221 ui.colors.mono.title.title-text (Title bar text)
2223 Title bar text colors.
2224 ui.colors.mono.title.title-text.text <color|#rrggbb> (default: gray)
2226 Default text color.
2227 ui.colors.mono.title.title-text.background <color|#rrggbb> (default:
2229 black)
2230 Default background color.
2231 ui.colors.mono.status (Status bar)
2233 Status bar colors.
2234 ui.colors.mono.status.status-bar (Generic status bar)
2237 Generic status bar colors.
2238 ui.colors.mono.status.status-bar.text <color|#rrggbb> (default: black)
2240 Default text color.
2241 ui.colors.mono.status.status-bar.background <color|#rrggbb> (default:
2243 white)
2244 Default background color.
2245 ui.colors.mono.status.status-text (Status bar text)
2247 Status bar text colors.
2248 ui.colors.mono.status.status-text.text <color|#rrggbb> (default: black)
2250 Default text color.
2251 ui.colors.mono.status.status-text.background <color|#rrggbb> (default:
2253 white)
2254 Default background color.
2255 ui.colors.mono.tabs (Tabs bar)
2257 Tabs bar colors.
2258 ui.colors.mono.tabs.unvisited (Unvisited tab)
2261 Tab colors for tabs that have not been selected since they completed
2262 loading.
2263 ui.colors.mono.tabs.unvisited.text <color|#rrggbb> (default: gray)
2265 Default text color.
2266 ui.colors.mono.tabs.unvisited.background <color|#rrggbb> (default:
2268 white)
2269 Default background color.
2270 ui.colors.mono.tabs.normal (Unselected tab)
2272 Unselected tab colors.
2273 ui.colors.mono.tabs.normal.text <color|#rrggbb> (default: black)
2275 Default text color.
2276 ui.colors.mono.tabs.normal.background <color|#rrggbb> (default: white)
2278 Default background color.
2279 ui.colors.mono.tabs.loading (Loading tab)
2281 Tab colors for tabs that are loading in the background.
2282 ui.colors.mono.tabs.loading.text <color|#rrggbb> (default: gray)
2284 Default text color.
2285 ui.colors.mono.tabs.loading.background <color|#rrggbb> (default: white)
2287 Default background color.
2288 ui.colors.mono.tabs.selected (Selected tab)
2290 Selected tab colors.
2291 ui.colors.mono.tabs.selected.text <color|#rrggbb> (default: gray)
2293 Default text color.
2294 ui.colors.mono.tabs.selected.background <color|#rrggbb> (default:
2296 black)
2297 Default background color.
2298 ui.colors.mono.tabs.separator (Tab separator)
2300 Tab separator colors.
2301 ui.colors.mono.tabs.separator.text <color|#rrggbb> (default: gray)
2303 Default text color.
2304 ui.colors.mono.tabs.separator.background <color|#rrggbb> (default:
2306 white)
2307 Default background color.
2308 ui.colors.mono.searched (Searched strings)
2310 Searched string highlight colors.
2311 ui.colors.mono.searched.text <color|#rrggbb> (default: black)
2313 Default text color.
2314 ui.colors.mono.searched.background <color|#rrggbb> (default: white)
2316 Default background color.
2317 ui.dialogs (Dialog settings)
2319 Dialogs-specific appearance and behaviour settings.
2320 ui.dialogs.listbox_min_height <num> (default: 10)
2322 Minimal height of the listbox widget (used e.g. for bookmarks or
2323 global history).
2324 ui.dialogs.shadows [0|1] (default: 0)
2326 Make dialogs drop shadows (the shadows are solid, you can adjust
2327 their color by ui.colors.*.dialog.shadow). You may also want to
2328 eliminate the wide borders by adjusting setup.h.
2329 ui.dialogs.underline_hotkeys [0|1] (default: 0)
2331 Whether to underline hotkeys in menus to make them more visible.
2332 Requires that underlining is enabled for the terminal.
2333 ui.dialogs.underline_button_shortcuts [0|1] (default: 0)
2335 Whether to underline button shortcuts to make them more visible.
2336 Requires that underlining is enabled for the terminal.
2337 ui.leds (LEDs)
2339 LEDs (visual indicators) options.
2340 ui.leds.enable [0|1] (default: 1)
2342 Enable LEDs. These visual indicators will inform you about various
2343 states.
2344 ui.sessions (Sessions)
2346 Sessions settings.
2347 ui.sessions.auto_restore [0|1] (default: 0)
2349 Automatically restore the session at start.
2350 This feature requires bookmark support.
2352 ui.sessions.auto_save [0|1] (default: 0)
2354 Automatically save the session when quitting.
2355 This feature requires bookmark support.
2357 ui.sessions.auto_save_foldername <str> (default: "Auto saved session")
2359 Name of the bookmarks folder used for auto saving and restoring
2360 session. The name has to be unique. Any folders with the same name
2361 will be deleted.
2362 This only makes sense with bookmark support.
2364 ui.sessions.homepage <str> (default: "")
2366 The URI to load either at startup time when no URI was given on the
2367 command line or when requested by the goto-url-home action. Set to
2368 "" if the environment variable WWW_HOME should be used as homepage
2369 URI instead.
2370 ui.sessions.keep_session_active [0|1] (default: 0)
2372 Keep the session active even if the last terminal exits.
2373 ui.sessions.snapshot [0|1] (default: 0)
2375 Automatically save a snapshot of all tabs periodically. This will
2376 periodically bookmark the tabs of each terminal in a separate
2377 folder for recovery after a crash.
2378 This feature requires bookmark support.
2380 ui.tabs (Window tabs)
2382 Window tabs settings.
2383 ui.tabs.show_bar <num> (default: 1)
2385 Show tabs bar on the screen:
2386 • 0 means never
2388 • 1 means only if two or more tabs are open
2390 • 2 means always
2392 ui.tabs.top [0|1] (default: 0)
2394 Whether display tab bar at top like other browsers do.
2395 ui.tabs.wraparound [0|1] (default: 1)
2397 When moving right from the last tab, jump to the first one, and
2398 vice versa.
2399 ui.tabs.confirm_close [0|1] (default: 0)
2401 When closing a tab show confirmation dialog.
2402 ui.timer (Timer options)
2404 Timed action after certain interval of user inactivity. Someone can
2405 even find this useful, although you may not believe that.
2406 ui.timer.enable <num> (default: 0)
2408 Whether to enable the timer or not:
2409 • 0 is don´t count down anything
2411 • 1 is count down, but don´t show the timer
2413 • 2 is count down and show the timer near LEDs
2415 ui.timer.duration <num> (default: 86400)
2417 Inactivity timeout in seconds. The maximum of one day should be
2418 enough for just everyone (TM).
2419 ui.timer.action <str> (default: "")
2421 Keybinding action to be triggered when timer reaches zero.
2422
2424 elinks(1), elinkskeys(5)
2425ELinks 0.13.GIT 07/11/2009 ELINKS.CONF(5)