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, You can use something like	960