SamyGO - User contributions [en]

NetSurf Source

2010-08-21T21:30:35Z

Ffischer: /* Compilation instructions */

The [[NetSurf_Web_Browser]] is Open Source and licensed under the GPL.
Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

== Compilation instructions ==
#setup environment (install a cross compiler)
#*The easiest way is to use the OpenEmbedded toolchain. Some information about that is available at the [[SamyGO OpenEmbedded]] page. The toolchain is built with the <code>make Toolchain</code> command.
#*If you don't want to use OpenEmbedded, you will need to compile a cross compiler manually, instructions can be found at [[Setting up a cross-compilation toolchain]].
#compile (in the cross compile environment) and <code>make install</code> the required dependency libraries:
#*libiconv
#*zlib
#*libjpeg
#*libpng
#*libxml2
#*libidn
#*(openssl)
#*curl
#*SamyGO libSDL
#setup environment for netsurf compilation
#:<code>#!/bin/sh</code>
#:<code>#export PATH=/usr/local/arm-linux-gnueabi/bin:$PATH</code>
#:<code>export PKGCONFIG=arm-linux-gnueabi-pkg-config</code>
#:<code>export PKG_CONFIG=arm-linux-gnueabi-pkg-config</code>
#:<code>export XML2_CONFIG=/usr/local/arm-linux-gnueabi/bin/xml2-config</code>
#:<code>export CC=arm-linux-gnueabi-gcc</code>
#:<code>export CXX=arm-linux-gnueabi-g++</code>
#:<code>export LD=arm-linux-gnueabi-ld</code>
#:<code>export STRIP=arm-linux-gnueabi-strip</code>
#:<code>export AR=arm-linux-gnueabi-ar</code>
#:<code>export HOST_CC=/usr/bin/gcc</code>
#:<code>export CFLAGS="-fPIC -O2 -D_REENTRANT"</code>
#:<code>export CXXFLAGS="-fPIC -O2 -D_REENTRANT"</code>
#:<code>export PREFIX=/usr/local/arm-linux-gnueabi</code>
#:<code># turns off silencing of compiler commands in netsurf compilation</code>
#:<code>export Q=</code>
#compile and <code>make install</code> netsurf member libraries
#:(each time: <code>make HOST=SamsungDTV; make HOST=SamsungDTV install</code>)
#*libparserutils
#*libwapcaplet
#*libnsbmp
#*libnsgif
#*libnsfb
#*libcss
#*hubbub
#compile netsurf
#:<code>make HOST=SamsungDTV TARGET=framebuffer</code>

==Hacking guide==
The browser core is in the 'content', 'css,' 'desktop', 'render', and 'image' subdirectories of the project. I have avoided touching it (if possible) while porting the browser for SamyGO.

The GUI and frontend code is in the framebuffer subdirectory. Unfortunately, compared to the other NetSurf ports (see the 'gtk', 'amiga' or 'riscos' subdirs, for example) it's quite incomplete and missing lots of useful features.
I have worked on implementing some of them, but a lot remains to be done (e.g. file downloads and bookmarks).
A good starting point would be the empty functions at the bottom of <code>fb_gui.c</code>.

If you have anything useful, please make a patch towards the latest released source code version (see top of page) and send it to florianfischer at gmx.de.

NetSurf Source

2010-08-21T21:20:08Z

Ffischer: /* Compilation instructions */

The [[NetSurf_Web_Browser]] is Open Source and licensed under the GPL.
Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

== Compilation instructions ==
#setup environment (install cross compiler)
#compile and <code>make install</code> required dependency libraries:
#*libiconv
#*zlib
#*libjpeg
#*libpng
#*libxml2
#*libidn
#*(openssl)
#*curl
#*SamyGO libSDL
#setup environment for netsurf compilation
#:<code>#!/bin/sh</code>
#:<code>#export PATH=/usr/local/arm-linux-gnueabi/bin:$PATH</code>
#:<code>export PKGCONFIG=arm-linux-gnueabi-pkg-config</code>
#:<code>export PKG_CONFIG=arm-linux-gnueabi-pkg-config</code>
#:<code>export XML2_CONFIG=/usr/local/arm-linux-gnueabi/bin/xml2-config</code>
#:<code>export CC=arm-linux-gnueabi-gcc</code>
#:<code>export CXX=arm-linux-gnueabi-g++</code>
#:<code>export LD=arm-linux-gnueabi-ld</code>
#:<code>export STRIP=arm-linux-gnueabi-strip</code>
#:<code>export AR=arm-linux-gnueabi-ar</code>
#:<code>export HOST_CC=/usr/bin/gcc</code>
#:<code>export CFLAGS="-fPIC -O2 -D_REENTRANT"</code>
#:<code>export CXXFLAGS="-fPIC -O2 -D_REENTRANT"</code>
#:<code>export PREFIX=/usr/local/arm-linux-gnueabi</code>
#:<code># turns off silencing of compiler commands in netsurf compilation</code>
#:<code>export Q=</code>
#compile and <code>make install</code> netsurf member libraries
#:(each time: <code>make HOST=SamsungDTV; make HOST=SamsungDTV install</code>)
#*libparserutils
#*libwapcaplet
#*libnsbmp
#*libnsgif
#*libnsfb
#*libcss
#*hubbub
#compile netsurf
#:<code>make HOST=SamsungDTV TARGET=framebuffer</code>

==Hacking guide==
The browser core is in the 'content', 'css,' 'desktop', 'render', and 'image' subdirectories of the project. I have avoided touching it (if possible) while porting the browser for SamyGO.

The GUI and frontend code is in the framebuffer subdirectory. Unfortunately, compared to the other NetSurf ports (see the 'gtk', 'amiga' or 'riscos' subdirs, for example) it's quite incomplete and missing lots of useful features.
I have worked on implementing some of them, but a lot remains to be done (e.g. file downloads and bookmarks).
A good starting point would be the empty functions at the bottom of <code>fb_gui.c</code>.

If you have anything useful, please make a patch towards the latest released source code version (see top of page) and send it to florianfischer at gmx.de.

NetSurf Source

2010-08-21T21:12:07Z

Ffischer: /* Compilation instructions */

The [[NetSurf_Web_Browser]] is Open Source and licensed under the GPL.
Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

== Compilation instructions ==
#setup environment (install cross compiler)
#compile and <code>make install</code> required dependency libraries:
**libiconv
**zlib
**libjpeg
**libpng
**libxml2
**libidn
**(openssl)
**curl
**SamyGO libSDL
#setup environment for netsurf compilation
<pre>
#!/bin/sh
#export PATH=/usr/local/arm-linux-gnueabi/bin:$PATH
export PKGCONFIG=arm-linux-gnueabi-pkg-config
export PKG_CONFIG=arm-linux-gnueabi-pkg-config
export XML2_CONFIG=/usr/local/arm-linux-gnueabi/bin/xml2-config
export CC=arm-linux-gnueabi-gcc
export CXX=arm-linux-gnueabi-g++
export LD=arm-linux-gnueabi-ld
export STRIP=arm-linux-gnueabi-strip
export AR=arm-linux-gnueabi-ar
export HOST_CC=/usr/bin/gcc
export CFLAGS="-fPIC -O2 -D_REENTRANT"
export CXXFLAGS="-fPIC -O2 -D_REENTRANT"
export PREFIX=/usr/local/arm-linux-gnueabi
# turns off silencing of compiler commands in netsurf compilation
export Q=
</pre>
#compile and <code>make install</code> netsurf member libraries
(each time: <code>make HOST=SamsungDTV; make HOST=SamsungDTV install</code>)
**libparserutils
**libwapcaplet
**libnsbmp
**libnsgif
**libnsfb
**libcss
**hubbub
#compile netsurf
<code>make HOST=SamsungDTV TARGET=framebuffer</code>

