~/.config/plowshare/plowshare.conf
This is the per-user configuration file.
plowlist1
List links from shared folders websites
Usage
plowlist [OPTIONS] ...
[MODULE_OPTIONS] ...
URL ...
Overview
plowlist is a command-line tool designed for listing links (files) on file-sharing websites. Provided links can be downloaded with plowdown(1).
Options
Common options
-
-i, --interface=IFACE -
If your machine has several network interfaces, force using IFACE interface.
-
-R, --recursive -
Recurse into sub folders.
-
-t, --timeout=SECS -
This is useful for mirroring/multi-upload services. Remote links may not be available or partially, in this case, module exit status is
10(temporary unavailable error). plowlist will wait exponentially until SECS (seconds) is reached. When unspecified, this option is zero (no wait, same legacy behavior) and applies for one single URL listing. Note: Don't give a too big value here (I'll advise few minutes), some hosters may be stuck in some "queued for upload" state.
-
--printf=FORMAT -
Print results (on stdout) in a given format (for each non-dead link). Default format string is "%F%u%n". Interpreted sequences are:
- %%
-
raw % character
- %f
-
filename (can be empty string if module list function does not report any name)
- %F
-
empty if
%fis empty, or alias to "# %f%n".
- %m
-
module name
- %n
-
newline
- %t
-
tabulation character
- %u
-
download url
- %U
-
same as
%ubut url is escaped for JSON usage
Logging options
-
-v, --verbose=LEVEL -
Set output verbosity level:
0none,1errors,2notice (default behavior),3debug,4report (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.
-
--fallback -
If no module is found for link, get page (HTTP GET) and simply grep all URLs contained inside.
-
--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-curlrcis 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.
Options
Common options
-
-p, --link-password=PASSWORD -
Used for password-protected folders.
All switches are not implemented nor required for all modules. See help message for detailed modules option list.
Files
-
/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
The following environment variables may affect plowlist:
-
HOME -
Search for user configuration directory in
~/.config/plowshare(see FILES section above). If found,~/.curlrcwill be used (use--no-curlrcto disable it).
-
PLOWSHARE_CURL -
Specifies an alternate curl command ($PATH search is considered). If not defined,
curlis used.
-
XDG_CONFIG_HOME -
The directory to store user configuration files. If not defined,
~/.configis assumed.
Exit status
Possible exit codes are:
-
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.
-
5 -
Timeout reached (refer to
-t/--timeoutcommand-line option).
-
10 -
Links are temporarily unavailable. This is used by mirroring/multi-upload services, maybe uploads are still being processed.
-
11 -
Folder is password protected.
-
13 -
Folder has been deleted or does not exist or is empty.
-
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.
Releases
4 releases since Debian 8 (Jessie); the text changed 2 times.
--curlrc since Debian 9 (Stretch);
--no-color since Debian 9 (Stretch);
--no-curlrc since Debian 9 (Stretch);
--timeout since Debian 9 (Stretch);
-t since Debian 9 (Stretch).