OWB 1.7 - MorphOS ********************************************************************************* * * * IMPORTANT: if you're really impatient, look at the "Usage/First Run" section. * * * ********************************************************************************* 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 r1369 OWB SVN (February 2010) - Javascript, CSS, DOM, SVG, Unicode, SSL, ... - HTML5 Video/Audio support (Ogg/Theora and MPEG4/H264) - 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 - Contextual cursors - Copy/Cut/Paste - OpenURL/Rexx support - PDF export - Plugin support - 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 35MB 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/ . Lite & noSVG versions --------------------- The lite version is identical to the normal one, except SVG and libICU are disabled. ICU being disabled, it means only UTF-8 and latin1 charsets will be displayed correctly. The noSVG version doesn't support SVG, hence the name. :) 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 - Some additional settings are only available through env vars at the moment (they will end in settings window later): 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. - 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. - 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. Preempted rants --------------- - It takes ages to start! -> It only happens at first start or when you update your fonts. Current OWB version uses FontConfig, which is quite slow at indexing. After that, it should start in a second or so. - It's slow! -> OWB is based on WebKit and this version uses Cairo to render. Modern browsers tend to be a bit heavier than our good old browsers. :) That said, there's still room for optimization. - It's too memory-hungry! -> See above. - Some SSL websites show a certificate error requester! -> Maybe they're not certified. You can either update "curl-ca-bundle.crt" file, or ignore SSL errors by enabling "Ignore SSL errors" in Settings/Security. - It crashes! -> OWB is fairly stable (as long as you have enough memory, like most posix application nowadays unfortunately...). If you get a reproducible crash (unrelated to memory usage), send me a debug log. - OWB hits/crashes when opening more than n tabs. -> known bug in MUI, which was fixed in MorphOS 2.3. For previous versions, it can be avoided by just unchecking system prefs->Debug->MUI->Error checkmark (the error was caused by MUI debug routine). What's missing and might be supported in next versions ------------------------------------------------------ - History with nicer sorting options - Certificate (SSL) manager ... and probably more... History ------- - 04.03.2010: OWB 1.7 - Updated to OWB SVN r1369. - Updated to Curl 7.20. - Implemented HTML5 Media backend (