plowprobe(1)

📦 version 2.1.7, in nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy

💖 plowprobe — it's giving Plowshare for Bash 4, bestie 💖

okay so you opened plowprobe(1) and honestly? good choice. this is the girl in the group chat who pulls metadata out of file-sharing links like it's nothing. let's get into it 💅

✨ NAME ✨

plowprobe — gather information from file sharing download links 🫶

🦋 SYNOPSIS 🦋

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

🌸 DESCRIPTION 🌸

so plowprobe is a command-line tool whose whole entire job is retrieving metadata from file-sharing download links. it prints that info on stdout — and bestie, only the alive links make it to the output, we don't do dead links here 💀

oh and the links you feed it? you can also just download them with plowdown(1). no cap. 🌈

💅 OPTIONS 💅

🎀 Common options

  • -i, --interface=IFACE — if your machine has several network interfaces, this forces it to use the IFACE one. pick your fighter ✨
  • --printf=FORMAT — print results (on stdout) in a given format, for each non-dead link. the default format string is "%F%u%n". here are the interpreted sequences, and yes we're listing all of them:
    • %% — raw % character
    • %c — probe function return status (0 for success, 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). Usually MD5 or SHA1. If hoster supports several algorithms, the longest digest is used.
    • %i — file identifier (can be empty string if not available). Usually included in input URL.
    • %m — module name
    • %n — newline
    • %s — filesize (positive integer) in bytes (can be empty string if not available). Note: It's often approximative.
    • %t — tabulation character
    • %T — file timestamp (can be empty string if not available). Unix epoch time is preferred.
    • %u — download (source) url
    • %U — same as %u but url is escaped for JSON usage
    • %v — alternate or refactored download url. This can be for example fixing primary hostname (to avoid HTTP 301 redirection), or force HTTPS protocol. If not available, alias to %u.
    • %V — same as %v but url is escaped for JSON usage
Note: Metadata are often not fully available from hosters nor implemented by all modules. so like, manage your expectations bestie 😭

🧚 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. silence is golden 💜

🌈 Miscellaneous options

  • --no-color — disables log messages (stderr only) output coloring. the monochrome era 😔
  • --follow — if no module is found for link, follow HTTP redirects (curl -L). Default is disabled.
  • --get-module — echo module name for each URL and exit. Faster than --printf=%m. Useful for wrappers.
  • --no-curlrc — do not use curl config file (~/.curlrc).
  • --curlrc=FILE — force using an alternate curl configuration file. Replaces ~/.curlrc if it exists. This option has no effect when --no-curlrc is defined.
  • --no-plowsharerc — do not consider any configuration file.
  • --plowsharerc=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.
  • --modules — 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.
  • --version — output version information and exit.

🎀 MODULE OPTIONS 🎀

There is none yet! literally nothing. empty. a blank canvas. iconic behavior honestly 💀✨

🍓 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). go read it, i'll wait 🫶

  • ~/.config/plowshare/modules.d/ — user directory considered when searching for modules at startup (plowprobe will try to open ~/.config/plowshare/modules.d/*/config). One file per module (hoster).

🌈 ENVIRONMENT VARIABLES 🌈

the following environment variables may affect plowprobe:

  • HOME — search for user configuration directory in ~/.config/plowshare (see FILES section above). If found, ~/.curlrc will be used (use --no-curlrc to disable it).
  • PLOWSHARE_CURL — specifies an alternate curl command ($PATH search is considered). If not defined, curl is used.
  • XDG_CONFIG_HOME — the directory to store user configuration files. If not defined, ~/.config is assumed.

💀 EXIT CODES 💀

possible exit codes are, and listen carefully because these matter:

  • 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.
  • 15 — 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. math is math, bestie 🧮

🫶 AUTHORS 🫶

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

Plowshare is (C) 2010-2016 The Plowshare Team

🔥 SEE ALSO 🔥

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

and that's the whole page, bestie!! this one ships under GPL, dated July 13, 2016 — shoutout to the <rainbow>Plowshare for Bash 4</rainbow> era, we love a classic 💖✨ go probe some links, you got this 🦋

📦 where this page comes from