1. About Conkeror

Conkeror is a keyboard-oriented, highly-customizable, highly-extensible web browser based on Mozilla XULRunner, written mainly in JavaScript, and inspired by exceptional software such as Emacs and vi. Conkeror features a sophisticated keyboard system, allowing users to run commands and interact with content in powerful and novel ways. It is self-documenting, featuring a powerful interactive help system.

2. Community

Most development talk takes place on the IRC channel, however the mailing list is active and developers notify it when important things happen or break. The issue tracker's bug and feature request sections are generally up-to-date and tend to be very informative.

• IRC Channel (#conkeror at Freenode)

• Mailing List (Subscribe/Unsubscribe, Gmane Archives)

• Bug/Issue Tracker

• Feature Request Tracker

• Breaking Changes - Breaking changes listed by date.

• Example Configs - Links to users' RC scripts.

• Artwork - Icons and other Conkeror-inspired graphics.

3. Documentation

3.1. Installation and Startup

• Installation - Unix/Linux, OS X, Debian and derivatives, Windows

• Spawn Helper - Installing the spawn helper.

• Starting Conkeror - Command-line arguments and the steps taken at start-up.

• Profiles - Multiple instances and multiple configurations.

• Multiple XULRunners - How to install multiple XULRunner versions.

• Default Browser - Setting Conkeror as your default browser.

• Reporting Problems - How to report problems, like bugs.

• Requesting Features - How to request features.

3.2. Using Conkeror

3.2.1. Essentials

• Quick Start - A brief tour of the keys.

• FAQ - Frequently asked questions.

• Rc File - Configuration file or files loaded at start-up.

3.2.2. Mastering the UI

• Hinting - Mastering the numbers.

• Downloads - Working with downloads.

• Targets - The Target System: controlling where urls are opened.

• External Editing - Editing text form elements in an external program.

3.2.3. Environment

• Keyboard - Keyboard configuration.

• Proxy Management - Working with with proxy settings.

3.2.4. Content

• Webjumps - Working with webjumps - shortcuts to often-used pages.

• Default Webjump - Setting up a default webjump.

• Page Modes - Special functionality for particular web sites.

• External MIME Handlers - Handling MIME types with external programs. note: obsolete

• Content Handlers - Configuring actions and external programs for specific MIME types.

• Content Policy - Filtering and monitoring content requests.

• Focus - Dealing with web pages that steal focus.

3.2.5. Reference

• User Variables - Configuration settings controlled by variables.

• Modules - Optional functionality.

• Mozilla Extensions - Using Mozilla extensions.

• Mozilla Plugins - Using Mozilla plugins.

3.2.6. Misc

• Bookmarks - Bookmark management.

• Mode Line - Customizing the mode-line.

• Tab Bar - Tab bar module.

• Password Management - Working with Mozilla's password manager.

• Mozilla Preferences - Working with Mozilla preferences.

• Appearance - Changing appearance using styles and themes.

• Common Problems - Common problems with solutions.

• Tips from Users - User-contributed tips and tricks.

• Using Conkeror for Web Development - Specific web-development related tricks.

3.3. Programming Conkeror

• Startup - What happens when, during startup.

• Hooks - Working with hooks.

• Keymaps - Working with key bindings.

• Modes - Overview of mode types.

• Coroutines - How Conkeror's coroutine.js works.

• MinibufferReadWalkthrough - A practical walkthrough of coroutine usage.

• Writing Commands - Writing interactive commands.

• Writing Browser Object Commands - The what and how of browser objects.

• Writing Page Modes - Writing feature-suites for specific sites.

• Load Spec - The load_spec datatype.

• Object Orientation - Classical OO JavaScript tutorial.

3.4. Development Resources

• Roadmap - Future of Conkeror

• Development Guidelines - Development guidelines.

• Browse Code - Browse the git repository.

• Unit Tests - Writing unit tests.

• Bugs in Conkeror - Best practices for reporting bugs.

• Upstream Bugs - Known bugs in Mozilla that impact Conkeror.

• Git Help - Advice on developing with git.

• License - License agreement(s).

3.5. Mozilla Development Resources

• JavaScript Language and API Reference

• XUL API Reference

• File I/O Reference

• Gecko-Specific DOM Events

• XULRunner Reference

3.6. See Also

• repo.or.cz - Fast, free git hosting. (Currently Conkeror's git host.)

• Vonkeror - A vork of Conkeror vith many differences.

• Vimperator - Plug-in for Firefox to make it look and feel more like vim.

• espresso-mode An emacs JavaScript mode.

• js2-mode - An emacs JavaScript mode.

• StumpWM - A tiling, keyboard-driven X11 window manager inspired by Emacs and screen.

• Name change discussion

4. Using This Wiki

4.1. Site Navigation

• Recent Changes - See where people are currently working.

• WikiSandBox - Feel free to change this page and experiment with editing.

• FindPage - Search or browse the database in various ways.

• SyntaxReference - Quick access to wiki syntax.

• SiteNavigation - Get an overview over this site and what it contains.

4.2. How to Use This Site

A Wiki is a collaborative site, anyone can contribute and share:

• To edit this site, first create an account, then ask retroj, nicktastic, or jbms on #conkeror at irc.freenode.net for write access.

• Edit any page by pressing Edit at the top or the bottom of the page.

• Create a link to another page with joined capitalized words (like WikiSandBox) or with ["quoted words in brackets"].

• Search for page titles or text within pages using the search box at the top of any page.

• See HelpForBeginners to get you going, HelpContents for all help pages.