NetSurf Options


From SamyGO
Revision as of 17:47, 27 July 2011 by Erdem ua (talk | contribs) (Fixed old forums links.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The Options file, located in subdirectory framebuffer/res, can be used to customize the behavior of the NetSurf Web Browser for SamyGO.

General information

The Options file is a simple text file which can be edited with any decent text editor.

Warning: The file must have UNIX-style line endings and must be saved in the UTF-8 encoding.

Windows users: Notepad is not a decent text editor. It cannot read or save UNIX-style line endings. Use another editor (e.g. Notepad++, PSPad, Textpad, UltraEdit, Crimson Editor) and make sure that the line endings and encoding settings are setup correctly when saving the file.

The file format is one option per line, with option name and value separated with a colon, like this:

option_name:option_value

Important: Please add an empty line at the beginning and the end of the file. Otherwise the first and last line might not be read correctly.

Basics

Most options have useful default values, so you don't need to set them in the Options file. A basic option file can be as simple as this:

window_width:960
window_height:540
homepage_url:http://www.netsurf-browser.org/welcome/
fb_mouse_delay:50

These options do the following things:

Option name Description Default value
window_width Sets the graphics mode width. Warning: 960 is the maximum value that will work. 960
window_height Sets the graphics mode height. Warning: 540 is the maximum value that will work. 540
homepage_url The URL of the home page. You may want to export a bookmarks.html from your desktop browser, save it to your NetSurf directory and use something like file:/dtv/usb/sda1/NetSurf/bookmarks.html. http://www.netsurf-browser.org/welcome/
fb_mouse_delay Delays mouse motion by up to X milliseconds. A non-zero value is needed because the ARM processor in the Samsung TV is not very fast and cannot keep up with mice reporting every single pixel of motion. 50
fb_search_url The URL of the preferred search page. It will be copied to the URL bar when "Search" is clicked in the menu, and you can then append your search term.

The default setting uses Google.

http://google.com/search?q=
fb_help_url The URL of the help page. http://wiki.samygo.tv/?title=NetSurf_Web_Browser
fb_log_enabled Enables output of logging information to the file output.log. If you experience problems or crashes while surfing the Web, please enable logging and post a log file to the forum. 1 (=enabled)

Virtual Keyboard

This set of options controls the virtual keyboard (VKB), which can be used to enter text with a TV remote only.

Option name Description Default value
fb_vkb_enabled Is the VKB enabled? Set to 0 to disable it entirely, if you always have a keyboard and mouse connected. 1
fb_vkb_timeout_ms Timeout in milliseconds after which the character currently being composed will be inserted into the text. 1500
fb_vkb_0 A list of all characters that can be entered using the '0' button of the TV remote.  .,!?
fb_vkb_1 A list of all characters that can be entered using the '1' button of the TV remote. :/@$&
fb_vkb_2 A list of all characters that can be entered using the '2' button of the TV remote. abc
fb_vkb_3 A list of all characters that can be entered using the '3' button of the TV remote. def
fb_vkb_4 A list of all characters that can be entered using the '4' button of the TV remote. ghi
fb_vkb_5 A list of all characters that can be entered using the '5' button of the TV remote. jkl
fb_vkb_6 A list of all characters that can be entered using the '6' button of the TV remote. mno
fb_vkb_7 A list of all characters that can be entered using the '7' button of the TV remote. pqrs
fb_vkb_8 A list of all characters that can be entered using the '8' button of the TV remote. tuv
fb_vkb_9 A list of all characters that can be entered using the '9' button of the TV remote. wxyz

An example for an adapted VKB configuration for German users is:

fb_vkb_enabled:1
fb_vkb_0: .,!?0
fb_vkb_1::/-@€&1
fb_vkb_2:abcä2
fb_vkb_3:def3
fb_vkb_4:ghi4
fb_vkb_5:jkl5
fb_vkb_6:mnoö6
fb_vkb_7:pqrsß7
fb_vkb_8:tuvü8
fb_vkb_9:wxyz9

Other options

There are a lot of other options possibly recognized by NetSurf. (However, some may do nothing at all in the the SamyGO version. Some may cause the browser to crash and the TV to reboot. You have been warned.) I haven't tried any of them so far. If you find out what they do (looking at the NetSurf Source might help) please send your info to the forum or - even better - add it directly here in the Wiki.

Type Option name Description
bool http_proxy
string http_proxy_host
int http_proxy_port
int http_proxy_auth
string http_proxy_auth_user
string http_proxy_auth_pass
int font_size tested on a LE37B650 CI+ TV: values from 100 to 1000 scale the font size from 100% to 1000%. A value of 200 displays a well readable font size.
int font_min_size tested a bit on a LE37B650 CI+ TV: did not recognize real font size changes but line spacing changes
string accept_language
string accept_charset
int memory_cache_size
int disc_cache_age
bool block_ads
int minimum_gif_delay
bool send_referer
bool animate_images
int expire_url
int font_default a css_font_family
string ca_bundle
string ca_path
string cookie_file
string cookie_jar
bool target_blank
bool button_2_tab
bool url_suggestion
int toolbar_status_width
int scale
bool incremental_reflow
unsigned int min_reflow_period
int margin_top
int margin_bottom
int margin_left
int margin_right
int export_scale
bool suppress_images
bool remove_backgrounds
bool enable_loosening
int max_fetchers
int max_fetchers_per_host
int max_cached_fetch_handles