Conkeror is being built to emulate Emacs as much as possible. You'll notice many of the key bindings are the same.
See the NEWS file for user visible changes between versions. There is also a ChangeLog that tracks changes to source files.
I'm using the emacs style key notation. C means control, M means Meta (or alt). As an example, holding down control and meta and then pressing the t key would be written C-M-t.
| g | open new URL |
| B, l | Go Back |
| F | Go Forward |
| R | Reload |
| C-g | Stop |
| c | Copy current URL to the clipboard |
| M-SPC | Copy 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 b | jump to bookmark |
| C-x r l | list all bookmarks |
| C-x r m | bookmark current URL |
| C-h b | List all key bindings |
| C-h i | Show this page. |
| C-h t | Show the Conkeror tutorial. |
| 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 |
| f | cycle through the document's frames. The background will flash red to indicate the focused frame. |
| 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, enter or tab | close i-search |
You will notice each href link and form input has a number (gray background) floating on top of it. if you type the number and press enter, the href will be followed, form button clicked, or form field focused. If you press M-RET, the link will be focused. C-RET and the link will be opened in a new buffer.
Often the floating numbers get in the way of the content, so they can be toggled with M-l. When invisible, either typing a number or pressing the 'n' key will show them for the duration of the command.
To copy the location of an image, press 'i'. For each image, a number (pink background) will appear at its corner. Type the number and the image location will be copied to the clipboard.
Note the image numbers disappear after the command is finished. To toggle the image numbers, press C-M-l.
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:
| Search with google | |
| 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 |
| xulplanet | search xulplanet.com |
| bugzilla | search the mozilla bug database |
| 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 |
| sheldonbrown | Search 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:
| adelicious | Add a delicious bookmark. |
| delicious | View your delicious bookmarks |
| sdelicious | Search your delicious bookmarks |
| sadelicious | Search all delicious bookmarks |
There are also Vi bindings available. enable them by putting
use_vi_keys();in your .conkerorrc file. or use
M-x use-vi-keys RET to
enable them for the session. : use-emacs-keys RET
switches back.
| 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 bufer |
| C-x k | kill buffer |
| C-x 5 C-f, 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 |
Windows opened by web pages (popup, etc) will open as a Mozilla Navigator window, not Conkeror. This is generally a Bad Thing. Press the Set Chrome button to use Conkeror, instead.
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. Use the following form to set your rc file. You'll have to restart conkeror to load the rc file. Here's an example value. It's what I use:
/home/sabetts/.conkerorrcIt must be an absolute path and must be a file.
Here are three common customizations:
add_webjump("keyword", "url");
add_command("command-name", function_name, []);
The 3rd argument is much like the interactive function in
emacs. Currently only "p" and "P" work. See bindings.js in the source
code for examples of how it works.
define_key(ctrlx_kmap, make_key("c", MOD_META), "command-name");
This binds C-x M-c to execute "command-name". Take a look at
bindings.js for the builtin keymaps and key bindings.
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 the following:
C-u C-nwill cause conkeror to scroll down 4 lines.
C-u 12 C-nwill 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.mozdev.org RETThis opens the conkeror project web page in a new buffer.
C-u C-u n 12 RETThis opens link number 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? I am working on adding a
second universal argument that would allow you to do both.
toggle-eod-space is a slightly ugly hack that should
help you read articles more smoothly. Imagine you're reading an
article. You start reading the beginning. Your eyes get to the bottom
of the screen, so you press Space to page down. You continue until
near the end of the article. You press Space to read the last part and
your browser only scrolls down part of a page, leaving where you left
off somwhere in the middle of the screen and not at the top where you
expected it. You spend the next couple seconds searching for where you
left off. toggle-eod-space adds 1 page of blank space to
the end of the web page, so your last page down is a full one. Note,
toggle-eod-space turns the feature on (or off) but the
space won't be added to (or removed from) the current page. It affects
the subsequently loaded pages.
Conkeror can block images, scripts, etc originating from servers
that match one of conkeror's adblock patterns. To add a pattern
use M-x adblock-add-pattern. The pattern is a regular
expression.
Take a look at who has contributed improvements to Conkeror. If someone is missing please let me know!