plowdown(1)

NAME
plowdown - Command-line downloader for file-sharing websites

SYNOPSIS
plowdown [OPTION]... [MODULE_OPTION]... URL|FILE [URL|FILE]...

DESCRIPTION
plowdown is a set of bash scripts designed for automatic downloads on file-sharing website. It acts like a web browser, retreiving pages and filling html forms (including captchas).

Currently supported hosting sites are:
    115.com 2shared.com 4shared.com badongo.com data.hu depositfiles.com divshare.com dl.free.fr humyo.com mediafire.com megaupload.com netload.in rapidshare.com sendspace.com uploading.com usershare.net x7.to zshare.net

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 prefixed 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.

-r, --limit-rate=SPEED
    Limit download speed in bytes per seconds. Suffixes are:
    k for kilobytes (Kb),
    m for megabytes (Mb),
    g for gigabytes (Gb).

-t, --timeout=SECS
    Cancel download after SECS seconds of waits.

--max-retries=N
    Set maximum retries for loops. Option mostly dedicated to hosting sites with captchas.

--temp-directory=DIRECTORY
    Directory where files are temporarily downloaded.

  Miscellaneous options

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

--run-download=COMMAND
    Run external HTTP downloader program (like wget). Available interpolations: %filename, %cookies, %url

--download-info-only=TEMPLATE
    Don't download the file but echo a string. Available interpolations: %filename, %cookies, %url

--cookies=FILE
    Use this option to bypass login process on registered (premium) accounts. Force use of a cookie file.

  Generic Program Information

-h, --help
    Display this help and exit.

--version
    Output version information and exit.

MODULE OPTIONS

  Rapidshare

-a, --auth=USER:PASSWORD
    Use Premium-Zone account.

  Megaupload

-a, --auth=USER:PASSWORD
    Use Free-membership or Premium account.

-p, --link-password=PASSWORD
    Used in password-protected files.

  X7.to

-b, --auth-free=USER:PASSWORD
    Use Free account.

NOTES

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

EXAMPLES

  1) Download one or several files
$ plowdown http://www.rapidshare.com/files/12345678/foo.rar

# Downloads are successive (not parrallel)
$ plowdown http://x7.to/abcdef http://www.megaupload.com/?d=ghijklmn

# Download a password-protected file from megaupload
$ plowdown -p somepassword http://www.megaupload.com/?d=opqrstuv

  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 -r 50K -i eth1 http://depositfiles.com/es/files/abcdefghi

  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 --run-download='wget -O "%filename" --load-cookies "%cookies" "%url"' http://x7.to/abcdef

  7) Safe download. Each URL will be limited in the number of tries (mainly for captchas) and wait delays.
$ alias plowdown='plowdown --no-overwrite --max-retries=20 --timeout=3600'

$ plowdown -m file_with_links.txt

AUTHORS
Written by Arnau Sanchez and Matthieu Crapet.

SEE ALSO
plowup(1), plowdel(1), plowlist(1)

COPYRIGHT
Copyright (c) 2008-2010 Plowshare Project. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.