• InstallationOSX

This page is about installing Conkeror under Mac OS X. For instructions for other operating systems, read Installation.

Install XULRunner

Read XULRunner for guidance in installing XULRunner.

Install Conkeror

You can obtain Conkeror either with git or by downloading a snapshot archive.

git

To use Conkeror from the git repository, first clone the repository, using the command:

git clone git://repo.or.cz/conkeror.git

Later on, when you want to update:

git fetch
git log HEAD..origin  #optional, shows you the changes
git merge origin

`conkeror-spawn-helper`

If you want to be able to edit web page text fields in an external editor, you will need to build the included program, conkeror-spawn-helper. Please read ConkerorSpawnHelper for more details.

Last step

Run the following commands from a terminal, replacing /path/to/conkeror with the directory of your conkeror installation.

rm -rf /Applications/conkeror.mozdev.org/conkeror.app
/Library/Frameworks/XUL.framework/xulrunner-bin --install-app /path/to/conkeror

You will now have the application file /Applications/conkeror.mozdev.org/conkeror.app which you can use to launch conkeror. Alternatively, from a command line prompt:

/Applications/conkeror.mozdev.org/conkeror.app/Contents/MacOS/xulrunner -foreground [URL]

Default browser

First open /Applications/conkeror.mozdev.org/conkeror.app/Contents/Info.plist in your editor of choice and add the following directly after <dict>

    <key>CFBundleSignature</key>
    <string>CONK</string>
    <key>CFBundleIdentifier</key>
    <string>org.mozdev.conkeror</string>
    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleURLName</key>
            <string>Web site URL</string>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>http</string>
                <string>https</string>
            </array>
        </dict>
    </array>
    <key>CFBundleDevelopmentRegion</key>
    <string>English</string>

Now update with the command

touch /Applications/conkeror.mozdev.org/conkeror.app

Next simply open Safari. Goto the preferences option from the 'Safari' menu. On the 'General' tab, set conkeror.app as your default browser under 'Default web browser'.