Difference between revisions of "Website:Migrating from Safari"

From Camino Wiki
Jump to navigation Jump to search
(some initial hacking)
 
(→‎Extending Camino: remove CamiBlock)
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Welcome, Safari Users!=
+
=Trying Camino?=
  
Looking for a browser that caters to your needs, not those of Steve Jobs?  Want a browser that looks and feels like it belongs on your Mac, no matter the version of Mac OS X you're using?  Want the power of the world's most powerful, most standards-compliant, '''and''' most compatible HTML rendering engine, wrapped in Cocoa goodness? We believe Camino is the right browser for you. Welcome!
+
We're aware that switching browsers can be a disruptive, perhaps painful experience, so this page is designed to point out some common differences and help Camino feel right at home on your desktop and in your Dock.
  
We're aware that switching browsers can be a disruptive, perhaps painful experience, so this page is designed to point out some common differences and help Camino feel right at home on your desktop and in your Dock.
+
''Please note: any third-party utilities listed here are for informational purposes only; the Camino Project does not maintain or endorse any third-party utilities.''
  
 
==Migrating Your Safari Profile==
 
==Migrating Your Safari Profile==
Line 14: Line 14:
 
<!--Camino and Firefox share the same history file format, so you can copy <code>history.dat</code> from your Firefox profile into your Camino profile.  Your Firefox profile is located in <code>~/Library/Application Support/Firefox/Profiles/''profilename''/</code> (where <code>~</code> is your Home folder and <code>''profilename''</code> is the name of your Firefox profile, which is often a string of random characters), and your Camino profile is located in <code>~/Library/Application Support/Camino/</code>.-->Camino cannot currently import browsing history from Safari.
 
<!--Camino and Firefox share the same history file format, so you can copy <code>history.dat</code> from your Firefox profile into your Camino profile.  Your Firefox profile is located in <code>~/Library/Application Support/Firefox/Profiles/''profilename''/</code> (where <code>~</code> is your Home folder and <code>''profilename''</code> is the name of your Firefox profile, which is often a string of random characters), and your Camino profile is located in <code>~/Library/Application Support/Camino/</code>.-->Camino cannot currently import browsing history from Safari.
  
