• UserVariables

User Variables

Conkeror has many behaviors that can be customized by setting certain ordinary variables in your rc script. We will try to describe them all here.

• active_hint_background_color
  • String color for the active hint. Default is "#88FF00".
• active_img_hint_background_color
  • String color for the active image hint. Default is "#88FF00".
• can_kill_last_buffer
  • Boolean controlling whether the kill-buffer command can kill the last buffer in a window.
• daemon_quit_exits

  • Boolean controlling whether daemon-mode abides the quit command. Default is true.

• default_directory

  • Default location for downloads. Do not set this variable directly. Use the function set_default_directory. If you call set_default_directory with no argument, Conkeror will attempt to use your home directory, which is the default value of this variable.

• download_buffer_automatic_open_target
  • Target for opening a download buffer for a new download. An open/follow target constant. Default is OPEN_NEW_WINDOW. Other possible values are OPEN_CURRENT_BUFFER, OPEN_NEW_BUFFER, OPEN_NEW_BUFFER_BACKGROUND.
• editor_shell_command

  • Default is the value of the environment variable EDITOR. If it has no value, default is "emacs". Non-null run_external_editor_function overrides this setting.

• hint_background_color
  • String color name for hints. Default is "yellow".
• img_hint_background_color
  • String color for image hints. Default is "yellow".
• kill_whole_line

  • Default is false. When true, the command cut-to-end-of-line will also cut the newline character at the end, when point is at the beginning of a line.

• mime_type_external_handlers

  • An array of two element arrays, associating mime type patterns with handler programs. The patterns are regular expressions. When conkeror looks for an external handler, the program corresponding to the first matching pattern will be used. The default value of mime_type_external_handlers is:

    [["text/", "emacs"],
     ["image/.*", "feh"],
     ["video/.*", "mplayer"],
     ["audio/.*", "mplayer"],
     ["application/pdf", "evince"],
     ["application/postscript", "evince"],
     ["application/x-dvi", "evince"],
     [".*", "emacs"]];

• run_external_editor_function
• title_format_fn
• url_completion_use_webjumps

  • Boolean. Default is true. Controls whether webjumps will be included in the completion list when prompting the user for an url, for example, with the open-url command.

• url_completion_use_bookmarks

  • Boolean Default is true. Controls whether bookmarks will be included in the completion list when prompting the user for an url, for example, with the open-url command.

• url_completion_use_history

  • Boolean Default is false. Controls whether urls in the browse history will be included in the completion list when prompting the user for an url, for example, with the open-url command.

• url_remoting_fn

  • "Url remoting" is the term for invoking Conkeror with an url (for example, from a command line) when a Conkeror process is already running. The new invocation is said to "remote" the url to the already running process. The variable url_remoting_fn is a function to dispatch on urls remoted into Conkeror. The default value is load_url_in_new_window. A popular alternative value is load_url_in_new_buffer. You can easily write your own url remoting function, too.