Conkeror User Manual


Introduction

Conkeror is a Mozilla-based web browser whose design is inspired by GNU Emacs.

You can learn Conkeror's key bindings by reading the tutorial. The keyboard shortcut to visit the tutorial is C-h t. That is, first press Ctrl-h, then release those keys, and press t.


Overview of the Keys

Browsing

key M-x command meaning
g find-url open new URL
B go-back  
F go-forward  
r revert-buffer reload
C-g abort stop
C-h i help-page Show this page.
C-h t tutorial Show the Conkeror tutorial.

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
M-vPage up
M-<Beginning of document
M->End of document
C-sOpen i-search forward
C-rOpen i-search backward

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, RET or TABClose i-search

Webjumps

Webjumps are similar to, but potentially more powerful than Firefox's bookmark keywords. You type a webjump name into the location prompt, followed by one or more search terms. Conkeror substitutes your search terms into an url associated with the webjump.

Conkeror has a few webjumps already, but you can find many more, and share your own at the webjumps page of the conkeror wiki.

googleSearch with google
imageSearch google images
wikipediaSearch wikipedia.org
slangSearch urbandictionary.com
dictionarySearch dictionary.reference.com
scholarsearch google scholar
clustysearch the internet with clusty
xulplanetsearch xulplanet.com
bugzillasearch the mozilla bug database
clhssearch the Common Lisp Hyper Spec
emacswikisearch the emacswiki
clikisearch the Common Lisp wiki
ratpoisonwikisearch the ratpoison wiki
stumpwmwikisearch the StumpWM wiki
savannahsearch savannah.gnu.org
sourceforgesearch sourceforge.net
freshmeatsearch freshmeat.net
slashdotsearch slashdot.com
kuro5hinsearch kuro5hin.com
sheldonbrownSearch sheldonbrown.com

delicious webjumps can be added by putting the following in your rc file:

add_delicious_webjumps ("myusername");

this will create the following webjumps:

adeliciousAdd a delicious bookmark.
deliciousView your delicious bookmarks
sdeliciousSearch your delicious bookmarks
sadeliciousSearch all delicious bookmarks

You can easily add your own custom webjumps as such:

define_webjump("reddit", "http://www.reddit.com/search?q=%s");

The above will define the "reddit" webjump which searches reddit threads. The "%s" in the URL will be replaced by the search term you enter after the webjump name. I.e. entering "reddit haskell compiler" in the minibuffer will redirect you to the search results for reddit threads matching "haskell compiler" as a search string.

Buffer Management

C-u gOpen an URL in a new buffer
C-x bSelect a buffer based on it's name.
M-pprevious buffer
M-nNext bufer
C-x kkill buffer
C-x 5 f or C-u C-u gOpen an URL in a new frame
C-x 5 0Close the current frame (all buffers in the frame are lost, at this point)
C-x C-cQuit conkeror

Universal Argument

Conkeror support the universal argument, C-u. It's a prefix binding that changes how a command behaves. In Conkeror, C-u has two main effects. The first effect is that the command will be executed multiple times. For example, typing C-u C-n will cause conkeror to scroll down 4 lines. C-u 12 C-n will cause conkeror to scroll down 12 lines. The second effect is to open in a new buffer or a new window. C-u g conkeror.org RET This opens the conkeror project web page in a new buffer. C-u C-u n 12 RET will open link no. 12 in a new window.

There are some commands where the effect is ambiguous. Does C-u B go back four pages in the history or does it go back one and open the result in a new buffer? We are working on adding a second universal argument that would allow you to do both.


Conkeror Resources