plowdown(1) - Linux man page

Name

websites

Synopsis

Description

Currently supported hosting sites list is available in README file.

Options

Common options

-c, --check-link

Check and write alive link(s) to standard output, files are not downloaded.

-m, --mark-downloaded

Mark downloaded links in (regular) file arguments.

-o,--output-directory=DIRECTORY

Directory where files will be saved. Default is current directory.

-x, --no-overwrite

Do not overwrite existing files. Existing file will be preserved and filename will be suffixed with .1, .2, and so on.

Logging options

-v, --verbose=LEVEL

Set output verbose level:

0 none,

1 errors,

2 notice (default behavior),

3 debug,

4 report (very noisy, log HTML pages).

-q, --quiet

Alias for -v0. Do not print any debug messages.

Tuning settings

-i, --interface=IFACE

If your machine has several network interfaces, force using IFACE interface.

--max-rate=SPEED

Limit download speed in bytes per second. Suffixes are:

k for kilobytes (kB i.e. 1000),

M for megabytes (MB i.e. 1000^2),

K or Ki for kibibytes (KB or KiB i.e. 1024),

m or Mi for mebibytes (mB or MiB i.e. 1024^2).

-t, --timeout=SECS

Cancel download after SECS seconds of waits. Apply on module exit value: 10 (temporary unavailable error). This error can be returned in various cases: unallowed parallel download, daily downloads limit reached, remote hoster overloaded. Default option value is disabled (no timeout, infinite) and applies for one single URL download.

-r, --max-retries=N

Set maximum retries for download failures. Apply on module exit value: 3 (network error), 7 (captcha error). Default option value is 2 (i.e. 3 tries) and applies for one single URL download.

--9kweu=KEY

Use 9kw.eu service to solve captchas.

--antigate=KEY

Use Antigate.com service to solve captchas.

--captchabhood=USER:PASSWORD

Use Captcha Brotherhood service to solve captchas.

--deathbycaptcha=USER:PASSWORD

Use Death by Captcha service to solve captchas.

--captchamethod=METHOD

Force specific captcha solving method. Available values:

imgur : upload image to Imgur.com service, print image url in console. Useful for NAS and embedded devices.

none : abort if captcha solving is requested (even if automatic solving service is available).

online : use captcha solving website (9kweu, Antigate, CaptchaBrotherhood or DeathByCaptcha account required).

nox : display image in console (text) and prompt for manual entering. Looks for ascii viewers: img2txt, aview, tiv.

prompt : display image (X11 or text) and prompt for manual entering. Looks for viewers: display, sxiv, qiv, img2txt, aview, tiv.

--captchaprogram=SCRIPT

Call external program (or script) for solving captcha.

Three arguments are given:

$1 module name (lowercase). For example: mediafire.

$2 image filename (with full path).

$3 hint or captcha type (string).

Return value and exit status:

0 : solving success. Result must be printed on stdout.

2 : external solver is not able to solve requested captcha. Let plowdown continue solving it normally (will consider --captchamethod if specified).

7 : external solver failed. Note: this exit code is eligible with retry policy (-r/--max-retries).

Note: plowdown legacy exit errors can also be returned, for example: 1 (fatal) or 3 (network).

--temp-directory=DIRECTORY

Directory where files are temporarily downloaded.

--temp-rename

Append .part suffix to filename while file is being downloaded. Download resume will not work with this option.

Miscellaneous options

--cookies=FILE

Use provided cookie file for HTTP requests. This can be used to bypass login process on registered (premium) accounts. This is not implemented by all modules.

--fallback

If no module is found for link, simply download it (HTTP GET).

--no-curlrc

Do not use curl config file (~/.curlrc).

--no-plowsharerc

Do not use local or global config file (plowshare.conf).

--get-module

Get module(s) for URL(s) and quit. Useful for wrappers.

--printf=FORMAT

Don't process final link, print results in a given format (for each link). This can be useful for wrappers. Interpreted sequences are:

%%

raw % character

%c

final cookie file (with full path)

%C

%c or empty string if module does not require it

%d

download (final) url

%f

destination (local) filename

%F

destination (local) filename (with output directory)

%m

module name

%n

newline

%t

tabulation character

%u

download (source)

--exec=COMMAND

Don't process final link, execute command (for each link). This can be useful to run external download manager (like wget). Interpreted sequences are the same used by --printf option.

If this option is used several times, the last one will be used.

Generic program information

-h, --help

Display main help and exit.

-H, --longhelp

Display complete help (with module options) and exit.

--version

Output version information and exit.

Module Options

Common options

-a, --auth=USER:PASSWORD

Use premium account.

-b, --auth-free=USER:PASSWORD

Use free account.

-p, --link-password=PASSWORD

Used for password-protected files.

All switches are not implemented nor required for all modules. See long help message for detailed modules option list.

Notes

Command line authentication string format Complete login must have USER:PASSWORD format. The first semi-colon character is the separator. So, PASSWORD can contain a semi-colon character without any trouble.

Don't forget to single-quote string if your password contain shell expandable characters (like space, $ or &).

Examples

1) Download one or several files

$ plowdown http://www.rapidshare.com/files/12345678/foo.rar

# Downloads are successive (not parallel)
$ plowdown http://depositfiles.com/files/fv2u9xqya http://hotfile.com/dl/68261330/2f2926f/

# Download a password-protected file from mediafire
$ plowdown -p somepassword http://www.mediafire.com/?mt0egmhietj60iy

# Download using an account (free or premium, not supported by all modules)
$ plowdown -a myuser:mypassword http://hotfile.com/dl/68261330/2f2926f/

2) Download a list of links (one link per line) commenting out (with #) those successfully downloaded

$ plowdown -m file_with_links.txt

3) Download with restrictions

$ plowdown --max-rate 900K -i eth1 http://depositfiles.com/files/fv2u9xqya

4) Download with a proxy (3128 is the default port)

$ export http_proxy=http://192.168.0.20:80

$ plowdown http://www.rapidshare.com/files/12345678/foo.rar

5) Filter alive links in a text file

$ plowdown -c file_with_links.txt > file_with_active_links.txt

6) Use an alternatice web retriever for the final file download

$ plowdown --exec 'wget --load-cookies %c -O "%f" %d' http://uploading.com/files/39267me4/foo.zip/

7) Safe download. Each URL will be limited in the number of tries and wait delays.

$ alias plowdown='plowdown --no-overwrite --max-retries=10 --timeout=3600'

$ plowdown -m file_with_links.txt

Files

~/.config/plowshare/plowshare.conf

This is the per-user configuration file.

/etc/plowshare.conf

Systemwide configuration file.

The file format is described in plowshare.conf(5).

Exit Codes

Possible exit codes are:

0

Success. It also means that link is alive if plowdown is invoked with -c/--check-link command-line option.

1

Fatal error. Upstream site updated or unexpected result.

2

No available module (provided URL is not supported).

3

Network error. Mostly curl related.

4

Authentication failed (bad login/password).

5

Timeout reached (refer to -t/--timeout command-line option).

6

Maximum tries reached (refer to -r/--max-retries command-line option).

7

Captcha generic error.

8

System generic error.

10

Link alive but temporarily unavailable.

11

Link alive but requires a password.

12

Link alive but requires some authentication (private or premium link).

13

Link is dead.

14

Can't download link because file is too big (need permissions).

15

Unknown command line parameter or incompatible options.

If plowdown is invoked with multiple links or link-list files and one or several errors occur, the first error code is returned added with 100.

Authors

Plowshare is (C) 2010-2013 The Plowshare Team

See Also