aboutsummaryrefslogtreecommitdiffhomepage
path: root/README
diff options
context:
space:
mode:
authorGravatar Brendan Taylor <whateley@gmail.com>2010-12-03 21:19:29 -0700
committerGravatar Brendan Taylor <whateley@gmail.com>2010-12-03 21:19:29 -0700
commitbc62ae0b8752388f08513e3554d54d9f791b0358 (patch)
treec0275490460f1e990879e700dd3922510b37839e /README
parent123e73552c199e1efad6c2fb15e2d7128bc2b7e2 (diff)
document download handler
Diffstat (limited to 'README')
-rw-r--r--README9
1 files changed, 7 insertions, 2 deletions
diff --git a/README b/README
index 6dddb35..2ed6dd3 100644
--- a/README
+++ b/README
@@ -305,6 +305,9 @@ file).
- `data`: The cookie data. Only included for "PUT" requests.
* `scheme_handler`: handler to execute for each URI navigated to - the
navigation request will be ignored if handler prints "USED\n"
+* `download_handler`: executed when a download is started. the handler script
+ should print a path that the download should be saved to, or print nothing
+ to cancel the download.
* `fifo_dir`: location to store FIFOs.
* `socket_dir`: location to store sockets.
* `http_debug`: HTTP debug mode (value 0-3).
@@ -493,10 +496,12 @@ Handler scripts that are called by `uzbl` are passed the following arguments:
The script specific arguments are:
-* download
+* download handler
- `$8 url`: The URL of the item to be downloaded.
- - `$9 proxy`: (optional) The URL of an HTTP proxy.
+ - `$9 suggested_filename`: A filename suggested by the server or based on the URL.
+ - `$10 content_type`: The mimetype of the file to be downloaded.
+ - `$11 total_size`: The size of the file to be downloaded in bytes. This may be inaccurate.
* cookie handler