==Hacking guide==
The browser core is in the 'content', 'css,' 'desktop', 'render', and 'image' subdirectories of the project. I have avoided touching it (if possible) while porting the browser for SamyGO.

The GUI and frontend code is in the framebuffer subdirectory. Unfortunately, compared to the other NetSurf ports (see the 'gtk', 'amiga' or 'riscos' subdirs, for example) it's quite incomplete and missing lots of useful features.
I have worked on implementing some of them, but a lot remains to be done (e.g. file downloads and bookmarks).
A good starting point would be the empty functions at the bottom of <code>fb_gui.c</code>.

If you have anything useful, please make a patch towards the latest released source code version (see top of page) and send it to florianfischer at gmx.de.

NetSurf Bookmarks

2010-03-29T22:06:29Z

Ffischer:

The <code>Bookmarks</code> file, located in subdirectory <code>framebuffer/res</code>, contains informations about bookmarks set in the [[NetSurf Web Browser]] for SamyGO.

Currently, you can add new bookmarks from within the browser, but if you want to modify or delete existing bookmarks or change the bookmark groups, you will need to edit the <code>Bookmarks</code> file.

==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 contains a number of bookmark groups, which are written like:
<pre>[groupname]</pre>

Each group contains a list of bookmarks, where each bookmark is written in two lines:
<pre>URL
Title</pre>

'''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.

==Example==

You can use the following bookmark file as a starting point:
<pre>
[Unsorted]

[Samples]
http://www.google.de/
Google
http://en.wikipedia.org/wiki/Main_Page
Wikipedia, the free encyclopedia

[NetSurf / SamyGO]
http://wiki.samygo.tv/?title=NetSurf_Web_Browser
Help for NetSurf (Wiki)
http://www.netsurf-browser.org/
NetSurf Homepage
http://forum.samygo.tv/viewtopic.php?f=5&t=403
NetSurf Forum thread
http://samygo.sourceforge.net/
SamyGO Homepage
</pre>

==Limitations==

Currently, groups cannot be nested.
Also, you cannot put bookmarks outside of any group.
NetSurf cannot display more than 20 groups or more than 20 entries within each group.

NetSurf Bookmarks

2010-03-29T22:05:11Z

Ffischer: Created page with 'The <code>Bookmarks</code> file, located in subdirectory <code>framebuffer/res</code>, contains informations about bookmarks set in the NetSurf Web Browser for SamyGO. Curreâ¦'

The <code>Bookmarks</code> file, located in subdirectory <code>framebuffer/res</code>, contains informations about bookmarks set in the [[NetSurf Web Browser]] for SamyGO.

Currently, you can add new bookmarks from within the browser, but if you want to modify or delete existing bookmarks or change the bookmark groups, you will need to edit the <code>Bookmarks</code> file.

==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 contains a number of bookmark groups, which are written as
<pre>[groupname]</pre>.

Each group contains a list of bookmarks, where each bookmark is written in two lines:
<pre>URL
Title</pre>.

'''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.

==Example==

You can use the following bookmark file as a starting point:
<pre>
[Unsorted]

[Samples]
http://www.google.de/
Google
http://en.wikipedia.org/wiki/Main_Page
Wikipedia, the free encyclopedia

[NetSurf / SamyGO]
http://wiki.samygo.tv/?title=NetSurf_Web_Browser
Help for NetSurf (Wiki)
http://www.netsurf-browser.org/
NetSurf Homepage
http://forum.samygo.tv/viewtopic.php?f=5&t=403
NetSurf Forum thread
http://samygo.sourceforge.net/
SamyGO Homepage
</pre>

==Limitations==

Currently, groups cannot be nested.
Also, you cannot put bookmarks outside of any group.
NetSurf cannot display more than 20 groups or more than 20 entries within each group.

NetSurf Options

2010-03-29T21:55:29Z

Ffischer: /* Basics */

The <code>Options</code> file, located in subdirectory <code>framebuffer/res</code>, 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:
<pre>option_name:option_value
</pre>

