Tear

DOCUMENT IN PROCESS

What Is Tear?
Tear is a WebKit browser. It is currently under heavy development, so expect occasional bugs (including freezes & crashes) and quirks. Track and file bugs here. However, because of Tear's speed, it's becoming a popular option. This document applies to Tear version 0.3.1.

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

Installing From Qole's Repository
With the Application manager, search for "Tear" and install.

Installing TearBookmarks Side Panel
TearBookmarks is currently in the Extras-devel repository. The information applies to version 0.3.1-4. See this for information on Extras-devel, including adding the repository to Application manager. Steps to install:


 * Go into the Application manager.
 * Tap the menu -> Tools -> Application catalog...
 * Tap the 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.
 * 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.

How do I set/clear bookmarks?
Within Tear, navigate to the web page in question and tap the grey or yellow star on the toolbar. You can also manage bookmarks from the side panel by selecting "Bookmarks".

Can I switch the built-in bookmark panel to call Tear instead?
No, this is coded to call the built-in browser. It not as simple as changing a file association somewhere.

Can I get other programs to call Tear?
You'd probably need to contact the developer -- the program is probably hard-coded to call the built-in browser.

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.
 * From the File Manager, open the file you just created. Note the URL: it should begin with "file:///".
 * Open the URL in Tear

You can bookmark this page. Or you can make it your home page by, within Tear, going to menu > Tools > Options... and setting home_page option to this URL.