plowprobe(1) - Linux man page

Name

plowprobe - Gather information from file-sharing

download links

Synopsis

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

Description

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.

Options

Common options

-i, --interface=IFACE: If your machine has several network interfaces, force using IFACE interface.
--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. Faster than --prinft=%m.
--follow: If no module is found for link, follow HTTP redirects (curl -L). Default is disabled.
--printf=FORMAT: Print results in a given format (for each non-dead link). Default string is: "%F%u". Interpreted sequences are:
%%: raw % character
%c: probe function return status (0 for sucess, 13 for dead link, see list below)
%f: filename (can be empty string)
%F: empty if %f is empty, or alias to "# %f%n".
%h: filehash (can be empty string if not available)
%m: module name
%n: newline
%s: filesize in bytes (can be empty string if not available). Note: it's often approximative.
%t: tabulation character
%u: download (source)

url

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.

Generic program information

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

Module Options

There is none yet!

Examples

1) Filter alive links in a text file

$ plowprobe file_with_links.txt > file_with_active_links.txt

2) Custom results format

# Print links informations: filename and size
$ plowprobe --printf "#%f (%s)\n%u" http://www.sendspace.com/file/5njdw7

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. Folder contain one or several files.
1: Fatal error. Upstream site updated or unexpected result.
2: No available module (provided URL is not supported).
3: Network error. Mostly curl related.
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.

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

Authors

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