OWB 1.5 - 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 Pleyo. All rights reserved. Copyright (C) 2009 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 r1092 OWB SVN (October 2009) - Javascript, CSS, DOM, SVG, Unicode, SSL, ... - 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://piru.morphos.net/~p/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). Progress is indicated if you run OWB from shell. 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. 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 A settings window is available. You can set download directory, homepage, interface settings, content settings, fonts and much more. - Some additional settings are only available through env vars at the moment (they will end in settings window later): HTTP_PROXY [proxy address string] WEBKIT_IGNORE_SSL_ERRORS [0 or 1] OWB_USER_AGENT [user agent string] OWB_EXPERIMENTAL_COOKIES [0 or 1] - 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 less effective 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 with: "setenv WEBKIT_IGNORE_SSL_ERRORS 1" (not really recommended). - 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, send me a debug log. - OWB hits/crashes when opening more than n tabs. -> known bug in MUI, which should be fixed for MorphOS 2.3. In the meanwhile, you can also avoid it 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 - HTML5 media support (