plowprobe (1) - Linux Manuals

plowprobe: Gather information from file sharing download links


plowprobe - Gather information from file sharing download links


plowprobe [OPTIONS]... [MODULE_OPTIONS]... URL|FILE...


plowprobe is a command-line tool designed for retrieving metadata from file-sharing download links. Information are printed on stdout (only alive links). Provided links can also be downloaded with plowdown(1).

Currently supported hosting sites list is available in README file.


Common options

-i, --interface=IFACE
If your machine has several network interfaces, force using IFACE interface.
Print results (on stdout) in a given format (for each non-dead link). Default string is: "%F%u%n". Interpreted sequences are:
raw % character
probe function return status (0 for success, 13 for dead link, see list below)
filename (can be empty string)
empty if %f is empty, or alias to "# %f%n".
filehash (can be empty string if not available). Usually MD5 or SHA1. If hoster supports several algorithms, the longest digest is used.
file identifier (can be empty string if not available). Usually included in input URL.
module name
filesize in bytes (can be empty string if not available). Note: it's often approximative.
tabulation character
file timestamp (can be empty string if not available). Unix epoch time is preferred.
download (source) url

Note: Metadata are often not fully available from hosters nor implemented by all modules.

Logging options

-v, --verbose=LEVEL
Set output verbosity 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.

Miscellaneous options

If no module is found for link, follow HTTP redirects (curl -L). Default is disabled.
Echo module name for each URL and exit. Faster than --printf=%m. Useful for wrappers.
Do not use curl config file (~/.curlrc).
Do not consider any configuration file.
Force using an alternate configuration file (instead of per-user or systemwide plowshare.conf). This option has no effect when --no-plowsharerc is defined.
Display all supported module names (one per line) and exit. Useful for wrappers.

Generic program information

-h, --help
Display this help and exit.
-H, --longhelp
Display complete help (with module options) and exit.
Output version information and exit.


There is none yet!


1) Filter alive links in a text file

$ plowprobe file_with_links.txt > file_with_active_links.txt # Or $ cat file_with_links.txt | plowprobe - > file_with_active_links.txt

2) Custom results format

# Print links information: filename and size $ plowprobe --printf '# %f (%s)%n%u%n'


This is the per-user configuration file.
Systemwide configuration file.

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


Possible exit codes are:

Success. Folder contain one or several files.
Fatal error. Upstream site updated or unexpected result.
No available module (provided URL is not supported).
Network error. Mostly curl related.
System generic error.
Link alive but temporarily unavailable.
Link alive but requires a password.
Link alive but requires some authentication (private or premium link).
Link is dead.
Unknown command line parameter or incompatible options.

If plowprobe is invoked with multiple links and one or several errors occur, the first error code is returned added with 100.


Plowshare was initially written by Arnau Sanchez. See the AUTHORS file for a list of some of the many other contributors.

Plowshare is (C) 2010-2014 The Plowshare Team


plowdown(1), plowup(1), plowdel(1), plowlist(1), plowshare.conf(5).