OWB 1.11 - MorphOS *********************************************************************************** * * * IMPORTANT: if you're really impatient, look at the "Usage/First Run" section. * * * * IMPORTANT BIS: read "Youtube" section, if you plan to play videos from Youtube. * * * *********************************************************************************** What is OWB? ------------ OWB is a web browser designed for CE devices such as mobile phones, portable media players, Set Top Boxes and TV decoders, and any other consumer electronic product (GPS, home-gateways, Web-radios, PVR, DVD recorders, wireless devices etc.) Galeking release is the new mixture of WebKit with Sand-Labs flavour. It is based on a day-to-day merging capability with WebKit while it still provides the easy to use, easy to implement and easy to test OWBAL abstraction layer. More information at: http://www.sand-labs.org/owb License ------- Copyright (C) 2009-2010 Pleyo. All rights reserved. Copyright (C) 2009-2010 Fabien Coeurjoly Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of Pleyo nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY PLEYO AND ITS CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL PLEYO OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. MorphOS Port ------------ Here are the key features: - Based on r71312 WebKit (November 2010) - Based on r1468 OWB (June 2010) - Javascript, CSS, DOM, SVG, Unicode, SSL, ... - HTML5 Video/Audio support (Ogg/Theora, VP8, MPEG4/H264 and a couple others formats/codecs) - Antialiased fonts and kerning, font families and support for international charsets - MUI Interface - Cairo technology !!1 - Multiple tabs and windows - Download manager with resume support - Password manager - Cookie manager - Messages console - Network connections manager - Session support - Bookmarks - Fastlinks - Configurable MIME types - History - Content blocking - URL Completion - Favicon support - Configurable contextual menus - Configurable search engines - Contextual cursors - Drag and Drop support - Copy/Cut/Paste - OpenURL/Rexx support - PDF export - Plugin support - WebInspector (FireBug-like) - User scripting (GreaseMonkey-like) - No PayPal donation needed ... Requirements ------------ MorphOS 2.x is strongly advised, but it can still work on a 1.4.x setup with a recent enough MUI snapshot (2007). Full version requires at least 45MB of free memory and potentially much more depending on visited sites. Note: if you want to reduce the binary size, you can use lzmaloader from Harry "Piru" Sintonen. It's available at: http://www.sintonen.fi/lzmaloader/ . NoSVG version ------------- The NoSVG version doesn't support SVG format, hence the name. The reason for this special version is that SVG makes the binary about 10MB bigger. Usage ----- - First run (IMPORTANT! READ!) At *first* run, OWB will index your truetype fonts directory (MOSSYS:fonts/_ttf by default). This operation can take a long time (expect a few minutes on efika). Once it's done, a conf/font/fonts-.cache file is created for each configured font directory. If you wish to use another truetype font directory, please edit conf/font/fonts.conf and change the attribute. By default, it's: ... SYS:fonts/_ttf MOSSYS:fonts/_ttf ... You can add additional directories by adding a .. line. I strongly advise to use Microsoft fonts instead of default MOSSYS:fonts/_ttf that aren't really suited for web use. If you installed sputnik previously, you should already have them. Otherwise, just run the "Download Fonts" script supplied with OWB. Once it's done, I also advise removing "MOSSYS:fonts/_ttf" from fonts.conf files to reduce substitution times. To use japanese fonts or anything else, just add relevant fonts in the configured font directory. Please note that japanese fonts can slow down rendering quite a lot. - Settings + General Homepage, startpage and shell output window (useful for external actions). + Interface Toolbar, autocompletion modes, favicons, quicklink layout, ... + Contextual Menus Custom actions can be configured for link, page and image menus. For instance, you can link a video/audio player to a link, or getvideo to play youtube content. + Mimetypes Each mimetype can be configured to trigger a specific action: view with browser, download or display with an external viewer. That's the place to configure if you have some issues with downloading direct links, for instance. + Content Cache model, content blocking, animation/picture/javascript activation, ... + Fonts Size and font families can be configured. For much finer configuration, see conf/font/fonts.conf. + Network User agent, number of simultaneous connections, network thread, cookie system... + Download Download directory and download manager behaviour. + Privacy Settings for session/history/cookies/form credentials saving. + Security SSL settings + Media Settings for H264 filter mode, fast seeking and VP8 codec. - Some additional exotic settings are only available through env vars at the moment (they will end in regular settings later, if they still make sense): HTTP_PROXY [proxy address string] - specifies the proxy address to use OWB_USER_AGENT [user agent string] - overrides the user agent configured in settings OWB_POLLTIME [value in milliseconds (default is 10ms)] - can help increasing network speed (the lower, the faster). OWB_BENCHMARK prints timing information in debuglog about rendering process OWB_NO_STATIC_BACKGROUND ignores background "fixed" CSS attribute (interesting on slower machines) OWB_CURL_DEBUG prints CURL debug (HTTP requests, answers and connection management) OWB_CURL_FORBID_REUSE prevents CURL from keeping request connections alive and re-using them (slower but more bullet-proof) OWB_CURL_FORBID_ENCODING disables gzip support (can help in some situations for some rare buggy sites). - Bookmarks OWB can import IBrowse bookmarks. Just copy it to OWB directory as bookmarks.html. If you wish to make an entry appear in fastlinks or pulldown menu, just check the relevant option in bookmark editor. Also note you can drag'n'drop links between many different elements of the GUI. - REXX port OPEN NAME/K,NEWPAGE/S,BACKGROUND/S,SOURCE/S RELOAD BACK FORWARD SAVEURL URL/A,AS/K ADDBOOKMARK TITLE/A,URL/A,ALIAS/K,MENU/S,QUICKLINK/S GETURL SELECTEDTEXT - OpenURL configuration Rexx Port: OWB Show:SHOW Screen To Front: SCREENTOFRONT Open: OPEN NAME="%u" Open in new window: OPEN NAME="%u" NEWPAGE With MorphOS 2.3 or later, you can also just use the OWB preset available in OpenURL preferences. Youtube special notes --------------------- There are a few things to know about Youtube, since it tends to change (or rather break) quite often. Youtube introduced a new way to play media without using Flash: HTML5 video. This service isn't enabled by default nor autodetected, so it has to be enabled by going to http://www.youtube.com/html5 and clicking the subscription link (no account needed, only a cookie will be set). There are a few more important elements to consider: - Youtube broke the fullscreen mode that worked just nicely before, so a script is needed to workaround this. This is done by going to Windows->Scripts and adding the "Scripts/youtube_fullcreen_fix.js" userscript. This fullscreen mode is particularly important, since OWB uses overlay output in this mode, which makes it about 3 times faster, synchronized on VBL, and smoother as well, compared to windowed mode. - Not all Youtube links are available as HTML5 yet. Fortunately, there's a way to "convert" the remaining Flash-only links to HTML5 by adding the "Script/Youtube.js" script in Windows->Scripts. When this script is enabled, the Flash element on Youtube is removed, the video direct URLs are retrieved, and a HTML5