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 back  
F forward  
r 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.

conkerorwikiSearch conkeror.org
answerssearch answers.com
bugzillasearch mozilla bugzilla
clhssearch the Common Lisp Hyper Spec
clikisearch the Common Lisp wiki
creativecommonssearch creativecommons.org
dictionarySearch dictionary.reference.com
duckduckgoSearch with duckduckgo
ebaysearch ebay.com
googleSearch with google
imageSearch google images
kuro5hinsearch kuro5hin.com
luckyGoogle "I'm feeling lucky" search
mapsSearch Google Maps
ratpoisonwikisearch the ratpoison wiki
savannahsearch savannah.gnu.org
scholarsearch google scholar
slangSearch urbandictionary.com
slashdotsearch slashdot.com
sourceforgesearch sourceforge.net
stumpwmwikisearch the StumpWM wiki
wikipediaSearch wikipedia.org
wiktionarySearch wiktionary.org
yahoosearch yahoo

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

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

define_lastfm_webjumps("myusername");

this will create the following webjumps:

lastfm 
lastfm-user 
lastfm-music 
lastfm-group 
lastfm-tag 
lastfm-label 
lastfm-event 

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 buffer
C-x kkill buffer
C-x 5 f or C-u C-u gOpen an URL in a new window
C-x 5 0Close the current window (and all buffers in it)
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