'''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:
<pre>
window_width:960
window_height:540
homepage_url:http://www.netsurf-browser.org/welcome/
fb_mouse_delay:50

</pre>

These options do the following things:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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 <code>bookmarks.html</code> from your desktop browser, save it to your NetSurf directory and use something like <code>file:/dtv/usb/sda1/NetSurf/bookmarks.html</code>.
| 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.
| <code>http://google.com/search?q=</code>
|-
| fb_help_url
| The URL of the help page.
| <code>http://wiki.samygo.tv/?title=NetSurf_Web_Browser</code>
|-
| fb_log_enabled
| Enables output of logging information to the file <code>output.log</code>. 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.

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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.
| <code> .,!?</code>
|-
| fb_vkb_1
| A list of all characters that can be entered using the '1' button of the TV remote.
| <code>:/@$&</code>
|-
| fb_vkb_2
| A list of all characters that can be entered using the '2' button of the TV remote.
| <code>abc</code>
|-
| fb_vkb_3
| A list of all characters that can be entered using the '3' button of the TV remote.
| <code>def</code>
|-
| fb_vkb_4
| A list of all characters that can be entered using the '4' button of the TV remote.
| <code>ghi</code>
|-
| fb_vkb_5
| A list of all characters that can be entered using the '5' button of the TV remote.
| <code>jkl</code>
|-
| fb_vkb_6
| A list of all characters that can be entered using the '6' button of the TV remote.
| <code>mno</code>
|-
| fb_vkb_7
| A list of all characters that can be entered using the '7' button of the TV remote.
| <code>pqrs</code>
|-
| fb_vkb_8
| A list of all characters that can be entered using the '8' button of the TV remote.
| <code>tuv</code>
|-
| fb_vkb_9
| A list of all characters that can be entered using the '9' button of the TV remote.
| <code>wxyz</code>
|}

An example for an adapted VKB configuration for German users is:
<pre>
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

</pre>

==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 [http://forum.samygo.tv/viewtopic.php?f=5&t=403 forum] or - even better - add it directly here in the Wiki.

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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
|
|}

NetSurf Web Browser

2010-03-29T21:50:06Z

Ffischer:

Small as a mouse, fast as a cheetah and available for free. NetSurf is a multi-platform web browser for RISC OS and UNIX-like platforms, including Linux, and more. For more information, visit the [http://www.netsurf-browser.org/ NetSurf homepage].

This version is a port of NetSurf to the current Samsung Digital TV platform as part of the SamyGO project.

==Features==
* it's very speedy, portable and written in plain C
* a basic port to an SDL based framebuffer already existed - which I'm building on. However this version lacks lots of features which other ports (e.g. GTK port) already have.
* it has good HTML and decent CSS support (CSS1 only)
* it hasn't got any support for JavaScript, plugins or Flash

==Download and Installation==
===System requirements===
* Recent Samsung TV based on ARM/Linux architecture
* Gallery must be available
* Games section must be available within the Gallery
* A compatible firmware version must be running (not the latest ones, which were released in 2010)
===Installation===
* Download the browser [http://rrobek.de/download/NetSurf.tgz here].
* Unpack attached TGZ to the root folder of a USB stick. Now you should have a NetSurf folder in there.
* Plug the USB stick to your TV
* open gallery
* goto "manage applications" --> "games"
* run the 'NetSurf browser'

==Usage==
The SamyGO version of NetSurf has been specially adapted to the TV environment and can be used in two ways.
===Using a normal keyboard and mouse===
NetSurf can be operated like any PC web browser, using a keyboard and mouse.
You will need to run the SamyGO keyboard and mouse extension before starting the browser and plug in a USB keyboard and mouse (if possible, cordless...)

The supported keyboard shortcuts are:

{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Action
|-
| Home
| Opens the main menu
|-
| F1
| Go back in the history
|-
| F2
| Switch navigation mode
|-
| PgUp/PgDn
| Scroll by a page
|-
| Cursor
| Move to next link / scroll (depending on navigation mode)
|}

If you always use a keyboard and mouse, you may want to disable the [[NetSurf Options#Virtual keyboard]].

===Using the TV's remote===
Alternatively, you can use NetSurf with the TV remote only.
There are limits in how applications can access the TV remote, so please read the following section carefully.

====Normal navigation====
*The red button opens the menu (see below)
*The green button is the "History: Back" function
*You can switch between different navigation modes (for the arrow keys) using the yellow button.
**Link navigation (default) moves the cursor to the next link
**Page Scroll and Scroll modes scroll around (duh)
**Pointer mode moves the "mouse" pointer
**Press yellow button again to return to Link navigation mode.
*The Enter key (in the middle of the arrow keys) activates links or edits HTML form elements.
*Press blue button to exit Netsurf and return to the Gallery.

'''Warning:''' Do not press any other buttons on the remote - strange things have happened for me while testing, although I'm now trying to exit NetSurf on any other button press.
You can usually recover by pressing the "TV" button, then "Content", then "TV" again.

====Menu====
Press one of the number keys to activate one of the menu options.
In long menus, Press the 'up' or 'down' keys to switch between the menu options.

====Virtual keyboard====
You can enter text and URLs using the virtual keyboard (VKB) function.
When the URL widget or a HTML form element is focused, the VKB will be activated.
The VKB status is displayed at the right side of the URL bar.
In VKB mode, the keys are used differently:
*The red button still opens the menu
*The green button deletes the last character (like "Backspace" at the PC)
*Switch between different VKB modes using the yellow button.
*Press the number keys repeatedly to input numbers, lowercase or uppercase letters and symbols. The currently composed letter is displayed in the VKB status widget.
By default, the letters are mapped much like on a English mobile phone (see also following table), but the mapping can be changed using [[NetSurf Options#Virtual keyboard]].
* '''Note:''' Press the number keys slowly (about once per second), otherwise the remote control will interpret this as a continuous press and the letters will start spinning around much faster than you want to.

The default key mapping is:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Letters
|-
| 0
| Space . , ! ?
|-
| 1
| : / @ $ &
|-
| 2
| a b c
|-
| 3
| d e f
|-
| 4
| g h i
|-
| 5
| j k l
|-
| 6
| m n o
|-
| 7
| p q r s
|-
| 8
| t u v
|-
| 9
| w x y z
|}

===Note===
Please discuss any questions in the SamyGO forum, using the [http://forum.samygo.tv/viewtopic.php?f=5&t=403 NetSurf thread].

==Fonts / International Text==

The default fonts which are delivered along with NetSurf are the Bitstream Vera fonts. They are freely distributable, but they only have Western European characters. (You will see little squares for all 'foreign' characters.)

So, if you want to surf to web pages written in other languages or if you just don't like the default fonts, you can exchange the font files like this:

*copy any better font from your PC (must be in TTF format, on windows you'll find them in <code>c:\windows\fonts</code>)
*place them in the <code>framebuffer/res</code> subdirectory of your 'NetSurf' directory
*and rename them so that they replace the existing files.

For example, if you want to use ''Arial'' and ''Times New Roman'':
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Rename from
! to
|-
| arial.ttf
| sans_serif.ttf
|-
| arialbd.ttf
| sans_serif_bold.ttf
|-
| ... etc...
|
|-
| times.ttf
| serif.ttf
|-
| ... etc..
|
|}

==Configuration (Options file)==

NetSurf can be configured by editing the file <code>NetSurf/framebuffer/res/Options</code>.
The possibilities are documented in the sub-page [[NetSurf Options]].

==Bookmarks (Bookmarks file)==

The newest version of NetSurf now has a simple bookmarks system.
The bookmarks are listed in the file <code>NetSurf/framebuffer/res/Bookmarks</code>.
The possibilities are documented in the sub-page [[NetSurf Bookmarks]].

==Source code==

NetSurf is Open Source and licensed under the GPL. Source code and building instructions are available on the [[NetSurf Source]] site.

NetSurf Options

2010-03-28T20:09:07Z

Ffischer:

The <code>Options</code> file, located in subdirectory <code>framebuffer/res</code>, 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:
<pre>option_name:option_value
</pre>

'''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:
<pre>
window_width:960
window_height:540
homepage_url:http://www.netsurf-browser.org/welcome/
fb_mouse_delay:50

</pre>

These options do the following things:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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 <code>bookmarks.html</code> from your desktop browser, save it to your NetSurf directory and use something like <code>file:/dtv/usb/sda1/NetSurf/bookmarks.html</code>.
| 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.
| <code>http://google.com/search?q=</code>
|}

==Virtual Keyboard==

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

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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.
| <code> .,!?</code>
|-
| fb_vkb_1
| A list of all characters that can be entered using the '1' button of the TV remote.
| <code>:/@$&</code>
|-
| fb_vkb_2
| A list of all characters that can be entered using the '2' button of the TV remote.
| <code>abc</code>
|-
| fb_vkb_3
| A list of all characters that can be entered using the '3' button of the TV remote.
| <code>def</code>
|-
| fb_vkb_4
| A list of all characters that can be entered using the '4' button of the TV remote.
| <code>ghi</code>
|-
| fb_vkb_5
| A list of all characters that can be entered using the '5' button of the TV remote.
| <code>jkl</code>
|-
| fb_vkb_6
| A list of all characters that can be entered using the '6' button of the TV remote.
| <code>mno</code>
|-
| fb_vkb_7
| A list of all characters that can be entered using the '7' button of the TV remote.
| <code>pqrs</code>
|-
| fb_vkb_8
| A list of all characters that can be entered using the '8' button of the TV remote.
| <code>tuv</code>
|-
| fb_vkb_9
| A list of all characters that can be entered using the '9' button of the TV remote.
| <code>wxyz</code>
|}

An example for an adapted VKB configuration for German users is:
<pre>
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

</pre>

==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 [http://forum.samygo.tv/viewtopic.php?f=5&t=403 forum] or - even better - add it directly here in the Wiki.

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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
|
|}

Main Page

2010-03-14T21:31:01Z

Ffischer: /* Software Tools */

== Welcome to SamyGo WiKi ==
Unfortunately, SourceForge doesn't allow users to write on wiki. We needed to assign writing permission by hand.

