Tear

(How do I set/clear/access bookmarks?)
({{out of date}})
 
(14 intermediate revisions not shown)
Line 1: Line 1:
 +
{{out of date}}
 +
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.  
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.  
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.1. You can see which version of Tear you're running by tapping menu -> Help -> About.
+
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 ==
== 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 [http://qole.org/ Qole's] repository.  
+
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 using Diablo is using [http://qole.org/ Qole's] repository.  
-
=== Adding Qole's Repository to Application manager ===
+
=== Adding Qole's Repository to Application manager (Diablo) ===
*Go into the Application manager.
*Go into the Application manager.
Line 22: Line 24:
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 *]
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 ===
+
=== Installing From Qole's Repository (Diablo) ===
With the Application manager, search for "Tear" and install.
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.
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 ===
+
=== Alternate Installation Method (Diablo) ===
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.
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.
Line 33: Line 35:
== 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 44:
*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 ==
Line 62: Line 57:
Access bookmarks within Tear by clicking the ^ symbol on the far right of the toolbar or via the Dashboard's "Bookmarks" tab.
Access bookmarks within Tear by clicking the ^ symbol on the far right of the toolbar or via the Dashboard's "Bookmarks" tab.
 +
 +
See also [http://talk.maemo.org/showpost.php?p=364833&postcount=942 this tip] for integrating Tear with Google Bookmarks.
=== Can I switch the built-in bookmark panel to call Tear instead? ===
=== Can I switch the built-in bookmark panel to call Tear instead? ===
-
This is coded to call the built-in browser.
+
Yes, using the [http://browser-switch.garage.maemo.org/ Browser Switchboard] program! Saving bookmarks into the built-in panel from Tear, however, can't be done at present.
-
[http://talk.maemo.org/showpost.php?p=304298&postcount=566 A workaround is available]. 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? ===
=== 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 *].
+
Probably. Try installing [http://browser-switch.garage.maemo.org/ Browser Switchboard] and setting your default browser to Tear.
-
[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? ===
=== 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 *].
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:
+
For [[MicroB_tweaks|MicroB]], the steps are these:
*Within MicroB, tap the menu -> Navigation -> Bookmarks. The bookmark manager will open.
*Within MicroB, tap the menu -> Navigation -> Bookmarks. The bookmark manager will open.
*Tap the menu -> Tools -> Export...
*Tap the menu -> Tools -> Export...
Line 106: Line 101:
  Mozilla/5.0 (X11; U; Linux armv6l; en-us) AppleWebKit/528.5+ (KHTML, like Gecko, Safari/528.5+) tear
  Mozilla/5.0 (X11; U; Linux armv6l; en-us) AppleWebKit/528.5+ (KHTML, like Gecko, Safari/528.5+) tear
-
[[Category:Users]]
+
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:Web]]
 +
[[Category:Software]]
 +
[[Category:Power users]]

Latest revision as of 08:56, 22 September 2010

Image:Ambox_content.png
This article is out-of-date, and needs to be updated.
Please see the talk page for discussion.

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

[edit] Installing Tear

Tear can be installed from extras-devel for Fremantle. There are barriers that are currently preventing Tear from being in the official repositories (even extras-devel) for Diablo. Therefore, the easiest way to install Tear right now using Diablo is using Qole's repository.

[edit] Adding Qole's Repository to Application manager (Diablo)

  • 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 * * *

[edit] Installing From Qole's Repository (Diablo)

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.

[edit] Alternate Installation Method (Diablo)

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.

[edit] 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.

[edit] Tear FAQ

[edit] 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.

[edit] 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.

See also this tip for integrating Tear with Google Bookmarks.

[edit] Can I switch the built-in bookmark panel to call Tear instead?

Yes, using the Browser Switchboard program! Saving bookmarks into the built-in panel from Tear, however, can't be done at present.

[edit] Can I get other programs to call Tear?

Probably. Try installing Browser Switchboard and setting your default browser to Tear.

[edit] 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...).

[edit] 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

[edit] 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.

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

No, but see this hack.

[edit] Can Tear clear browsing history?

Yes, see options under menu -> Tools. (Previously, the only option was to delete this file.)

[edit] 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

iPad user agent (for iPad spoofing -- reference -- for trouble-shooting see this & 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
Retrieved from "http://wiki.maemo.org/Tear"