===Cookies, Cookie Permissions and Blocked Servers===
+
===Cookies===
 
 
'''what do we do here? anything?''' ''smorgan might write a cookie importer''
 
  
If you have a collection of cookies, cookie permissions (whether a site can set a cookie, or if the cookie should expire on quit, etc.) or other "blocked server" options, you can copy <code>cookies.txt</code> and <code>hostperm.1</code> from your Firefox profile into your Camino profile.
+
If you have a collection of cookies, you can use the third-party application [http://pimpmycamino.com/parts/cookiethief CookieThief] to import your Safari cookies into your new Camino profile (or to sync cookies back and forth if you’re still using Safari on the side).
  
 
===Custom Styles===
 
===Custom Styles===
  
If you have defined a set of custom styles selected Safari’s Advanced preferences, you can copy the file into a <code>userContent.css</code> in your Camino profile.  Your Camino profile is located in <code>~/Library/Application Support/Camino/</code> (where <code>~</code> is your Home folder).
+
If you have defined a set of custom styles selected Safari’s Advanced preferences, you can copy the file into a <code>userContent.css</code> file in your Camino profile.  Your Camino profile is located in <code>~/Library/Application Support/Camino/</code> (where <code>~</code> is your Home folder).
  
 
===Preferences===
 
===Preferences===
  
 
While Camino includes most of the same features you’re used to in Safari, Camino supports a different set of preferences.  We encourage you to explore Camino’s Preferences window and set the preferences to your linking.
 
While Camino includes most of the same features you’re used to in Safari, Camino supports a different set of preferences.  We encourage you to explore Camino’s Preferences window and set the preferences to your linking.
 +
 +
===Passwords===
 +
Camino 1.1 can read website passwords that Safari stored in the Keychain, so logging in to your favorite sites is just as simple as if you were using Safari.  (If you're still using Safari on the side, Safari will also be able to read any new Keychain entries created by Camino.)
  
 
===Other Files===
 
===Other Files===
 
While Camino and Safari both save passwords in the Mac OS X Keychain, both applications use different formats.  At the moment, there is currently no way to import Safari Keychain entries.
 
  
 
==Keyboard Shortcuts==
 
==Keyboard Shortcuts==
  
'''i'm up to here'''
+
Since Camino has a long history as a Mac browser, many of its keyboard shortcuts predate recent changes made by Apple on what seems to be whim and which sometimes make no sense or break standard Mac cursor movement behaviors.
 
 
Because Camino is a Mac-only browser, its keyboard shortcuts tend to be more in harmony with Mac OS X than Firefox, which seems to favor keyboard shortcuts that make more sense to Windows users.
 
  
 
A full list of Camino's keyboard shortcuts can be found in [http://www.caminobrowser.org/support/docs/shortcuts/ Camino : Documentation : Keyboard Shortcuts], but some of the most significant are listed below:
 
A full list of Camino's keyboard shortcuts can be found in [http://www.caminobrowser.org/support/docs/shortcuts/ Camino : Documentation : Keyboard Shortcuts], but some of the most significant are listed below:
  
 +
* Show All Bookmarks - Command-B    <!-- what other shortcuts are odd in sfri? -->
 +
* Show History - Command-Y
 +
* Next Tab - Command-Option-Right Arrow
 +
* Next Tab - Command-Option-Right Arrow
 +
* Downloads - Command-Shift-D (opens/focuses Downloads window)
 +
* Fill Form - Command-Option-F (fills in forms from your "Me" card in Address Book)
 
* Search the Web… - Command-Shift-F
 
* Search the Web… - Command-Shift-F
* Show History - Command-Y
 
 
* View Source - Command-Option-V   
 
* View Source - Command-Option-V   
* Show All Bookmarks - Command-B    <!-- what other shortcuts are odd in sfri? -->
 
  
 
If you would prefer to use some other keystroke for a certain menu option, you can use the standard Mac OS X method of customizing keyboard shortcuts, the "Keyboard & Mouse" pane of the '''System Preferences'''.
 
If you would prefer to use some other keystroke for a certain menu option, you can use the standard Mac OS X method of customizing keyboard shortcuts, the "Keyboard & Mouse" pane of the '''System Preferences'''.
Line 56: Line 57:
  
 
==Alternate Behaviors==
 
==Alternate Behaviors==
 +
 +
'''i'm up to here'''
  
 
* FAYT is really cool; explain it
 
* FAYT is really cool; explain it
Line 68: Line 71:
 
===Form Fill===
 
===Form Fill===
 
Camino is capable of filling in non-password forms on websites using information from your "Me" card in '''Address Book'''.  To fill in web forms, choose '''Fill Form''' from the '''Edit''' menu (or use the corresponding keyboard shortcut, or add the optional "Fill Form" toolbar button to your toolbar).
 
Camino is capable of filling in non-password forms on websites using information from your "Me" card in '''Address Book'''.  To fill in web forms, choose '''Fill Form''' from the '''Edit''' menu (or use the corresponding keyboard shortcut, or add the optional "Fill Form" toolbar button to your toolbar).
 +
 +
Camino of course fills in login and password forms using information saved in your Keychain, including information saved while using Safari.
  
 
==Extending Camino==
 
==Extending Camino==
  
Camino is developed using native Mac OS X technologies and toolkits
+
Camino includes a limited official mechanism for creating add-ons, known as “third-party preference panes.” There are a number of third-party add-ons that take advantage of this mechanism.  Like Safari, there are also a number of add-ons that do not use this official mechanism, and many popular third-party Safari “plug-ins” have Camino analogues (in addition, some features only available in Safari “plug-ins” are already present in Camino).
 +
 
 +
There are also a number of third-party themes for Camino, which may change the appearance of toolbar icons and tab widgets.
  
Because Camino is developed using native Mac OS X technologies and toolkits, it is not as easily (or as infinitely) customizable as Firefox.  However, most popular third-party Safari plugins have Camino analogues, and some features only available in Safari plugins are already present in Camino.  
+
'''Please note that none of these add-ons are supported or endorsed by the Camino Project; in addition, add-ons might not use the supported mechanism, may become outdated, and may break Camino.'''
  
[http://pimpmycamino.com PimpMyCamino] (run by [http://www.hicksdesign.co.uk Jon Hicks], of PimpMySafari fame and creator of the Firefox icon, and Camino theme wizard [http://www.fiberoptikz.tk/~slowmo/Camino.html David Feare]) is your one-stop shop for Camino add-ons including preference panes, themes, and other software.
+
[http://pimpmycamino.com PimpMyCamino] (run by [http://www.hicksdesign.co.uk Jon Hicks], of PimpMySafari fame and creator of the Firefox icon, and Camino theme wizard [http://www.fiberoptikz.tk/~slowmo/Camino.html David Feare]) is your one-stop shop for Camino add-ons including preference panes, themes, and other software that interacts with Camino.
  
A few popular Safari plugins and their Camino analogues are listed below, but be sure to visit [http://pimpmycamino.com PimpMyCamino] to see the ever-expanding world of third-party Camino add-ons.
+
A few popular Safari “plug-ins” and their Camino analogues are listed below, but be sure to visit [http://pimpmycamino.com PimpMyCamino] to see the ever-expanding world of third-party Camino add-ons.
  
* SafariBlock: [http://pimpmycamino.com/parts/camiflash CamiFlash]
+
* SafariBlock: '''Built in to Camino 1.5''' <!-- needs link to new section on annoyances docs -->
* PithHelmet: Camino’s [http://www.caminobrowser.org/support/docs/annoyances/#web_ads built-in ad-blocking], [http://pimpmycamino.com/parts/camiblock CamiBlock]
+
* PithHelmet: Camino’s [http://www.caminobrowser.org/support/docs/annoyances/#web_ads built-in ad-blocking] and [http://www.caminobrowser.org/support/docs/annoyances/#adv_block advanced content blocking]  
<!--* Stylish: [http://pimpmycamino.com/parts/camitools CamiStyle]
+
<!--* Stylish: [http://pimpmycamino.com/parts/camitools CamiStyle] -->
* GreaseMonkey: [http://pimpmycamino.com/parts/geekmonkey Geekmonkey]
+
* Creammonkey 0.7: [http://pimpmycamino.com/parts/geekmonkey Geekmonkey]
* DOM Inspector: [http://pimpmycamino.com/parts/mouseover-dom-inspector Mouseover DOM Inspector] -->
+
* WebKit DOM Inspector: [http://pimpmycamino.com/parts/mouseover-dom-inspector Mouseover DOM Inspector]
  
 
If you're interested in developing Camino preference panes, there is an initial bit of [[Development:Third-Party_prefPanes|documentation]] in the Camino Wiki.
 
If you're interested in developing Camino preference panes, there is an initial bit of [[Development:Third-Party_prefPanes|documentation]] in the Camino Wiki.

Latest revision as of 15:18, 16 April 2007

Trying Camino?

We're aware that switching browsers can be a disruptive, perhaps painful experience, so this page is designed to point out some common differences and help Camino feel right at home on your desktop and in your Dock.

Please note: any third-party utilities listed here are for informational purposes only; the Camino Project does not maintain or endorse any third-party utilities.

Migrating Your Safari Profile

Importing Bookmarks

Camino can import your Safari bookmarks. Simply choose Import Bookmarks… from Camino's File menu and select Safari from the drop-down menu in the window that appears. For more information on importing and working with bookmarks, see Camino : Documentation : Bookmarks.

History

Camino cannot currently import browsing history from Safari.

Cookies

If you have a collection of cookies, you can use the third-party application CookieThief to import your Safari cookies into your new Camino profile (or to sync cookies back and forth if you’re still using Safari on the side).

Custom Styles

If you have defined a set of custom styles selected Safari’s Advanced preferences, you can copy the file into a userContent.css file in your Camino profile. Your Camino profile is located in ~/Library/Application Support/Camino/ (where ~ is your Home folder).

Preferences

While Camino includes most of the same features you’re used to in Safari, Camino supports a different set of preferences. We encourage you to explore Camino’s Preferences window and set the preferences to your linking.

Passwords

Camino 1.1 can read website passwords that Safari stored in the Keychain, so logging in to your favorite sites is just as simple as if you were using Safari. (If you're still using Safari on the side, Safari will also be able to read any new Keychain entries created by Camino.)

Other Files

Keyboard Shortcuts

Since Camino has a long history as a Mac browser, many of its keyboard shortcuts predate recent changes made by Apple on what seems to be whim and which sometimes make no sense or break standard Mac cursor movement behaviors.

A full list of Camino's keyboard shortcuts can be found in Camino : Documentation : Keyboard Shortcuts, but some of the most significant are listed below:

  • Show All Bookmarks - Command-B
  • Show History - Command-Y
  • Next Tab - Command-Option-Right Arrow
  • Next Tab - Command-Option-Right Arrow
  • Downloads - Command-Shift-D (opens/focuses Downloads window)
  • Fill Form - Command-Option-F (fills in forms from your "Me" card in Address Book)
  • Search the Web… - Command-Shift-F
  • View Source - Command-Option-V

If you would prefer to use some other keystroke for a certain menu option, you can use the standard Mac OS X method of customizing keyboard shortcuts, the "Keyboard & Mouse" pane of the System Preferences.

  • First, quit Camino if it is running.
  • Open System Preferences.
  • Choose the "Keyboard & Mouse" pane.
  • Select the "Keyboard Shortcuts" tab.
  • Press the "+" button at the bottom of that tab.
  • In the "Applications" drop-down menu, choose "Camino".
  • In the "Menu Title" field, type the exact name of the menu item you want to change, and in the "Keyboard Shortcut" field, type the new shortcut you want that menu item to have. Hit OK to save the new shortcut.
  • You may now relaunch Camino.

Alternate Behaviors

i'm up to here

  • FAYT is really cool; explain it
  • Adding Search Engines (heh)

Location Bar Search

sfri doesn't do this, either

Camino's default behavior for non-URLs entered in the location bar is to construct a URL; e.g., if you type mikepinkerton in the location bar and hit return, Camino will visit http://www.mikepinkerton.com.

In Firefox the default behavior in this case is to run a search using Google’s "I’m Feeling Lucky" search. If you are fond of this behavior, you can configure Camino to mimic Firefox by setting the appropriate Hidden Preferences: set keyword.enabled to true and set keyword.URL to http://www.google.com/search?btnI=I%27m+Feeling+Lucky&q=.

Form Fill

Camino is capable of filling in non-password forms on websites using information from your "Me" card in Address Book. To fill in web forms, choose Fill Form from the Edit menu (or use the corresponding keyboard shortcut, or add the optional "Fill Form" toolbar button to your toolbar).

Camino of course fills in login and password forms using information saved in your Keychain, including information saved while using Safari.

Extending Camino

Camino includes a limited official mechanism for creating add-ons, known as “third-party preference panes.” There are a number of third-party add-ons that take advantage of this mechanism. Like Safari, there are also a number of add-ons that do not use this official mechanism, and many popular third-party Safari “plug-ins” have Camino analogues (in addition, some features only available in Safari “plug-ins” are already present in Camino).

There are also a number of third-party themes for Camino, which may change the appearance of toolbar icons and tab widgets.

Please note that none of these add-ons are supported or endorsed by the Camino Project; in addition, add-ons might not use the supported mechanism, may become outdated, and may break Camino.

PimpMyCamino (run by Jon Hicks, of PimpMySafari fame and creator of the Firefox icon, and Camino theme wizard David Feare) is your one-stop shop for Camino add-ons including preference panes, themes, and other software that interacts with Camino.

A few popular Safari “plug-ins” and their Camino analogues are listed below, but be sure to visit PimpMyCamino to see the ever-expanding world of third-party Camino add-ons.

If you're interested in developing Camino preference panes, there is an initial bit of documentation in the Camino Wiki.




  • hidden prefs page
  • PMC
    • shout-out to a few that mimic popular Fx extensions / features?
      (CamiStyle = Stylish; CamiBlock = FlashBlock & Adblock; Geekmonkey = GreaseMonkey; MODi = DOMi)
      A lot migrating Firefox users miss keyword.enabled - either link hidden pref or MoreCamino
    • themes
  • prefPane docs