OWB 1.22 - 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 Odyssey Web Browser --------------------------- Odyssey Web Browser is a WebKit-based browser originally based on OWB from Sand-Labs/Pleyo. Since then, it has been extensively developed to become a full-blown desktop browser with modern functionality. License ------- Copyright (C) 2009-2013 Fabien Coeurjoly Copyright (C) 2009-2010 Pleyo. All rights reserved. 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. The names of the authors may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY ITS AUTHORS "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 ITS AUTHORS 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 r155188 WebKit (October 2013) - Javascript, CSS, DOM, SVG, Unicode, SSL, ... - HTML5 Video/Audio support (Ogg/Theora, WEBM, MPEG4/H264, MP3, AAC, WAV 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 and history support - Password manager - Cookie manager - Messages console - Network connections manager - Proxy support - Session support - Form filling completion - Bookmarks - Fastlinks - Configurable MIME types - History - Content blocking - URL Completion - Favicon support - Private Browsing - Per URL settings - Configurable contextual menus - Configurable search engines - Contextual cursors - Drag and Drop support - Clipboard support - Spell checking support - Fullscreen support - OpenURL/Rexx support - PDF export - Printing support - Plugin support - WebInspector (FireBug-like) - User scripting (GreaseMonkey-like) - No PayPal donation needed ... Requirements ------------ MorphOS 3.x is required. Full version requires at least 70MB 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 8MB 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, proxy settings. + Download Download directory and download manager behaviour. + Privacy Settings for session, history, cookies, local storage, form credentials, form completion... + Security SSL settings + Media Settings for H264 filter mode, fast seeking and WEBM/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). OWB_DISABLE_MOBILE_COMPRESSION disables cache, which as a consequence prevents some particular mobile provider/proxies from sending compressed content. OWB_NO_PERIODIC_COLLECT disables javascript periodic garbage collection. - 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 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