1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
% WIKIGET(1) Version 0.5.1 | Wikiget User Manual
% Cody Logan <clpo13@gmail.com>
% October 2, 2023
# NAME
wikiget - download files from MediaWiki sites
# SYNOPSIS
**wikiget**
[\-**h**] [\-**V**] [\-**q**|\-**v**] [\-**f**] [\-**s** *SITE*] [\-**p** *PATH*]
[\-\-**username** *USERNAME*] [\-\-**password** *PASSWORD*]
[\-**o** *OUTPUT* | \-**a**] [\-**l** *LOGFILE*]
*FILE*
# DESCRIPTION
Something like **wget**(1) for downloading a file from MediaWiki sites (like Wikipedia or Wikimedia Commons)
using only the file name or the URL of its description page.
# OPTIONS
*FILE*
: The file to be downloaded. If *FILE* is in the form *File:Example.jpg* or *Image:Example.jpg*, it will be
fetched from the default site, which is "commons.wikimedia.org". If it's the fully-qualified URL of a file
description page, like *https://en.wikipedia.org/wiki/File:Example.jpg*, the file is fetched from the site
in the URL, in this case "en.wikipedia.org".
\-**s**, \-\-**site** *SITE*
: MediaWiki site to download from. Will not have any effect if the full URL is given in the *FILE* parameter.
\-**p**, \-\-**path** *PATH*
: Script path for the wiki, where "index.php" and "api.php" live. On Wikimedia sites, it's "/w/", the default,
but other sites may use "/" or something else entirely.
\-\-**username** *USERNAME*
: Username for private wikis that require a login even for read access.
\-\-**password** *PASSWORD*
: Password for private wikis that require a login even for read access.
\-**o**, \-\-**output** *OUTPUT*
: By default, the output filename is the same as the remote filename (without the File: or Image: prefix),
but this can be changed with this option.
\-**l**, \-\-**logfile** *LOGFILE*
: Specify a logfile, which will contain detailed information about the download process. If the logfile already
exists, new log information is appended to it.
\-**f**, \-\-**force**
: Force overwritng of existing files.
\-**a**, \-\-**batch**
: If this flag is set, *FILE* will be treated as an input text file containing multiple files to be downloaded,
one filename or URL per line. If an error is encountered during download, execution stops immediately and the
offending filename is printed.
\-**v**, \-\-**verbose**
: Print additional information, such as the site used and the full URL of the file. Additional invocations will
increase the level of detail.
\-**q**, \-\-**quiet**
: Silence warnings and minimize printed output.
\-**h**, \-\-**help**
: Print a brief summary of these options.
# EXAMPLES
```
wikiget File:Example.jpg
wikiget --site en.wikipedia.org File:Example.jpg
wikiget https://en.wikipedia.org/wiki/File:Example.jpg -o test.jpg
```
# BUG REPORTS
<https://github.com/clpo13/wikiget/issues>
# LICENSE
Copyright (C) 2018-2023 Cody Logan and contributors
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
