Download buffers are opened automatically whenever you start a download, and whenever you use the download-show command. Those buffers can be opened in a new window, or in a new buffer in the current window. The default is to open them in a new window. This is controlled by the variable, download_buffer_automatic_open_target, which can either be a single target, or an array of two targets. When it is an array, the second target given will be used by download-show when it is called with universal-argument. The default is [OPEN_NEW_WINDOW, OPEN_NEW_BUFFER_BACKGROUND]. A popular alternative is to reverse the order of the two targets:

download_buffer_automatic_open_target = [OPEN_NEW_BUFFER_BACKGROUND, OPEN_NEW_WINDOW];

If you don't want a download buffer to open automatically ever, put the following in your rc:

remove_hook("download_added_hook", open_download_buffer_automatically);

To open a download buffer manually, do M-x download-show. You will be prompted for a download from a list of your current downloads. When called with universal-argument, download-show will use the second target from download_buffer_automatic_open_target, if there is one.

Within a download buffer, the following key bindings are in effect:

d

download-cancel

Cancel the download. File will be deleted.

p

download-pause-or-resume

Toggle the paused state of the download.

r

download-retry-or-resume

Resume or restart a paused or cancelled download.

delete

download-remove

Remove the current download from the download manager. This command can only be used on inactive (paused, canceled, completed, or failed) downloads.

C-d

download-remove

x

download-shell-command

Run a shell command on the downloaded file. If the download is not complete, the action will be queued.

o

download-shell-command

It comes as a surprise to many people that the g key, and other bindings found in content buffers are not available in download buffers. Much of this is due to the separation of buffer types for security: a special buffer cannot become a content buffer, and a content buffer cannot become a special buffer. It is also worth bearing in mind that single-key alphanumeric bindings are always considered context-based shortcuts in Conkeror. To browse to an url in a new content buffer, use C-x C-f.

If you would rather use the Xulrunner built-in Downloads window, like Firefox has, you can open it by M-x download-manager-show-builtin-ui.

Downloads (last edited 2009-06-07 17:34:36 by JohnFoerch)