plowdel(1)

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

💅 plowdel — the girlies' guide to yeeting files off the internet

okay so bestie, welcome to plowdel(1) — that's the manual page for plowdel, part of the Plowshare for Bash 4 collection. yes we are doing manpages now. sit down, hydrate, and let's get into it 🫶

✨ NAME ✨

plowdel — delete files from file sharing websites links. that's it. that's the job. she deletes. 💅

🦋 SYNOPSIS 🦋

plowdel [OPTIONS]...  [MODULE_OPTIONS]...  URL...

literally just hand her some OPTIONS, some MODULE_OPTIONS, and one or more URLs and she'll go handle it. slay.

🌸 DESCRIPTION 🌸

so plowdel is a command-line tool made for deleting files on file-sharing websites. the way she works is honestly kind of iconic: she acts like a web browser — retrieving pages and filling in HTML forms. no cap, she's out here doing full browser cosplay just to press the delete button. 💀

heads up though: some sites may require authentication (that's login, bestie) for deleting files. check the specific module options down below for the tea. and ngl, the login process may sometimes require captcha solving — yeah, one of those. 🙈

👑 OPTIONS 👑

Common options

  • -i, --interface=IFACE — if your machine has several network interfaces and you want to force a specific one, this is your girl. just pass in IFACE and she'll use that interface. periodt.

Captcha options

  • --9kweu=KEY — use the 9kw.eu service to solve captchas. drop your KEY in and let them handle it. ✨
  • --antigate=KEY — use Antigate.com service to solve captchas. KEY goes in, captchas come out. 💫
  • --captchabhood=USER:PASSWORD — use Captcha Brotherhood service to solve captchas. yes you really do give it USER:PASSWORD. she trusts you.
  • --captchacoin=KEY — use CaptchaCoin service to solve captchas. KEY time. 🔑
  • --deathbycaptcha=USER:PASSWORD — use Death by Captcha service to solve captchas. dramatic name, very on brand honestly. give it USER:PASSWORD.
  • --captchamethod=METHOD — force a specific captcha solving method. if you don't specify one, it gets autodetected (she's smart like that). available values are:
    • imgur — upload image to Imgur.com service, print image url in console and prompt for manual entering. useful for NAS and embedded devices. (lowkey the most chaotic option and i respect it.)
    • none — abort if captcha solving is requested, even if an automatic solving service is available. she said no. 💀
    • online — use captcha solving website only. requires an account with one of: 9kweu, Antigate, CaptchaBrotherhood, CaptchaCoin or DeathByCaptcha. pick your fighter.
    • fb — display image in framebuffer console and prompt for manual entering. looks for framebuffer viewers: fbi, fim. the FRAMEBUFFER environment variable can contain the device file. default is /dev/fb0.
    • nox — display image in console (text) and prompt for manual entering. looks for ascii viewers: img2txt, aview, tiv. very retro, very cute.
    • x11 — display image in an X11 window and prompt for manual entering. looks for viewers: display, feh, sxiv, qiv. the DISPLAY environment variable must not be empty, bestie, or this whole vibe falls apart.
  • --captchaprogram=PROGRAM — call an external program or script for solving captchas. the provided executable can be located in the PATH environment variable. outsourcing! we love a delegation moment. 🎀

three arguments get given to it:

  • $1 module name (lowercase). for example: mediafire.
  • $2 image filename (with full path).
  • $3 hint or captcha type (string). for example: recaptcha, solvemedia or digits-4.

and then the return value (on stdout) plus exit status:

  • 0: solving success. Captcha Word(s) must be echo'ed.
  • 2: external solver is not able to solve requested captcha. let plowdel continue solving it normally (she will consider --captchamethod if specified).
  • 7: external solver failed.
note: plowdel legacy exit errors can also be returned, for example: 1 (fatal) or 3 (network).

Logging options

  • -v, --verbose=LEVEL — set output verbosity level. the levels are:
    • 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. 🤫

Miscellaneous options

  • --no-color — disables log messages (stderr only) output coloring. monochrome era.
  • --no-curlrc — do not use curl config file (~/.curlrc). leave that file unbothered.
  • --curlrc=FILE — force using an alternate curl configuration file. replaces ~/.curlrc if it exists. this option has no effect when --no-curlrc is defined. (they don't get along, it's giving exes.)
  • --no-plowsharerc — do not consider any configuration file. she's going in with zero context and full confidence.
  • --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. same energy as above.
  • --modules — display all supported module names (one per line) and exit. useful for wrappers. she's just showing you the roster. ⭐

Generic program information

  • -h, --help — display main help and exit.
  • -H, --longhelp — display complete help (with module options) and exit. the extended cut. 🔥
  • --version — output version information and exit.

🌈 MODULE OPTIONS 🌈

Common options

  • -a, --auth=USER:PASSWORD — use premium account. a free account can be used sometimes. (sometimes!! no promises, bestie.)
all switches are not implemented nor required for all modules. see the help message for the detailed modules option list. iykyk.

📁 FILES 📁

  • ~/.config/plowshare/plowshare.conf — this is the per-user configuration file. your personal little home. 🏠
  • /etc/plowshare.conf — systemwide configuration file. the communal one.
  • the file format is described in plowshare.conf(5).
  • ~/.config/plowshare/exec/ — additional directory considered when searching for executable. see the --captchaprogram switch.
  • ~/.config/plowshare/modules.d/ — user directory considered when searching for modules at startup (plowdel will try to open ~/.config/plowshare/modules.d/*/config). one file per module (hoster).

🧚 ENVIRONMENT VARIABLES 🧚

the following environment variables may affect plowdel:

  • DISPLAY — the X11 display server address is considered to display captchas. see --captchamethod=x11 documentation below. (okay technically it's above, but we move.)
  • FRAMEBUFFER — this variable is considered to display captchas. see --captchamethod=fb documentation below.
  • 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. File was successfully deleted. we love a happy ending. 🥳
  • 1 — Fatal error. Upstream site updated or unexpected result. (they changed the website on us, rude.)
  • 2 — No available module (provided URL is not supported). she does not know her.
  • 3 — Network error. Mostly curl related.
  • 4 — Authentication failed (bad login/password). bestie. your password.
  • 11 — Link requires an admin or removal code. it's giving restricted. 🚫
  • 12 — Authentication required (anonymous users can't delete files). log in or log out, no in between.
  • 13 — Link is dead. File has been previously deleted. rip, she's already gone. ⚰️
  • 15 — Unknown command line parameter or incompatible options. you two are fighting.
if plowdel is invoked with multiple links and one or several errors occur, the first error code is returned added with 100. do the math, bestie.

💖 AUTHORS 💖

Plowshare was initially written by Arnau Sanchez. see the AUTHORS file for a list of some of the many other contributors. (so many icons, honestly.)

Plowshare is (C) 2010-2016 The Plowshare Team. 💜

🎀 SEE ALSO 🎀

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

and that's the whole page, bestie! 🫶 this one lives under the GPL and it's dated July 13, 2016 — from the Plowshare for Bash 4 era, and yes she still eats. go delete something. respectfully. ✨💅

📦 where this page comes from