# 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
google | Search with google
lucky | Google "I'm feeling lucky search
image | Search google images
wikipedia | Search wikipedia.org
slang | Search urbandictionary.com
dictionary | Search dictionary.reference.com
scholar | search google scholar
clusty | search the internet with clusty
clhs | search the Common Lisp Hyper Spec
emacswiki | search the emacswiki
cliki | search the Common Lisp wiki
ratpoisonwiki | search the ratpoison wiki
stumpwmwiki | search the StumpWM wiki
savannah | search savannah.gnu.org
sourceforge | search sourceforge.net
freshmeat | search freshmeat.net
slashdot | search slashdot.com
kuro5hin | search kuro5hin.com
answers | search answers.com
creativecommons | search creativecommons.org
ebay | search ebay.com
bugzilla | search mozilla bugzilla
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 frame
C-x 5 0 | Close the current frame (all buffers in the frame are lost, at this point)
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