NAME
conkeror - a web browser modeled after Emacs
SYNOPSIS
conkeror [options] [url] ...
DESCRIPTION
This manual page documents briefly conkeror
conkeror is a web browser based on xulrunner, the Mozilla application
framework that also powers Mozilla Firefox. It can be controlled
completely with the keyboard. The key bindings are very similar to
those from Emacs, so Emacs users should immediately feel at home.
OPTIONS
This program has the same options as all other xulrunner applications.
A summary of more important options is included below. All options are
listed by calling conkeror --help.
-h, --help
Show summary of options.
-v, --version
Show version of program.
--display=DISPLAY
X display to use
-P <profile>
Start with profile <profile>
-ProfileManager
Start with ProfileManager.
-no-remote
Open new instance, not a new window in running instance.
-UILocale <locale>
Start with <locale> resources as UI Locale.
-safe-mode
Disables extensions and themes for this session.
-jsconsole
Open the Error console.
CONCEPTS
Similar to Emacs Conkeror works with windows and buffers instead of
windows and tabs.
When changing buffers with C-x b or killing buffers with C-x k, you can
cut down the list of buffers by typing a few characters which filters
the list for buffers which match these characters and then choosing
them from the matching list of buffers with cursor keys.
The same idea is present with bookmarks: Bookmarks are looked up by
pressing g to go to a new page and then start typing parts of the
bookmarks title or URL.
TIPS AND TRICKS
If you want to bookmark a page with b and the page has frames or inline
frames (e.g. advertisements) you will be asked which frame to bookmark.
If you want to bookmark the whole page with all frames, press 0.
If you want to copy the link of the current page, press c for copy link
and then type 0 for the current page instead of a link on this page.
Instead of typing the link number when following or copying a link, you
can also type a part of the linked text. If don't type a number and one
links is already active (e.g. after going back one page in the history)
that link will be selected.
KEYBINDINGS
When you start it up initially you see the help page with all
information and a tutorial on how to use Conkeror. You always come back
there by typing C-h i which means pressing and holding the Control key
(on PCs this often is the Alt key) and then pressing "i". The tutorial
can be reached by pressing C-h t.
This is a short list of the most important key bindings:
C-x C-c
Exit the program
C-x C-f
Open an URL in a new buffer.
C-x C-v
Open an URL in the current buffer by editing the current URL.
C-x b Change buffer
C-x k Kill (close) buffer
M-p Change to previous buffer
M-n Change to next buffer
g Go to another URL
r Reload page
f Follow a link
C-u f Follow a link and open it in a new window
c Copy a link to clipboard
b Bookmark page
B Go to previous page (Backward) in page history
F Go to next page (Forward) in page history
[[ Go to previous page (Backward) in site navigation (if present)
]] Go to next page (Forward) in site navigation (if present)
C-g Stop (loading a the page, incremental search, etc.)
C-s Incremental search forward
C-r Incremental search backward
C-w Cut
C-y Paste
KNOWN BUGS
conkeror (respectively xulrunner) sometimes hangs at --help (and
possibly other situations) if /dev/random does not provide enough
entropy.
conkeror doesn't give feedback if a spawned external process crashes or
exits unsuccessfully.
FILES
The default location of Conkeror's user configuration file is
$HOME/.conkerorrc.
This can be changed by setting the preference conkeror.rcfile. The rc
can be an ordinary file or a directory. If it is an ordinary file,
Conkeror will evaluate that file as javascript. If it is a directory,
Conkeror will evaluate all files in that directory that have the .js
file extension.
See http://conkeror.org/ConkerorRC for the details.
SEE ALSO
xulrunner-1.9(1), the Conkeror wiki at http://conkeror.org/
AUTHOR
Conkeror was written by Shawn Betts, John J. Foerch, Jeremy Maitin-
Shepard and other. See /usr/share/doc/conkeror/CREDITS for a full list
of contributors.
This manual page was written by Axel Beckert <abe@deuxchevaux.org>, for
the Debian project (but may be used by others).
June 4, 2008