1plowdown(1) Plowshare GIT-c58a80e plowdown(1)
3
7 plowdown - Command-line downloader for file-sharing websites
8
11 plowdown [OPTIONS]... [MODULE_OPTIONS]... URL|FILE [URL|FILE]...
12
15 plowdown is a set of bash scripts designed for automatic downloads on
16 file-sharing website. It acts like a web browser, retreiving pages and
17 filling html forms (including captchas).
18 Currently supported hosting sites list is available in README file.
20
23 Common options
24 -c, --check-link
25 Check and write alive link(s) to standard output, files are not
26 downloaded.
27 -m, --mark-downloaded
29 Mark downloaded links in (regular) file arguments.
30 -o, --output-directory=DIRECTORY
32 Directory where files will be saved. Default is current direc‐
33 tory.
34 -x, --no-overwrite
36 Do not overwrite existing files. Existing file will be preserved
37 and filename will be prefixed with .1, .2, and so on.
38 Logging options
40 -v, --verbose=LEVEL
41 Set output verbose level:
42 0 none,
43 1 errors,
44 2 notice (default behavior),
45 3 debug,
46 4 report (very noisy, log HTML pages).
47 -q, --quiet
49 Alias for -v0. Do not print any debug messages.
50 Tuning settings
52 -i, --interface=IFACE
53 If your machine has several network interfaces, force using
54 IFACE interface.
55 -r, --limit-rate=SPEED
57 Limit download speed in bytes per seconds. Suffixes are:
58 k for kilobytes (Kb),
59 m for megabytes (Mb),
60 g for gigabytes (Gb).
61 -t, --timeout=SECS
63 Cancel download after SECS seconds of waits. Default is dis‐
64 abled.
65 --max-retries=N
67 Set maximum retries for loops. Option mostly dedicated to host‐
68 ing sites with captchas. Default is 1.
69 --captchatrader=USER:PASSWORD
71 Use CaptchaTrader account to solve captcha. If not specified,
72 display image and prompt for manual entering.
73 --temp-directory=DIRECTORY
75 Directory where files are temporarily downloaded.
76 --no-arbitrary-wait
78 Do not wait on temporarily unavailable link (when no time delay
79 information is registered).
80 Miscellaneous options
82 --get-module
83 Get module(s) for URL(s) and quit. Useful for wrappers.
84 --run-download=COMMAND
86 Run external HTTP downloader program (like wget). Available
87 interpolations: %filename, %cookies, %url
88 --download-info-only=TEMPLATE
90 Don't download the file but echo a string. Available interpola‐
91 tions: %filename, %cookies, %url
92 --cookies=FILE
94 Use this option to bypass login process on registered (premium)
95 accounts. Force use of an external cookie file.
96 Generic program information
98 -h, --help
99 Display this help and exit.
100 --version
102 Output version information and exit.
103
106 Common options
107 -a, --auth=USER:PASSWORD
108 Use premium account.
109 -b, --auth-free=USER:PASSWORD
111 Use free account.
112 -p, --link-password=PASSWORD
114 Used in password-protected files.
115 All switches are not implemented nor required for all modules. See
117 help message for detailed modules option list.
118
121 Command line authentication string format
122 Complete login must have USER:PASSWORD format. The first semi-colon
123 character is the separator. So, PASSWORD can contain a semi-colon char‐
124 acter without any trouble.
125 Don't forget to single-quote string if your password contain shell
127 expandable characters (like space, $ or &).
128
131 1) Download one or several files
132 $ plowdown http://www.rapidshare.com/files/12345678/foo.rar
133 # Downloads are successive (not parrallel)
135 $ plowdown http://x7.to/abcdef http://www.megaupload.com/?d=ghijklmn
136 # Download a password-protected file from megaupload
138 $ plowdown -p somepassword http://www.megaupload.com/?d=opqrstuv
139 2) Download a list of links (one link per line) commenting out (with #)
141 those successfully downloaded
142 $ plowdown -m file_with_links.txt
143 3) Download with restrictions
145 $ plowdown -r 50K -i eth1 http://depositfiles.com/es/files/abcdefghi
146 4) Download with a proxy (3128 is the default port)
148 $ export http_proxy=http://192.168.0.20:80
149 $ plowdown http://www.rapidshare.com/files/12345678/foo.rar
150 5) Filter alive links in a text file
152 $ plowdown -c file_with_links.txt > file_with_active_links.txt
153 6) Use an alternatice web retriever for the final file download
155 $ plowdown --run-download='wget -O "%filename" --load-cookies "%cookies" "%url"' http://x7.to/abcdef
156 7) Safe download. Each URL will be limited in the number of tries (mainly
158 for captchas) and wait delays.
159 $ alias plowdown='plowdown --no-overwrite --max-retries=20 --timeout=3600'
160 $ plowdown -m file_with_links.txt
161
164 ~/.config/plowshare/plowshare.conf
165 This is the per-user configuration file.
166 /etc/plowshare.conf
168 Systemwide configuration file.
169 The file format is described in plowshare.conf(5).
171
174 Possible exit codes are:
175 0 Success. It also means that link is alive if plowdown is invoked
177 with -c/--check-link command-line option.
178 1 Fatal error. Upstream site updated or unexpected result.
180 2 No available module (provided URL is not supported).
182 3 Network error. Mostly curl related.
184 4 Site login failed.
186 5 Timeout reached (refer to -t/--timeout command-line option).
188 6 Maximumn tries reached (refer to --max-retries command-line
190 option).
191 7 Captcha generic error.
193 8 System generic error.
195 10 Link alive but temporarily unavailable.
197 11 Link alive but requires a password.
199 12 Link alive but requires some authentication (premium link).
201 13 Link is dead.
203 If plowdown is invoked with multiple links or a link-list file and if
205 one or several errors occur, the first error code is returned added
206 with 100.
207
210 Plowshare was initially written by Arnau Sanchez. See the AUTHORS file
211 for a list of some of the many other contributors.
212 Plowshare is (C) 2010-2011 The Plowshare Team
214
216 plowup(1), plowdel(1), plowlist(1), plowshare.conf(5).
217GPL November 5, 2011 plowdown(1)