Conkeror User Manual

Introduction

Conkeror is being built to emulate Emacs as much as possible. You'll notice many of the key bindings are the same.

Some common key bindings

I'm using the emacs style key notation. C means control, A means alt. As an example, holding down control and alt and then pressing the t key would be written C-A-t.

Browsing

C-l, gopen new URL
B, lGo Back
FGo Forward
rReload
C-gStop
cCopy current URL to the clipboard
A-SPCCopy the X11 cut buffer to mozilla's clipboard. This is a cheap hack because I can't figure out how to override the mozilla past function.
C-x r bjump to bookmark
C-x r llist all bookmarks
C-x r mbookmark current URL
C-h bList all key bindings

Movement

C-abeginning of line
C-eend of line
C-fForward a column
C-bbackward a column
C-nForward a line
C-pbackward a line
C-vPage down
A-vPage up
A-<Beginning of document
A->End of document
C-sOpen i-search forward
C-rOpen i-search backward
fcycle through the document's frames. The background will flash red to indicate the focused frame.

I-Search

C-ssearch forward
C-rsearch backward
C-gquit i-search (jump back to where i-search started)
backspaceundo search
any modifier plus a key, enter or tabclose i-search

Numbered Links

You will notice each href link and form input has a number beside it. if you type the number and press enter, the href will be followed, form button clicked, or form field focused. If you press A-enter, the link will be focused.

Web Jump

In firefox this is the bookmark keyword feature. You type the keyword into the location followed by some text your browser jumps to the bookmark with the %s in the bookmark's URL substituted for this text.

Conkeror also has this feature, but it's seperate from bookmarks. Here are the built in web jumps:
googleSearch with google
wikipediaSearch wikipedia.org
slangSearch urbandictionary.com
dictionarySearch dictionary.reference.com

Browser Management

C-x C-fOpen an URL in a new browser
C-x bSelect a browser based on it's name.
A-pprevious browser
A-nNext browser
C-x kkill browser
C-x 5 C-fOpen an URL in a new frame
C-x 5 0Close the current frame (all browsers in the frame are lost, at this point)
C-x C-cQuit conkeror

Conkeror RC File

If you want to add a key binding, a new command, or some other customization then you need to create your rc file. The rc file is just a javascript file that will get evaluated on startup. Conkeror checks the "conkeror.rcfile" preference and if it exists, loads it and evaluates it. Follow these steps to tell Conkeror where your rcfile is:

  1. Create a new file called conkeror.js in /path/to/mozilla/greprefs/
  2. Put this in the file:
    pref("conkeror.rcfile", "/path/to/rcfile");
    
    Here's what I use on my GNU/Linux box:
    pref("conkeror.rcfile", "/home/sabetts/.conkerorrc");
    
  3. Now fill your rc file with all your favorite hacks. Sorry, no lisp yet.
  4. Restart Conkeror and enjoy.

Here are three common customizations:

Conkeror Resources