NAME

       plowdel - Delete files from file sharing websites links

SYNOPSIS

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

DESCRIPTION

       plowdel  is a command-line tool designed for deleting files on file-sharing websites.  It acts like a web
       browser, retrieving pages and filling HTML forms.

       Some sites may require authentication (login) for deleting files.  See  specific  module  options  below.
       Login process may sometimes require captcha solving.

OPTIONS

   Common options
       -i, --interface=IFACE
              If your machine has several network interfaces, force using IFACE interface.

   Captcha options
           --9kweu=KEY
              Use 9kw.eu service to solve captchas.

           --antigate=KEY
              Use Antigate.com service to solve captchas.

           --captchabhood=USER:PASSWORD
              Use Captcha Brotherhood service to solve captchas.

           --captchacoin=KEY
              Use CaptchaCoin service to solve captchas.

           --deathbycaptcha=USER:PASSWORD
              Use Death by Captcha service to solve captchas.

           --captchamethod=METHOD
              Force specific captcha solving method (if unspecified it is autodetected). Available values:
              imgur:  upload  image  to  Imgur.com  service,  print  image  url in console and prompt for manual
              entering. Useful for NAS and embedded devices.
              none: abort if captcha solving is requested (even if automatic solving service is available).
              online: use captcha solving website only  (9kweu,  Antigate,  CaptchaBrotherhood,  CaptchaCoin  or
              DeathByCaptcha account required).
              fb:  display  image  in  framebuffer console and prompt for manual entering. Looks for framebuffer
              viewers: fbi, fim.  FRAMEBUFFER environment variable can contain device file. Default is /dev/fb0.
              nox: display image in console (text) and prompt for manual  entering.  Looks  for  ascii  viewers:
              img2txt, aview, tiv.
              x11:  display  image  in an X11 window and prompt for manual entering. Looks for viewers: display,
              feh, sxiv, qiv.  DISPLAY environment variable must not be empty.

           --captchaprogram=PROGRAM
              Call external program or script for solving captchas. Provided executable can be located  in  PATH
              environment variable.

              Three arguments are given:
              $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.

              Return value (on stdout) and 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 (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:
              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
           --no-color
              Disables log messages (stderr only) output coloring.

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

           --version
              Output version information and exit.

MODULE OPTIONS

   Common options
       -a, --auth=USER:PASSWORD
              Use premium account. Free account can be used sometimes.

       All  switches  are  not  implemented  nor required for all modules. See help message for detailed modules
       option list.

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/exec/
              Additional directory considered when searching for executable. See --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.

       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.

       1      Fatal error. Upstream site updated or unexpected result.

       2      No available module (provided URL is not supported).

       3      Network error. Mostly curl related.

       4      Authentication failed (bad login/password).

       11     Link requires an admin or removal code.

       12     Authentication required (anonymous users can't delete files).

       13     Link is dead. File has been previously deleted.

       15     Unknown command line parameter or incompatible options.

       If  plowdel  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.

       Plowshare is (C) 2010-2016 The Plowshare Team

SEE ALSO

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

GPL                                               July 13, 2016                                       plowdel(1)