plowlist(1)

1
2plowlist(1)                  Plowshare for Bash 4                  plowlist(1)
3
4
5

NAME

7       plowlist - List links from shared folders websites
8
9

SYNOPSIS

11       plowlist [OPTIONS]...  [MODULE_OPTIONS]...  URL...
12
13

DESCRIPTION

15       plowlist  is  a command-line tool designed for listing links (files) on
16       file-sharing websites.  Provided links can  be  downloaded  with  plow‐
17       down(1).
18
19       Currently supported hosting sites list is available in README file.
20
21

OPTIONS

23   Common options
24       -i, --interface=IFACE
25              If  your  machine  has  several  network interfaces, force using
26              IFACE interface.
27
28       -R, --recursive
29              Recurse into sub folders.
30
31           --printf=FORMAT
32              Print results (on stdout) in a given format (for  each  non-dead
33              link).  Default format string is "%F%u%n". Interpreted sequences
34              are:
35
36              %%     raw % character
37
38              %f     filename (can be empty string  if  module  list  function
39                     does not report any name)
40
41              %F     empty if %f is empty, or alias to "# %f%n".
42
43              %m     module name
44
45              %n     newline
46
47              %t     tabulation character
48
49              %u     download url
50
51              %U     same as %u but url is escaped for JSON usage
52
53   Logging options
54       -v, --verbose=LEVEL
55              Set output verbosity level:
56              0  none,
57              1  errors,
58              2  notice (default behavior),
59              3  debug,
60              4  report (very noisy, log HTML pages).
61
62       -q, --quiet
63              Alias for -v0. Do not print any debug messages.
64
65   Miscellaneous options
66           --no-color
67              Disables log messages (stderr only) output coloring.
68
69           --fallback
70              If  no  module is found for link, get page (HTTP GET) and simply
71              grep all URLs contained inside.
72
73           --no-curlrc
74              Do not use curl config file (~/.curlrc).
75
76           --curlrc=FILE
77              Force using  an  alternate  curl  configuration  file.  Replaces
78              ~/.curlrc  if  it  exists.   This  option  has  no  effect  when
79              --no-curlrc is defined.
80
81           --no-plowsharerc
82              Do not consider any configuration file.
83
84           --plowsharerc=FILE
85              Force using an alternate configuration file (instead of per-user
86              or  systemwide  plowshare.conf).  This option has no effect when
87              --no-plowsharerc is defined.
88
89           --modules
90              Display all supported module names (one per line) and exit. Use‐
91              ful for wrappers.
92
93   Generic program information
94       -h, --help
95              Display main help and exit.
96
97       -H, --longhelp
98              Display complete help (with module options) and exit.
99
100           --version
101              Output version information and exit.
102
103

MODULE OPTIONS

105   Common options
106       -p, --link-password=PASSWORD
107              Used for password-protected folders.
108
109       All  switches  are  not  implemented nor required for all modules.  See
110       help message for detailed modules option list.
111
112

EXAMPLES

114   1) List links providing shared folder URL(s)
115       $ plowlist http://rapidgator.net/folder/1689302/Test.html
116
117       # First URL is processed, then the second one (this is not parallel)
118       $ plowlist http://www.mediafire.com/?qouncpzfe74s9 \
119           http://www.sendspace.com/folder/5njdw7
120
121   2) Custom results format
122       # List to give to plowdown (only links, no filenames)
123       $ plowlist --printf '%u%n' http://www.sendspace.com/folder/5njdw7 >mylist.txt
124
125       # vBulletin "BB" syntax
126       $ plowlist --printf '[url=%u]%f[/url]%n' \
127           http://www.sendspace.com/folder/5njdw7 >mylist.txt
128
129

FILES

131       ~/.config/plowshare/plowshare.conf
132              This is the per-user configuration file.
133
134       /etc/plowshare.conf
135              Systemwide configuration file.
136
137       The file format is described in plowshare.conf(5).
138
139       ~/.config/plowshare/modules/
140              User directory considered when searching for modules at  startup
141              (plowlist  will try to open ~/.config/plowshare/modules/config).
142              One file per module (hoster).
143
144

EXIT CODES

146       Possible exit codes are:
147
148       0      Success. Folder contain one or several files.
149
150       1      Fatal error. Upstream site updated or unexpected result.
151
152       2      No available module (provided URL is not supported).
153
154       3      Network error. Mostly curl related.
155
156       10     Links are temporarily  unavailable.  This  is  used  by  mirror‐
157              ing/multi-upload  services,  maybe uploads are still beeing pro‐
158              cessed.
159
160       11     Folder is password protected.
161
162       13     Folder has been deleted or does not exist or is empty.
163
164       15     Unknown command line parameter or incompatible options.
165
166       If plowlist is invoked with multiple links and one  or  several  errors
167       occur, the first error code is returned added with 100.
168
169

AUTHORS

171       Plowshare  was initially written by Arnau Sanchez. See the AUTHORS file
172       for a list of some of the many other contributors.
173
174       Plowshare is (C) 2010-2015 The Plowshare Team
175