# 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-a | beginning of line
C-e | end of line
C-f | Forward a column
C-b | backward a column
C-n | Forward a line
C-p | backward a line
C-v | Page down
M-v | Page up
M-< | Beginning of document
M-> | End of document
C-s | Open i-search forward
C-r | Open i-search backward

### I-Search

C-s | Search forward
C-r | Search backward
C-g | Quit i-search (jump back to where i-search started)
backspace | Undo search
any modifier plus a key, RET or TAB | Close 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.

conkerorwiki | Search conkeror.org
answers | search answers.com
bugzilla | search mozilla bugzilla
clhs | search the Common Lisp Hyper Spec
cliki | search the Common Lisp wiki
creativecommons | search creativecommons.org
dictionary | Search dictionary.reference.com
duckduckgo | Search with duckduckgo
ebay | search ebay.com
google | Search with google
image | Search google images
kuro5hin | search kuro5hin.com
lucky | Google "I'm feeling lucky" search
maps | Search Google Maps
ratpoisonwiki | search the ratpoison wiki
savannah | search savannah.gnu.org
scholar | search google scholar
slang | Search urbandictionary.com
slashdot | search slashdot.com
sourceforge | search sourceforge.net
stumpwmwiki | search the StumpWM wiki
wikipedia | Search wikipedia.org
wiktionary | Search wiktionary.org
yahoo | search yahoo

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

    add_delicious_webjumps("myusername");

this will create the following webjumps:

adelicious | Add a delicious bookmark.
delicious | View your delicious bookmarks
sdelicious | Search your delicious bookmarks
sadelicious | Search 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 g | Open an URL in a new buffer
C-x b | Select a buffer based on it's name.
M-p | previous buffer
M-n | Next buffer
C-x k | kill buffer
C-x 5 f or C-u C-u g | Open an URL in a new window
C-x 5 0 | Close the current window (and all buffers in it)
C-x C-c | Quit 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

- Conkeror homepage