Tear

2010-04-01T22:00:55Z

140.212.213.40: /* How do I change the User Agent? */

Tear is a WebKit browser. It is currently under heavy development, so expect occasional bugs (including freezes & crashes) and quirks. However, because of Tear's speed, and the benefits of being WebKit based (such as perfect rendering of the Acid 3 test!) it's becoming a popular option.

Track and file bugs [http://bugs.bundyo.org/ here]. Garage page [https://garage.maemo.org/projects/tear here]. Latest Talk Maemo thread [http://talk.maemo.org/showthread.php?t=28539 here]. Please search these links before posting questions.

This wiki document applies to Tear version 0.3.5. You can see which version of Tear you're running by tapping menu -> Help -> About.

== Installing Tear ==

Tear can be installed from [[extras-devel]] for [[Open development/Maemo roadmap/Fremantle|Fremantle]]. There are barriers that are currently preventing Tear from being in the official repositories (even extras-devel) for [[Open development/Maemo roadmap/Diablo|Diablo]]. Therefore, the easiest way to install Tear right now is using [http://qole.org/ Qole's] repository.

=== Adding Qole's Repository to Application manager ===

*Go into the Application manager.
*Tap the menu -> Tools -> Application catalog...
*Tap New and enter the following information:
Catalogue Name: Qole
Web address: http://qole.org/repository
Distribution: maemo
Components: main
*Click OK and then Close.

This method doesn't work if you have a 770 [http://talk.maemo.org/showpost.php?p=281989&postcount=30 *]. Problems? Try [http://talk.maemo.org/showthread.php?t=30180 this]. Sources [http://talk.maemo.org/showpost.php?p=281889&postcount=1 *] [http://talk.maemo.org/showpost.php?p=301447&postcount=4 *] [http://talk.maemo.org/showpost.php?p=298680&postcount=10 *]

=== Installing From Qole's Repository ===

With the Application manager, search for "Tear" and install.
If the Application Manager does not find it, don't panic - it probably just needs to download the update for Qole's repository; goto Main View, then hit the "Check for updates" button, and try again.

=== Alternate Installation Method ===

You could install Tear using Bundyo's link [http://talk.maemo.org/showpost.php?p=281889&postcount=1 here], but then you would need to separately install some associated library files. See [http://talk.maemo.org/showpost.php?p=298698&postcount=12 this] for commands.

== Installing TearBookmarks Side Panel ==

TearBookmarks is currently in Qole's repository. This information applies to version 0.3.1-4.

If you have enabled Qole's repository using the above steps, you can install TearBookmarks using the Application manager. Now you need to get it to appear on the left panel. Steps to do that:

*Go into the Control Panel.
*Tap "Panels".
*You should see an option for "Tear Bookmarks". Uncheck one of the existing options and check "Tear Bookmarks".
*Hit OK and close the Control Panel.

A Tear icon should appear on the left panel. Tapping this allows you to do such things as open a new page of Tear, open a bookmark manager, or open one of your bookmarks in Tear.

== Tear FAQ ==

=== What are some of Tear's core functionalities? ===
Tear observes the tablet's hardware fullscreen button and the zoom button. Use the D-Pad arrows to scroll. Drag the stylus to drag the web page, flick the stylus to scroll, tap and hold the stylus to cause a context menu to appear.

Tear uses separate windows rather than tabs. Tap and hold on a link to get a choice to open up that link in another window.

=== How do I set/clear/access bookmarks? ===
Within Tear, navigate to the web page in question and tap the grey or yellow star on the toolbar. You can also set bookmarks using menu -> Page -> Add bookmark... You can also manage bookmarks from the side panel by selecting the "Bookmarks" option in that panel (see below for more info).

Access bookmarks within Tear by clicking the ^ symbol on the far right of the toolbar or via the Dashboard's "Bookmarks" tab.

=== Can I switch the built-in bookmark panel to call Tear instead? ===
This is coded to call the built-in browser.
[http://talk.maemo.org/showpost.php?p=304298&postcount=566 A workaround is available] (see also [http://talk.maemo.org/showthread.php?t=29815 this]). It requests to be familiar with editing system files as root and is still to be perfected. Saving bookmarks into the built-in panel from Tear can't be done at present.

=== Can I get other programs to call Tear? ===
The program is probably hard-coded to call the built-in browser [http://talk.maemo.org/showpost.php?p=281925&postcount=16 *].
[http://talk.maemo.org/showpost.php?p=304298&postcount=566 The previous hack] will allow several applications to open urls directly in tear, translating the hard-coded call to microb into a call to tear.

=== Can I transfer bookmarks into Tear? ===
Tear currently has no way to import bookmarks. However, if another browser allows you to export bookmarks as an HTML file, you can open this HTML file within Tear [http://talk.maemo.org/showpost.php?p=287210&postcount=246 *].

For [http://wiki.maemo.org/MicroB_tweaks MicroB], the steps are these:
*Within MicroB, tap the menu -> Navigation -> Bookmarks. The bookmark manager will open.
*Tap the menu -> Tools -> Export...
*Choose a filename and location and hit OK.
*Within Tear, tap the menu -> Page -> Open file... and select the file you exported.

You can bookmark this page within Tear. Or you can make it your home page by going to menu -> Page -> Set home page (or set home_page in menu -> Tools -> Options...).

=== How can I get the toolbar to appear in fullscreen mode? ===
You can make it appear on demand by holding and releasing the DPad Enter key [http://talk.maemo.org/showpost.php?p=281889&postcount=1 *]. You can make it always visible by selecting:

menu -> View -> Toolbar -> Show Toolbar in Fullscreen

=== How do I select text? Dragging the stylus drags the page. ===
Hold down the menu button as you drag [http://talk.maemo.org/showpost.php?p=281889&postcount=1 *]. Additionally, as with MicroB, you can double-tap to select a word of text or triple-tap to select a block of text.

Serendipitously, holding down the menu key also you to do drag-scrolling on Google Maps[http://talk.maemo.org/showthread.php?t=28539&page=39 *] and presumably other similar sites that co-opt the drag action.

=== Does Tear have adblocking functionality (e.g., a plugin)? ===
No, but see [http://talk.maemo.org/showpost.php?p=128028&postcount=20 this hack].

=== Can Tear clear browsing history? ===
Yes, see options under menu -> Tools. (Previously, the only option was to delete [http://talk.maemo.org/showpost.php?p=277972&postcount=811 this file].)

=== How do I change the User Agent? ===
Aka user agent spoofing. The purpose is to make a website think Tear is a different browser in order to hack past incompatibility problems or to trigger different behavior (e.g., the mobile version of a site).

Go to menu -> Tools -> Options and change user_agent [http://talk.maemo.org/showpost.php?p=281889&postcount=1 *] [http://talk.maemo.org/showpost.php?p=282166&postcount=51 *]. If you clear the field and click OK, the default user-agent will be restored.

Default agent:
Mozilla/5.0 (X11; U; Linux armv6l; en-us) AppleWebKit/528.5+ (KHTML, like Gecko, Safari/528.5+) tear

iPhone user agent (for iPhone spoofing -- [http://www.mattcutts.com/blog/iphone-user-agent/ reference] -- for trouble-shooting see [http://talk.maemo.org/showthread.php?t=28539&page=6 this] & [http://talk.maemo.org/showthread.php?t=28152 this]):
Mozilla/5.0 (iPhone; U; CPU like Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) Version/3.0 Mobile/1A543a Safari/419.3

iPad user agent (for iPad spoofing -- [http://developer.apple.com/safari/library/technotes/tn2010/tn2262.html#TNTAG4/ reference] -- for trouble-shooting see [http://talk.maemo.org/showthread.php?t=28539&page=6 this] & [http://talk.maemo.org/showthread.php?t=28152 this]):
Mozilla/5.0 (iPad; U; CPU OS 3_2 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Version/4.0.4 Mobile/7B334b Safari/531.21.10

[[Category:Users]]
[[Category:Web]]

[[Category:Power users]]

Maemo Wiki Mirror - User contributions [en]

Tear