'''First''' you needed to give a vote "thumb up" for this idea for make [http://sourceforge.net/apps/ideatorrent/sourceforge/ideatorrent/idea/172/ SourceForge to allow all users has write access to wiki].

'''After''' After you can place note for editing permissions by hand on request from forum ([http://forum.samygo.tv/ucp.php?i=pm&mode=compose&u=68 Erdem_ua] or [http://forum.samygo.tv/ucp.php?i=pm&mode=compose&u=78 dynamic1969]).

[[File:Logo.png]]

== Compatibility Overview ==

See the [[Compatibility]] page to see which TV models should work.

== Safety Measures ( which you shouldn't start without ) ==
#Have a working [[Enable Serial Console on non CI+ Devices|Ex-Link cable]] at hand.
#Ensure the backup exe.img ( stored on /dev/tbml10 ) is in good condition ( and ideally not altered. )
#Ensure your RS232 Setting in the Service-Menu is set to "debug".
#Know that your TV will reset RS232 jack back to UART mode after new firmware installation or reverting back to old version.
 

== Useful WIKI articles ==
*[[Is my TV supported?]]
*[[Is this tools avoids my warranty?]]
===Firmware Modification===
*[[Flashing Hacked Firmware to CI+ devices]]
*[[How to capture channel (PVR functionality)]]
*[[How to enable Telnet on samsung TV's]]
*[[How to enable Telnet/NFS/CIFS/SAMBA]]
*[[Enable Serial Console on non CI+ Devices]]
*[[Getting access to uBoot / bootloader]]
*[[Dumping and Flashing images by hand]]
*[[Open backdoor for fixing bootloop situations]]
*[[Mounting an NFS share on a USB device to bypass DLNA]]
*[[Mounting an CIFS/SAMBA share on a USB device to bypass DLNA]]
*[[Samsung A Series (2008 Model) Hacks]]
*[[Samsung A Series (sh4 CPU) Hacks]]
*[[Video AR Fix]]
*[[Playing with Firmware Images]]
*[[Enable Wiselink Movie on B5 Series Devices]]

===Software Tools===
*[[Setting up a native-compilation toolchain]]
*[[Setting up a cross-compilation toolchain]]
*[[SamyGO OpenEmbedded]]
*[[SamyGO Telnet Enabler]]
*[[SamyGO Extensions Pack]]
*[[SamyGO ChanEdit - Chanel Editor]]
*[[SamyGO Firmware Patcher]]
*[[NetSurf Web Browser]]

===General Information===
*[[Frequently Asked Questions]]
*[[Recovery of Bricked Device]]
*[[Service Manuals]]
*[[Service Menu]]
*[[Engineering Codes]]
*[[Media Play and DLNA]]
*[[Samsung channel list format]]
 

== Interesting Reference Material ==
*[http://www.samsung.com/global/business/semiconductor/products/flash/Products_RFS_ApplicationNotes.html Introduction to SAMSUNG's Linux Flash File System - RFS]
The file-system used in the the recent Samsung TVs is "RFS". Its proprietary nature and consequently so the absence of an according Linux RFS-Module in the standard Linux distributions makes it currently impossible to modify files by simply mounting the respective image as "RW", modifying it and saving the respective image again. This is the reason why currently all changes are done via patching of the image-binaries.
*[http://www.samsung.com/global/business/semiconductor/products/flash/Products_RFS_PortingGuide.html Linux RFS ( Robust FAT File System ) Porting Guide]
The information provided here should help, that we get a RFS module compiled for our common Linux distributions

*[http://www.samsung.com/global/opensource/ Samsung's Source Code]
All the source code Samsung is legally obliged to post can be found here.

*[http://forums.cnet.com/samsung-forum/ Official Samsung Forums]
Should be able to find useful info somewhere.

== Disclaimer ==
Neither this WIKI/Forum nor the author(s) of articles and information provided accept any responsibility for damage that may be caused by use of the information provided. You do everything at your own risk. Be aware that "hacking" activities do void your warranty!
 Tested on UExxB70xx, LExxB65x and compatible devices only.

[[Crew List]]

NetSurf Options

2010-03-14T21:25:21Z

Ffischer: /* Other options */

The <code>Options</code> file, located in subdirectory <code>framebuffer/res</code>, 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:
<pre>option_name:option_value
</pre>

==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:
<pre>window_width:960
window_height:540
homepage_url:http://www.netsurf-browser.org/welcome/
fb_mouse_delay:50
</pre>

These options do the following things:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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 <code>bookmarks.html</code> from your desktop browser, save it to your NetSurf directory and use something like <code>file:/dtv/usb/sda1/NetSurf/bookmarks.html</code>.
| 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.
| <code>http://google.com/search?q=</code>
|}

==Virtual Keyboard==

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

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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.
| <code> .,!?</code>
|-
| fb_vkb_1
| A list of all characters that can be entered using the '1' button of the TV remote.
| <code>:/@$&</code>
|-
| fb_vkb_2
| A list of all characters that can be entered using the '2' button of the TV remote.
| <code>abc</code>
|-
| fb_vkb_3
| A list of all characters that can be entered using the '3' button of the TV remote.
| <code>def</code>
|-
| fb_vkb_4
| A list of all characters that can be entered using the '4' button of the TV remote.
| <code>ghi</code>
|-
| fb_vkb_5
| A list of all characters that can be entered using the '5' button of the TV remote.
| <code>jkl</code>
|-
| fb_vkb_6
| A list of all characters that can be entered using the '6' button of the TV remote.
| <code>mno</code>
|-
| fb_vkb_7
| A list of all characters that can be entered using the '7' button of the TV remote.
| <code>pqrs</code>
|-
| fb_vkb_8
| A list of all characters that can be entered using the '8' button of the TV remote.
| <code>tuv</code>
|-
| fb_vkb_9
| A list of all characters that can be entered using the '8' button of the TV remote.
| <code>wxyz</code>
|}

An example for an adapted VKB configuration for German users is:
<pre>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
</pre>

==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 [http://forum.samygo.tv/viewtopic.php?f=5&t=403 forum] or - even better - add it directly here in the Wiki.

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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
|
|}

NetSurf Options

2010-03-14T21:23:30Z

Ffischer: /* Other options */

The <code>Options</code> file, located in subdirectory <code>framebuffer/res</code>, 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:
<pre>option_name:option_value
</pre>

==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:
<pre>window_width:960
window_height:540
homepage_url:http://www.netsurf-browser.org/welcome/
fb_mouse_delay:50
</pre>

These options do the following things:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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 <code>bookmarks.html</code> from your desktop browser, save it to your NetSurf directory and use something like <code>file:/dtv/usb/sda1/NetSurf/bookmarks.html</code>.
| 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.
| <code>http://google.com/search?q=</code>
|}

==Virtual Keyboard==

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

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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.
| <code> .,!?</code>
|-
| fb_vkb_1
| A list of all characters that can be entered using the '1' button of the TV remote.
| <code>:/@$&</code>
|-
| fb_vkb_2
| A list of all characters that can be entered using the '2' button of the TV remote.
| <code>abc</code>
|-
| fb_vkb_3
| A list of all characters that can be entered using the '3' button of the TV remote.
| <code>def</code>
|-
| fb_vkb_4
| A list of all characters that can be entered using the '4' button of the TV remote.
| <code>ghi</code>
|-
| fb_vkb_5
| A list of all characters that can be entered using the '5' button of the TV remote.
| <code>jkl</code>
|-
| fb_vkb_6
| A list of all characters that can be entered using the '6' button of the TV remote.
| <code>mno</code>
|-
| fb_vkb_7
| A list of all characters that can be entered using the '7' button of the TV remote.
| <code>pqrs</code>
|-
| fb_vkb_8
| A list of all characters that can be entered using the '8' button of the TV remote.
| <code>tuv</code>
|-
| fb_vkb_9
| A list of all characters that can be entered using the '8' button of the TV remote.
| <code>wxyz</code>
|}

An example for an adapted VKB configuration for German users is:
<pre>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
</pre>

==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 [http://forum.samygo.tv/viewtopic.php?f=5&t=403 forum] or - even better - add it directly here in the Wiki.

{| border="1" cellspacing="0" cellpadding="5" align="center"
! 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
|
|}

NetSurf Options

2010-03-14T21:05:48Z

Ffischer: /* Virtual Keyboard */

NetSurf Options

2010-03-14T21:04:09Z

Ffischer: /* Virtual Keyboard */

NetSurf Options

2010-03-14T20:54:20Z

Ffischer:

NetSurf Options

2010-03-14T20:48:09Z

Ffischer: Created page with 'The <code>Options</code> file, located in subdirectory <code>framebuffer/res</code>, can be used to customize the behavior of the NetSurf Web Browser for SamyGO. ==General iâ¦'

NetSurf Web Browser

2010-03-14T20:31:52Z

Ffischer:

Small as a mouse, fast as a cheetah and available for free. NetSurf is a multi-platform web browser for RISC OS and UNIX-like platforms, including Linux, and more. For more information, visit the [http://www.netsurf-browser.org/ NetSurf homepage].

This version is a port of NetSurf to the current Samsung Digital TV platform as part of the SamyGO project.

==Features==
* it's very speedy, portable and written in plain C
* a basic port to an SDL based framebuffer already existed - which I'm building on. However this version lacks lots of features which other ports (e.g. GTK port) already have.
* it has good HTML and decent CSS support (CSS1 only)
* it hasn't got any support for JavaScript, plugins or Flash

==Download and Installation==
===System requirements===
* Recent Samsung TV based on ARM/Linux architecture
* Gallery must be available
* Games section must be available within the Gallery
* A compatible firmware version must be running (not the latest ones, which were released in 2010)
===Installation===
* Download the browser [http://rrobek.de/download/NetSurf.tgz here].
* Unpack attached TGZ to the root folder of a USB stick. Now you should have a NetSurf folder in there.
* Plug the USB stick to your TV
* open gallery
* goto "manage applications" --> "games"
* run the 'NetSurf browser'

==Usage==
The SamyGO version of NetSurf has been specially adapted to the TV environment and can be used in two ways.
===Using a normal keyboard and mouse===
NetSurf can be operated like any PC web browser, using a keyboard and mouse.
You will need to run the SamyGO keyboard and mouse extension before starting the browser and plug in a USB keyboard and mouse (if possible, cordless...)

The supported keyboard shortcuts are:

{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Action
|-
| Home
| Opens the main menu
|-
| F1
| Go back in the history
|-
| F2
| Switch navigation mode
|-
| PgUp/PgDn
| Scroll by a page
|-
| Cursor
| Move to next link / scroll (depending on navigation mode)
|}

If you always use a keyboard and mouse, you may want to disable the [[NetSurf Options#Virtual keyboard]].

===Using the TV's remote===
Alternatively, you can use NetSurf with the TV remote only.
There are limits in how applications can access the TV remote, so please read the following section carefully.

====Normal navigation====
*The red button opens the menu (see below)
*The green button is the "History: Back" function
*You can switch between different navigation modes (for the arrow keys) using the yellow button.
**Link navigation (default) moves the cursor to the next link
**Page Scroll and Scroll modes scroll around (duh)
**Pointer mode moves the "mouse" pointer
**Press yellow button again to return to Link navigation mode.
*The Enter key (in the middle of the arrow keys) activates links or edits HTML form elements.
*Press blue button to exit Netsurf and return to the Gallery.

'''Warning:''' Do not press any other buttons on the remote - strange things have happened for me while testing, although I'm now trying to exit NetSurf on any other button press.
You can usually recover by pressing the "TV" button, then "Content", then "TV" again.

====Menu====
Press one of the number keys to activate one of the menu options.

====Virtual keyboard====
You can enter text and URLs using the virtual keyboard (VKB) function.
When the URL widget or a HTML form element is focused, the VKB will be activated.
The VKB status is displayed at the right side of the URL bar.
In VKB mode, the keys are used differently:
*The red button still opens the menu
*The green button deletes the last character (like "Backspace" at the PC)
*Switch between different VKB modes using the yellow button.
*Press the number keys repeatedly to input numbers, lowercase or uppercase letters and symbols. The currently composed letter is displayed in the VKB status widget.
By default, the letters are mapped much like on a English mobile phone (see also following table), but the mapping can be changed using [[NetSurf Options#Virtual keyboard]].
* '''Note:''' Press the number keys slowly (about once per second), otherwise the remote control will interpret this as a continuous press and the letters will start spinning around much faster than you want to.

The default key mapping is:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Letters
|-
| 0
| Space . , ! ?
|-
| 1
| : / @ $ &
|-
| 2
| a b c
|-
| 3
| d e f
|-
| 4
| g h i
|-
| 5
| j k l
|-
| 6
| m n o
|-
| 7
| p q r s
|-
| 8
| t u v
|-
| 9
| w x y z
|}

===Note===
Please discuss any questions in the SamyGO forum, using the [http://forum.samygo.tv/viewtopic.php?f=5&t=403 NetSurf thread].

==Fonts / International Text==

The default fonts which are delivered along with NetSurf are the Bitstream Vera fonts. They are freely distributable, but they only have Western European characters. (You will see little squares for all 'foreign' characters.)

So, if you want to surf to web pages written in other languages or if you just don't like the default fonts, you can exchange the font files like this:

*copy any better font from your PC (must be in TTF format, on windows you'll find them in <code>c:\windows\fonts</code>)
*place them in the <code>framebuffer/res</code> subdirectory of your 'NetSurf' directory
*and rename them so that they replace the existing files.

For example, if you want to use ''Arial'' and ''Times New Roman'':
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Rename from
! to
|-
| arial.ttf
| sans_serif.ttf
|-
| arialbd.ttf
| sans_serif_bold.ttf
|-
| ... etc...
|
|-
| times.ttf
| serif.ttf
|-
| ... etc..
|
|}

==Configuration (Options file)==

NetSurf can be configured by editing the file <code>NetSurf/framebuffer/res/Options</code>.
The possibilities are documented in the sub-page [[NetSurf Options]].

==Source code==

NetSurf is Open Source and licensed under the GPL. Source code and building instructions are available on the [[NetSurf Source]] site.

NetSurf Source

2010-03-14T20:21:00Z

Ffischer:

The [[NetSurf_Web_Browser]] is Open Source and licensed under the GPL.
Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

== Compilation instructions ==
*setup environment (install cross compiler)
*compile and <code>make install</code> required dependency libraries:
**libiconv
**zlib
**libjpeg
**libpng
**libxml2
**libidn
**(openssl)
**curl
**SamyGO libSDL
*setup environment for netsurf compilation
<pre>
#!/bin/sh
#export PATH=/usr/local/arm-linux-gnueabi/bin:$PATH
export PKGCONFIG=arm-linux-gnueabi-pkg-config
export PKG_CONFIG=arm-linux-gnueabi-pkg-config
export XML2_CONFIG=/usr/local/arm-linux-gnueabi/bin/xml2-config
export CC=arm-linux-gnueabi-gcc
export CXX=arm-linux-gnueabi-g++
export LD=arm-linux-gnueabi-ld
export STRIP=arm-linux-gnueabi-strip
export AR=arm-linux-gnueabi-ar
export HOST_CC=/usr/bin/gcc
export CFLAGS="-fPIC -O2 -D_REENTRANT"
export CXXFLAGS="-fPIC -O2 -D_REENTRANT"
export PREFIX=/usr/local/arm-linux-gnueabi
# turns off silencing of compiler commands in netsurf compilation
export Q=
</pre>
*compile and <code>make install</code> netsurf member libraries
(each time: <code>make HOST=SamsungDTV; make HOST=SamsungDTV install</code>)
**libparserutils
**libwapcaplet
**libnsbmp
**libnsgif
**libnsfb
**libcss
**hubbub
*compile netsurf
<code>make HOST=SamsungDTV TARGET=framebuffer</code>

==Hacking guide==
The browser core is in the 'content', 'css,' 'desktop', 'render', and 'image' subdirectories of the project. I have avoided touching it (if possible) while porting the browser for SamyGO.

The GUI and frontend code is in the framebuffer subdirectory. Unfortunately, compared to the other NetSurf ports (see the 'gtk', 'amiga' or 'riscos' subdirs, for example) it's quite incomplete and missing lots of useful features.
I have worked on implementing some of them, but a lot remains to be done (e.g. file downloads and bookmarks).
A good starting point would be the empty functions at the bottom of <code>fb_gui.c</code>.

If you have anything useful, please make a patch towards the latest released source code version (see top of page) and send it to florianfischer at gmx.de.

NetSurf Source

2010-03-14T20:10:25Z

Ffischer:

The [[NetSurf_Web_Browser]] is Open Source and licensed under the GPL.
Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

== Compilation instructions ==
*setup environment (install cross compiler)
*compile and <code>make install</code> required dependency libraries:
**libiconv
**zlib
**libjpeg
**libpng
**libxml2
**libidn
**(openssl)
**curl
**SamyGO libSDL
*setup environment for netsurf compilation
<pre>
#!/bin/sh
#export PATH=/usr/local/arm-linux-gnueabi/bin:$PATH
export PKGCONFIG=arm-linux-gnueabi-pkg-config
export PKG_CONFIG=arm-linux-gnueabi-pkg-config
export XML2_CONFIG=/usr/local/arm-linux-gnueabi/bin/xml2-config
export CC=arm-linux-gnueabi-gcc
export CXX=arm-linux-gnueabi-g++
export LD=arm-linux-gnueabi-ld
export STRIP=arm-linux-gnueabi-strip
export AR=arm-linux-gnueabi-ar
export HOST_CC=/usr/bin/gcc
export CFLAGS="-fPIC -O2 -D_REENTRANT"
export CXXFLAGS="-fPIC -O2 -D_REENTRANT"
export PREFIX=/usr/local/arm-linux-gnueabi
# turns off silencing of compiler commands in netsurf compilation
export Q=
</pre>
*compile and <code>make install</code> netsurf member libraries
(each time: <code>make HOST=SamsungDTV; make HOST=SamsungDTV install</code>)
**libparserutils
**libwapcaplet
**libnsbmp
**libnsgif
**libnsfb
**libcss
**hubbub
*compile netsurf
<code>make HOST=SamsungDTV TARGET=framebuffer</code>

NetSurf Source

2010-03-14T20:09:15Z

Ffischer: Created page with 'NetSurf is Open Source and licensed under the GPL. Of course, the source code is available. Get it [http://rrobek.de/download/netsurf-src.tgz here]. == Compilation instructionsâ¦'

NetSurf is Open Source and licensed under the GPL.
Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

== Compilation instructions ==
*setup environment (install cross compiler)
*compile and <code>make install</code> required dependency libraries:
**libiconv
**zlib
**libjpeg
**libpng
**libxml2
**libidn
**(openssl)
**curl
**SamyGO libSDL
*setup environment for netsurf compilation
<pre>
#!/bin/sh
#export PATH=/usr/local/arm-linux-gnueabi/bin:$PATH
export PKGCONFIG=arm-linux-gnueabi-pkg-config
export PKG_CONFIG=arm-linux-gnueabi-pkg-config
export XML2_CONFIG=/usr/local/arm-linux-gnueabi/bin/xml2-config
export CC=arm-linux-gnueabi-gcc
export CXX=arm-linux-gnueabi-g++
export LD=arm-linux-gnueabi-ld
export STRIP=arm-linux-gnueabi-strip
export AR=arm-linux-gnueabi-ar
export HOST_CC=/usr/bin/gcc
export CFLAGS="-fPIC -O2 -D_REENTRANT"
export CXXFLAGS="-fPIC -O2 -D_REENTRANT"
export PREFIX=/usr/local/arm-linux-gnueabi
# turns off silencing of compiler commands in netsurf compilation
export Q=
</pre>
*compile and <code>make install</code> netsurf member libraries
(each time: <code>make HOST=SamsungDTV; make HOST=SamsungDTV install</code>)
**libparserutils
**libwapcaplet
**libnsbmp
**libnsgif
**libnsfb
**libcss
**hubbub
*compile netsurf
<code>make HOST=SamsungDTV TARGET=framebuffer</code>

NetSurf Web Browser

2010-03-14T20:01:05Z

Ffischer: /* Source code */

Small as a mouse, fast as a cheetah and available for free. NetSurf is a multi-platform web browser for RISC OS and UNIX-like platforms, including Linux, and more. For more information, visit the [http://www.netsurf-browser.org/ NetSurf homepage].

This version is a port of NetSurf to the current Samsung Digital TV platform as part of the SamyGO project.

==Features==
* it's very speedy, portable and written in plain C
* a basic port to an SDL based framebuffer already existed - which I'm building on. However this version lacks lots of features which other ports (e.g. GTK port) already have.
* it has good HTML and decent CSS support (CSS1 only)
* it hasn't got any support for JavaScript, plugins or Flash

==Download and Installation==
===System requirements===
* Recent Samsung TV based on ARM/Linux architecture
* Gallery must be available
* Games section must be available within the Gallery
* A compatible firmware version must be running (not the latest ones, which were released in 2010)
===Installation===
* Download the browser [http://rrobek.de/download/NetSurf.tgz here].
* Unpack attached TGZ to the root folder of a USB stick. Now you should have a NetSurf folder in there.
* Plug the USB stick to your TV
* open gallery
* goto "manage applications" --> "games"
* run the 'NetSurf browser'

==Usage==
The SamyGO version of NetSurf has been specially adapted to the TV environment and can be used in two ways.
===Using a normal keyboard and mouse===
NetSurf can be operated like any PC web browser, using a keyboard and mouse.
You will need to run the SamyGO keyboard and mouse extension before starting the browser and plug in a USB keyboard and mouse (if possible, cordless...)

The supported keyboard shortcuts are:

{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Action
|-
| Home
| Opens the main menu
|-
| F1
| Go back in the history
|-
| F2
| Switch navigation mode
|-
| PgUp/PgDn
| Scroll by a page
|-
| Cursor
| Move to next link / scroll (depending on navigation mode)
|}

If you always use a keyboard and mouse, you may want to disable the [[NetSurf Options#Virtual keyboard]].

===Using the TV's remote===
Alternatively, you can use NetSurf with the TV remote only.
There are limits in how applications can access the TV remote, so please read the following section carefully.

====Normal navigation====
*The red button opens the menu (see below)
*The green button is the "History: Back" function
*You can switch between different navigation modes (for the arrow keys) using the yellow button.
**Link navigation (default) moves the cursor to the next link
**Page Scroll and Scroll modes scroll around (duh)
**Pointer mode moves the "mouse" pointer
**Press yellow button again to return to Link navigation mode.
*The Enter key (in the middle of the arrow keys) activates links or edits HTML form elements.
*Press blue button to exit Netsurf and return to the Gallery.

'''Warning:''' Do not press any other buttons on the remote - strange things have happened for me while testing, although I'm now trying to exit NetSurf on any other button press.
You can usually recover by pressing the "TV" button, then "Content", then "TV" again.

====Menu====
Press one of the number keys to activate one of the menu options.

====Virtual keyboard====
You can enter text and URLs using the virtual keyboard (VKB) function.
When the URL widget or a HTML form element is focused, the VKB will be activated.
The VKB status is displayed at the right side of the URL bar.
In VKB mode, the keys are used differently:
*The red button still opens the menu
*The green button deletes the last character (like "Backspace" at the PC)
*Switch between different VKB modes using the yellow button.
*Press the number keys repeatedly to input numbers, lowercase or uppercase letters and symbols. The currently composed letter is displayed in the VKB status widget.
By default, the letters are mapped much like on a English mobile phone (see also following table), but the mapping can be changed using [[NetSurf Options#Virtual keyboard]].
* '''Note:''' Press the number keys slowly (about once per second), otherwise the remote control will interpret this as a continuous press and the letters will start spinning around much faster than you want to.

The default key mapping is:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Letters
|-
| 0
| Space . , ! ?
|-
| 1
| : / @ $ &
|-
| 2
| a b c
|-
| 3
| d e f
|-
| 4
| g h i
|-
| 5
| j k l
|-
| 6
| m n o
|-
| 7
| p q r s
|-
| 8
| t u v
|-
| 9
| w x y z
|}

===Note===
Please discuss any questions in the SamyGO forum, using the [http://forum.samygo.tv/viewtopic.php?f=5&t=403 NetSurf thread].

==Configuration (Options file)==

NetSurf can be configured by editing the file <code>NetSurf/framebuffer/res/Options</code>.
The possibilities are documented in the sub-page [[NetSurf Options]].

==Source code==

NetSurf is Open Source and licensed under the GPL. Source code and building instructions are available on the [[NetSurf Source]] site.

NetSurf Web Browser

2010-03-14T11:07:08Z

Ffischer:

Small as a mouse, fast as a cheetah and available for free. NetSurf is a multi-platform web browser for RISC OS and UNIX-like platforms, including Linux, and more. For more information, visit the [http://www.netsurf-browser.org/ NetSurf homepage].

This version is a port of NetSurf to the current Samsung Digital TV platform as part of the SamyGO project.

==Features==
* it's very speedy, portable and written in plain C
* a basic port to an SDL based framebuffer already existed - which I'm building on. However this version lacks lots of features which other ports (e.g. GTK port) already have.
* it has good HTML and decent CSS support (CSS1 only)
* it hasn't got any support for JavaScript, plugins or Flash

==Download and Installation==
===System requirements===
* Recent Samsung TV based on ARM/Linux architecture
* Gallery must be available
* Games section must be available within the Gallery
* A compatible firmware version must be running (not the latest ones, which were released in 2010)
===Installation===
* Download the browser [http://rrobek.de/download/NetSurf.tgz here].
* Unpack attached TGZ to the root folder of a USB stick. Now you should have a NetSurf folder in there.
* Plug the USB stick to your TV
* open gallery
* goto "manage applications" --> "games"
* run the 'NetSurf browser'

==Usage==
The SamyGO version of NetSurf has been specially adapted to the TV environment and can be used in two ways.
===Using a normal keyboard and mouse===
NetSurf can be operated like any PC web browser, using a keyboard and mouse.
You will need to run the SamyGO keyboard and mouse extension before starting the browser and plug in a USB keyboard and mouse (if possible, cordless...)

The supported keyboard shortcuts are:

{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Action
|-
| Home
| Opens the main menu
|-
| F1
| Go back in the history
|-
| F2
| Switch navigation mode
|-
| PgUp/PgDn
| Scroll by a page
|-
| Cursor
| Move to next link / scroll (depending on navigation mode)
|}

If you always use a keyboard and mouse, you may want to disable the [[NetSurf Options#Virtual keyboard]].

===Using the TV's remote===
Alternatively, you can use NetSurf with the TV remote only.
There are limits in how applications can access the TV remote, so please read the following section carefully.

====Normal navigation====
*The red button opens the menu (see below)
*The green button is the "History: Back" function
*You can switch between different navigation modes (for the arrow keys) using the yellow button.
**Link navigation (default) moves the cursor to the next link
**Page Scroll and Scroll modes scroll around (duh)
**Pointer mode moves the "mouse" pointer
**Press yellow button again to return to Link navigation mode.
*The Enter key (in the middle of the arrow keys) activates links or edits HTML form elements.
*Press blue button to exit Netsurf and return to the Gallery.

'''Warning:''' Do not press any other buttons on the remote - strange things have happened for me while testing, although I'm now trying to exit NetSurf on any other button press.
You can usually recover by pressing the "TV" button, then "Content", then "TV" again.

====Menu====
Press one of the number keys to activate one of the menu options.

====Virtual keyboard====
You can enter text and URLs using the virtual keyboard (VKB) function.
When the URL widget or a HTML form element is focused, the VKB will be activated.
The VKB status is displayed at the right side of the URL bar.
In VKB mode, the keys are used differently:
*The red button still opens the menu
*The green button deletes the last character (like "Backspace" at the PC)
*Switch between different VKB modes using the yellow button.
*Press the number keys repeatedly to input numbers, lowercase or uppercase letters and symbols. The currently composed letter is displayed in the VKB status widget.
By default, the letters are mapped much like on a English mobile phone (see also following table), but the mapping can be changed using [[NetSurf Options#Virtual keyboard]].
* '''Note:''' Press the number keys slowly (about once per second), otherwise the remote control will interpret this as a continuous press and the letters will start spinning around much faster than you want to.

The default key mapping is:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Letters
|-
| 0
| Space . , ! ?
|-
| 1
| : / @ $ &
|-
| 2
| a b c
|-
| 3
| d e f
|-
| 4
| g h i
|-
| 5
| j k l
|-
| 6
| m n o
|-
| 7
| p q r s
|-
| 8
| t u v
|-
| 9
| w x y z
|}

===Note===
Please discuss any questions in the SamyGO forum, using the [http://forum.samygo.tv/viewtopic.php?f=5&t=403 NetSurf thread].

==Configuration (Options file)==

NetSurf can be configured by editing the file <code>NetSurf/framebuffer/res/Options</code>.
The possibilities are documented in the sub-page [[NetSurf Options]].

==Source code==

NetSurf is Open Source and licensed under the GPL. Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

Main Page

2010-03-14T11:05:55Z

Ffischer: /* Software Tools */

== Welcome to SamyGo WiKi ==
Unfortunately, SourceForge doesn't allow users to write on wiki. We needed to assign writing permission by hand.

'''First''' you needed to give a vote "thumb up" for this idea for make [http://sourceforge.net/apps/ideatorrent/sourceforge/ideatorrent/idea/172/ SourceForge to allow all users has write access to wiki].

'''After''' After you can place note for editing permissions by hand on request from forum ([http://forum.samygo.tv/ucp.php?i=pm&mode=compose&u=68 Erdem_ua] or [http://forum.samygo.tv/ucp.php?i=pm&mode=compose&u=78 dynamic1969]).

[[File:Logo.png]]

== Compatibility Overview ==

See the [[Compatibility]] page to see which TV models should work.

== Safety Measures ( which you shouldn't start without ) ==
#Have a working [[Enable Serial Console on non CI+ Devices|Ex-Link cable]] at hand.
#Ensure the backup exe.img ( stored on /dev/tbml10 ) is in good condition ( and ideally not altered. )
#Ensure your RS232 Setting in the Service-Menu is set to "debug".
#Know that your TV will reset RS232 jack back to UART mode after new firmware installation or reverting back to old version.
 

== Useful WIKI articles ==
*[[Is my TV supported?]]
*[[Is this tools avoids my warranty?]]
===Firmware Modification===
*[[Flashing Hacked Firmware to CI+ devices]]
*[[How to capture channel (PVR functionality)]]
*[[How to enable Telnet on samsung TV's]]
*[[How to enable Telnet/NFS/CIFS/SAMBA]]
*[[Enable Serial Console on non CI+ Devices]]
*[[Getting access to uBoot / bootloader]]
*[[Dumping and Flashing images by hand]]
*[[Open backdoor for fixing bootloop situations]]
*[[Mounting an NFS share on a USB device to bypass DLNA]]
*[[Mounting an CIFS/SAMBA share on a USB device to bypass DLNA]]
*[[Samsung A Series (2008 Model) Hacks]]
*[[Video AR Fix]]
*[[Playing with Firmware Images]]
*[[Enable Wiselink Movie on B5 Series Devices]]

===Software Tools===
*[[Setting up a native-compilation toolchain]]
*[[Setting up a cross-compilation toolchain]]
*[[SamyGO OpenEmbedded]]
*[[SamyGO Telnet Enabler]]
*[[SamyGO Extensions Pack]]
*[[SamyGO ChanEdit - Chanel Editor]]
*[[SamyGO Firmware Patcher]]
*[[NetSurf_Web_Browser]]

===General Information===
*[[Frequently Asked Questions]]
*[[Recovery of Bricked Device]]
*[[Service Manuals]]
*[[Service Menu]]
*[[Engineering Codes]]
*[[Media Play and DLNA]]
*[[Samsung channel list format]]
 

== Interesting Reference Material ==
*[http://www.samsung.com/global/business/semiconductor/products/flash/Products_RFS_ApplicationNotes.html Introduction to SAMSUNG's Linux Flash File System - RFS]
The file-system used in the the recent Samsung TVs is "RFS". Its proprietary nature and consequently so the absence of an according Linux RFS-Module in the standard Linux distributions makes it currently impossible to modify files by simply mounting the respective image as "RW", modifying it and saving the respective image again. This is the reason why currently all changes are done via patching of the image-binaries.
*[http://www.samsung.com/global/business/semiconductor/products/flash/Products_RFS_PortingGuide.html Linux RFS ( Robust FAT File System ) Porting Guide]
The information provided here should help, that we get a RFS module compiled for our common Linux distributions

*[http://www.samsung.com/global/opensource/ Samsung's Source Code]
All the source code Samsung is legally obliged to post can be found here.

*[http://forums.cnet.com/samsung-forum/ Official Samsung Forums]
Should be able to find useful info somewhere.

== Disclaimer ==
Neither this WIKI/Forum nor the author(s) of articles and information provided accept any responsibility for damage that may be caused by use of the information provided. You do everything at your own risk. Be aware that "hacking" activities do void your warranty!
 Tested on UExxB70xx, LExxB65x and compatible devices only.

[[Crew List]]

NetSurf Web Browser

2010-03-14T11:04:07Z

Ffischer:

Small as a mouse, fast as a cheetah and available for free. NetSurf is a multi-platform web browser for RISC OS and UNIX-like platforms, including Linux, and more. For more information, visit the [http://www.netsurf-browser.org/ NetSurf homepage].

This version is a port of NetSurf to the current Samsung Digital TV platform as part of the SamyGO project.

==Features==
* it's very speedy, portable and written in plain C
* a basic port to an SDL based framebuffer already existed - which I'm building on. However this version lacks lots of features which other ports (e.g. GTK port) already have.
* it has good HTML and decent CSS support (CSS1 only)
* it hasn't got any support for JavaScript, plugins or Flash

==Download and Installation==
===System requirements===
* Recent Samsung TV based on ARM/Linux architecture
* Gallery must be available
* Games section must be available within the Gallery
* A compatible firmware version must be running (not the latest ones, which were released in 2010)
===Installation===
* Download the browser [http://rrobek.de/download/NetSurf.tgz here].
* Unpack attached TGZ to the root folder of a USB stick. Now you should have a NetSurf folder in there.
* Plug the USB stick to your TV
* open gallery
* goto "manage applications" --> "games"
* run the 'NetSurf browser'

==Usage==
The SamyGO version of NetSurf has been specially adapted to the TV environment and can be used in two ways.
===Using a normal keyboard and mouse===
NetSurf can be operated like any PC web browser, using a keyboard and mouse.
You will need to run the SamyGO keyboard and mouse extension before starting the browser and plug in a USB keyboard and mouse (if possible, cordless...)

The supported keyboard shortcuts are:

{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Action
|-
| Home
| Opens the main menu
|-
| F1
| Go back in the history
|-
| F2
| Switch navigation mode
|-
| PgUp/PgDn
| Scroll by a page
|-
| Cursor
| Move to next link / scroll (depending on navigation mode)
|}

If you always use a keyboard and mouse, you may want to disable the [[NetSurf Options#Virtual keyboard]].

===Using the TV's remote===
Alternatively, you can use NetSurf with the TV remote only.
There are limits in how applications can access the TV remote, so please read the following section carefully.

====Normal navigation====
*The red button opens the menu (see below)
*The green button is the "History: Back" function
*You can switch between different navigation modes (for the arrow keys) using the yellow button.
**Link navigation (default) moves the cursor to the next link
**Page Scroll and Scroll modes scroll around (duh)
**Pointer mode moves the "mouse" pointer
**Press yellow button again to return to Link navigation mode.
*The Enter key (in the middle of the arrow keys) activates links or edits HTML form elements.
*Press blue button to exit Netsurf and return to the Gallery.

'''Warning:''' Do not press any other buttons on the remote - strange things have happened for me while testing, although I'm now trying to exit NetSurf on any other button press.
You can usually recover by pressing the "TV" button, then "Content", then "TV" again.

===Menu===
Press one of the number keys to activate one of the menu options.

===Virtual keyboard===
You can enter text and URLs using the virtual keyboard (VKB) function.
When the URL widget or a HTML form element is focused, the VKB will be activated.
The VKB status is displayed at the right side of the URL bar.
In VKB mode, the keys are used differently:
*The red button still opens the menu
*The green button deletes the last character (like "Backspace" at the PC)
*Switch between different VKB modes using the yellow button.
*Press the number keys repeatedly to input numbers, lowercase or uppercase letters and symbols. The currently composed letter is displayed in the VKB status widget.
By default, the letters are mapped much like on a English mobile phone (see also following table), but the mapping can be changed using [[NetSurf Options#Virtual keyboard]].
* '''Note:''' Press the number keys slowly (about once per second), otherwise the remote control will interpret this as a continuous press and the letters will start spinning around much faster than you want to.

The default key mapping is:
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Key
! Letters
|-
| 0
| Space . , ! ?
|-
| 1
| : / @ $ &
|-
| 2
| a b c
|-
| 3
| d e f
|-
| 4
| g h i
|-
| 5
| j k l
|-
| 6
| m n o
|-
| 7
| p q r s
|-
| 8
| t u v
|-
| 9
| w x y z
|}

===Note===
Please discuss any questions in the SamyGO forum, using the [http://forum.samygo.tv/viewtopic.php?f=5&t=403 NetSurf thread].

==Configuration (Options file)==

NetSurf can be configured by editing the file <code>NetSurf/framebuffer/res/Options</code>.
The possibilities are documented in the sub-page [[NetSurf Options]].

==Source code==

NetSurf is Open Source and licensed under the GPL. Of course, the source code is available.
Get it [http://rrobek.de/download/netsurf-src.tgz here].

NetSurf Web Browser

2010-03-14T10:31:30Z

Ffischer:

NetSurf Web Browser

2010-03-14T09:33:19Z

Ffischer: Created page with '== NetSurf web browser == Small as a mouse, fast as a cheetah and available for free. NetSurf is a multi-platform web browser for RISC OS and UNIX-like platforms, including Linuâ¦'

== NetSurf web browser ==

Small as a mouse, fast as a cheetah and available for free. NetSurf is a multi-platform web browser for RISC OS and UNIX-like platforms, including Linux, and more.

[[http://www.netsurf-browser.org/ NetSurf homepage]]

This version is a port of NetSurf to the current Samsung Digital TV platform as part of the SamyGO project.