plowlist(1)

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

okay so this is the manual page for plowlist(1), part of Plowshare for Bash 4 💖. Buckle up, it's giving very useful.

🌸 NAME 🌸

plowlist — lists links from shared folders websites 🦋

👑 SYNOPSIS 👑

plowlist [OPTIONS]...  [MODULE_OPTIONS]...  URL...

💅 DESCRIPTION 💅

plowlist is a command-line tool, and its whole personality is listing links (files) on file-sharing websites. That's it, that's the job ✨. The links it hands you can be downloaded later with plowdown(1) — so think of plowlist as the girl who finds the links and plowdown as the girl who actually goes and gets them. tag team 💞

🎀 OPTIONS 🎀

💜 Common options

  • -i, --interface=IFACE — if your machine has several network interfaces (main character with options, love that for you), this forces it to use the IFACE interface.
  • -R, --recursive — recurse into sub folders. yes bestie, go deeper 🌀
  • -t, --timeout=SECS — so useful for mirroring/multi-upload services. Remote links might not be available yet, or only partially — and when that happens, the module exit status is 10 (temporary unavailable error). plowlist will wait exponentially until SECS (seconds) is reached. When you don't specify it, this option is zero (no wait, same legacy behavior) and it applies for one single URL listing. Note: don't give a too big value here (the manpage's advice is a few minutes), because some hosters may be stuck in some "queued for upload" state 😭.
  • --printf=FORMAT — prints results (on stdout) in a given format (for each non-dead link). Default format string is "%F%u%n". The interpreted sequences are:
    • %% — raw % character
    • %f — filename (can be empty string if module list function does not report any name)
    • %F — empty if %f is empty, or alias to "# %f%n"
    • %m — module name
    • %n — newline
    • %t — tabulation character
    • %u — download url
    • %U — same as %u but url is escaped for JSON usage

🌈 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. shhh 🤫

🍓 Miscellaneous options

  • --no-color — disables log messages (stderr only) output coloring. no aesthetic, just vibes 💀
  • --fallback — if no module is found for link, get page (HTTP GET) and simply grep all URLs contained inside. chaotic but it works 💅
  • --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 main help and exit.
  • -H, --longhelp — display complete help (with module options) and exit. the deluxe version 💖
  • --version — output version information and exit.

🦋 MODULE OPTIONS 🦋

🌸 Common options

  • -p, --link-password=PASSWORD — used for password-protected folders. not everything is for everybody 🔒
All switches are not implemented nor required for all modules. See help message for detailed modules option list. (so like, don't come for the modules that didn't sign up for every feature, ok? 🙈)

⭐ 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).

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

💖 ENVIRONMENT VARIABLES 💖

The following environment variables may affect plowlist:

  • 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:

  • 0 — Success. Folder contain one or several files. slay 🎉
  • 1 — Fatal error. Upstream site updated or unexpected result.
  • 2 — No available module (provided URL is not supported).
  • 3 — Network error. Mostly curl related.
  • 5 — Timeout reached (refer to -t/--timeout command-line option).
  • 10 — Links are temporarily unavailable. This is used by mirroring/multi-upload services, maybe uploads are still being processed. give it a sec bestie ⏳
  • 11 — Folder is password protected.
  • 13 — Folder has been deleted or does not exist or is empty. rip 💀
  • 15 — Unknown command line parameter or incompatible options.
If plowlist is invoked with multiple links and one or several errors occur, the first error code is returned added with 100. lowkey math but make it drama 🔥

🫶 AUTHORS 🫶

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-2016 The Plowshare Team 👑

👀 SEE ALSO 👀

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

and that's the whole page, bestie!! 💞 this one shipped under GPL, dated July 13, 2016, and it's the plowlist(1) girlie from the Plowshare for Bash 4 lineup. now go list some links, you absolute icon 🎀✨

📦 where this page comes from