Tear

(How do I change the User Agent?)
(Updated to reflect Qole's changes)
Line 33: Line 33:
== Installing TearBookmarks Side Panel ==
== Installing TearBookmarks Side Panel ==
-
TearBookmarks is currently in the Extras-devel repository. The information applies to version 0.3.1-4. See [http://wiki.maemo.org/Extras#Extras-devel this] for information on Extras-devel, including adding the repository to Application manager. Steps to install:
+
TearBookmarks is currently in Qole's repository. This information applies to version 0.3.1-4.  
-
*Go into the Application manager.
+
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:
-
*Tap the menu -> Tools -> Application catalog...
+
-
*Tap the [http://wiki.maemo.org/Extras#Extras-devel Extras Devel] choice and tap Edit.
+
-
*Make sure "Disabled" is UNchecked and tap OK and Close.
+
-
*Search for "TearBookmarks" and install.
+
-
*Go back into the Application catalog and disable Extras-devel.
+
-
 
+
-
Now you need to get it to appear on the left panel. Steps:
+
*Go into the Control Panel.
*Go into the Control Panel.
Line 49: Line 42:
*Hit OK and close the Control Panel.
*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.
+
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 ==
== Tear FAQ ==

Revision as of 23:51, 17 November 2009

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 here. Garage page here. Latest Talk Maemo thread 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.

Contents

Installing Tear

There are barriers that are currently preventing Tear from being in the official repositories (even extras-devel). Therefore, the easiest way to install Tear right now is using 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 *. Problems? Try this. Sources * * *

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 here, but then you would need to separately install some associated library files. See 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. A workaround is available (see also 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 *. 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 *.

For 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 *. 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 *. 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* and presumably other similar sites that co-opt the drag action.

Does Tear have adblocking functionality (e.g., a plugin)?

No, but see this hack.

Can Tear clear browsing history?

Yes, see options under menu -> Tools. (Previously, the only option was to delete 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 * *. 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 -- reference -- for trouble-shooting see this & 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
Retrieved from "http://wiki.maemo.org/Tear"