NetSurf Options
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
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=
|
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 '8' 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 | ||||
| int | font_min_size | ||||
| 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 |
