1LGOGDOWNLOADER(1) User Commands LGOGDOWNLOADER(1)
2
6 LGOGDownloader - manual page for LGOGDownloader 3.7
7
9 lgogdownloader [OPTION]...
10
12 An open-source GOG.com downloader for Linux users which uses the same
13 API as GOG Galaxy.
14 LGOGDownloader can download purchased games, query GOG.com to see if
16 game files have changed, as well as downloading extras such as artwork
17 and manuals. It is capable of downloading language-specific installers
18 for games where they exist.
19 LGOGDownloader 3.7 Options:
21 -h [ --help ]
23 Print help message
24 --version
26 Print version information
27 --login
29 Login
30 --list List games
32 --list-details
34 List games with detailed info
35 --download
37 Download
38 --repair
40 Repair downloaded files Use --repair --download to redownload
41 files when filesizes don't match (possibly different version).
42 Redownload will rename the old file (appends .old to filename)
43 --game arg
45 Set regular expression filter for download/list/repair (Perl
46 syntax)
47 --create-xml [=arg(=automatic)]
49 Create GOG XML for file "automatic" to enable automatic XML cre‐
50 ation
51 --notifications
53 Check notifications
54 --updated
56 List/download only games with update flag set
57 --clear-update-flags
59 Clear update notification flags
60 --check-orphans arg
62 Check for orphaned files (files found on local filesystem that
63 are not found on GOG servers). Sets regular expression filter
64 (Perl syntax) for files to check. If no argument is given then
65 the regex defaults to '.*\.(zip|exe|bin|dmg|old|deb|tar\.gz|p
66 kg|sh)$'
67 --status
69 Show status of files
70 Output format:
72 statuscode gamename filename filesize filehash
73 Status codes:
75 OK - File is OK ND - File is not downloaded MD5 - MD5 mismatch,
76 different version FS - File size mismatch, incomplete download
77 --save-config
79 Create config file with current
80 settings
81 --reset-config
83 Reset config settings to default
84 --report [=arg(=lgogdownloader-report.log)]
86 Save report of downloaded/repaired
87 files to specified file
88 Default filename: lgogdownloader-report
89 .log
90 --update-cache
92 Update game details cache
93 --no-platform-detection
95 Don't try to detect supported platforms
96 from game shelf.
97 Skips the initial fast platform
98 detection and detects the supported
99 platforms from game details which is
100 slower but more accurate.
101 Useful in case platform identifier is
102 missing for some games in the game
103 shelf.
104 Using --platform with --list doesn't
105 work with this option.
106 --download-file arg
108 Download files using fileid
109 Format:
111 "gamename/fileid"
112 or: "gogdownloader://gamename/fileid"
113 Multiple files:
115 "gamename1/fileid1,gamename2/fileid2"
116 or: "gogdownloader://gamename1/fileid1,
117 gamename2/fileid2"
118 This option ignores all subdir options.
120 The files are downloaded to directory
121 specified with --directory option.
122 -o [ --output-file ] arg
124 Set filename of file downloaded with
125 --download-file.
126 --wishlist
128 Show wishlist
129 --cacert arg
131 Path to CA certificate bundle in PEM
132 format
133 --respect-umask
135 Do not adjust permissions of sensitive
136 files
137 --user-agent arg (=LGOGDownloader/3.7 (Linux x86_64))
139 Set user agent
140 --enable-login-gui
142 Enable login GUI when encountering
143 reCAPTCHA on login form
144 --directory arg (=.)
146 Set download directory
147 --limit-rate arg (=0)
149 Limit download rate to value in kB
150 0 = unlimited
151 --xml-directory arg
153 Set directory for GOG XML files
154 --chunk-size arg (=10)
156 Chunk size (in MB) when creating XML
157 --platform arg (=w+l)
159 Select which installers are downloaded
160 Windows = w|win|windows
161 Mac = m|mac|osx
162 Linux = l|lin|linux
163 All = all
164 Set priority by separating values with
166 ","
167 Combine values by separating with "+"
168 Example: Linux if available otherwise
169 Windows and Mac: l,w+m
170 --language arg (=en)
172 Select which language installers are
173 downloaded
174 English = en|eng|english|en[_-]US
175 German = de|deu|ger|german|de[_-]DE
176 French = fr|fra|fre|french|fr[_-]FR
177 Polish = pl|pol|polish|pl[_-]PL
178 Russian = ru|rus|russian|ru[_-]RU
179 Chinese = cn|zh|zho|chi|chinese|zh[_-]C
180 N
181 Czech = cz|cs|ces|cze|czech|cs[_-]CZ
182 Spanish = es|spa|spanish|es[_-]ES
183 Hungarian = hu|hun|hungarian|hu[_-]HU
184 Italian = it|ita|italian|it[_-]IT
185 Japanese = jp|ja|jpn|japanese|ja[_-]JP
186 Turkish = tr|tur|turkish|tr[_-]TR
187 Portuguese = pt|por|portuguese|pt[_-]PT
188 Korean = ko|kor|korean|ko[_-]KR
189 Dutch = nl|nld|dut|dutch|nl[_-]NL
190 Swedish = sv|swe|swedish|sv[_-]SE
191 Norwegian = no|nor|norwegian|nb[_-]no|n
192 n[_-]NO
193 Danish = da|dan|danish|da[_-]DK
194 Finnish = fi|fin|finnish|fi[_-]FI
195 Brazilian Portuguese =
196 br|pt_br|pt-br|ptbr|brazilian_portugues
197 e
198 Slovak = sk|slk|slo|slovak|sk[_-]SK
199 Bulgarian = bl|bg|bul|bulgarian|bg[_-]B
200 G
201 Ukrainian = uk|ukr|ukrainian|uk[_-]UA
202 Spanish (Latin American) =
203 es_mx|es-mx|esmx|es-419|spanish_latin_a
204 merican
205 Arabic = ar|ara|arabic|ar[_-][A-Z]{2}
206 Romanian = ro|ron|rum|romanian|ro[_-][R
207 M]O
208 Hebrew = he|heb|hebrew|he[_-]IL
209 All = all
210 Set priority by separating values with
212 ","
213 Combine values by separating with "+"
214 Example: German if available otherwise
215 English and French: de,en+fr
216 --no-remote-xml
218 Don't use remote XML for repair
219 --no-unicode
221 Don't use Unicode in the progress bar
222 --no-color
224 Don't use coloring in the progress bar
225 or status messages
226 --no-duplicate-handling
228 Don't use duplicate handler for
229 installers
230 Duplicate installers from different
231 languages are handled separately
232 --no-subdirectories
234 Don't create subdirectories for extras,
235 patches and language packs
236 --verbose
238 Print lots of information
239 --curl-verbose
241 Set libcurl to verbose mode
242 --insecure
244 Don't verify authenticity of SSL
245 certificates
246 --timeout arg (=10)
248 Set timeout for connection
249 Maximum time in seconds that connection
250 phase is allowed to take
251 --retries arg (=3)
253 Set maximum number of retries on failed
254 download
255 --wait arg (=0)
257 Time to wait between requests
258 (milliseconds)
259 --subdir-installers arg
261 Set subdirectory for installers
262 Templates:
263 - %platform%
264 - %gamename%
265 - %dlcname%
266 --subdir-extras arg (=extras)
268 Set subdirectory for extras
269 Templates:
270 - %platform%
271 - %gamename%
272 - %dlcname%
273 --subdir-patches arg (=patches)
275 Set subdirectory for patches
276 Templates:
277 - %platform%
278 - %gamename%
279 - %dlcname%
280 --subdir-language-packs arg (=languagepacks)
282 Set subdirectory for language packs
283 Templates:
284 - %platform%
285 - %gamename%
286 - %dlcname%
287 --subdir-dlc arg (=dlc/%dlcname%)
289 Set subdirectory for dlc
290 Templates:
291 - %platform%
292 - %gamename%
293 - %dlcname%
294 --subdir-game arg (=%gamename%)
296 Set subdirectory for game
297 Templates:
298 - %platform%
299 - %gamename%
300 - %dlcname%
301 --use-cache
303 Use game details cache
304 --cache-valid arg (=2880)
306 Set how long cached game details are
307 valid (in minutes)
308 Default: 2880 minutes (48 hours)
309 --save-serials
311 Save serial numbers when downloading
312 --ignore-dlc-count [=arg(=.*)]
314 Set regular expression filter for games
315 to ignore DLC count information
316 Ignoring DLC count information helps in
317 situations where the account page
318 doesn't provide accurate information
319 about DLCs
320 --include arg (=all)
322 Select what to download/list/repair
323 Installers = i|installers
324 Extras = e|extras
325 Patches = p|patches
326 Language packs = l|languagepacks|langpa
327 cks
328 DLCs = d|dlc|dlcs
329 Separate with "," to use multiple
330 values
331 --exclude arg
333 Select what not to download/list/repair
334 Installers = i|installers
335 Extras = e|extras
336 Patches = p|patches
337 Language packs = l|languagepacks|langpa
338 cks
339 DLCs = d|dlc|dlcs
340 Separate with "," to use multiple
341 values
342 --automatic-xml-creation
344 Automatically create XML data after
345 download has completed
346 --save-changelogs
348 Save changelogs when downloading
349 --threads arg (=4)
351 Number of download threads
352 --info-threads arg (=4)
354 Number of threads for getting product
355 info
356 --dlc-list arg (=https://raw.githubusercontent.com/Sude-/lgogdownloader-lists/master/game_has_dlc.txt)
358 Set URL for list of games that have DLC
359 --progress-interval arg (=100)
361 Set interval for progress bar update
362 (milliseconds)
363 Value must be between 1 and 10000
364 --lowspeed-timeout arg (=30)
366 Set time in number seconds that the
367 transfer speed should be below the rate
368 set with --lowspeed-rate for it to
369 considered too slow and aborted
370 --lowspeed-rate arg (=200)
372 Set average transfer speed in bytes per
373 second that the transfer should be
374 below during time specified with
375 --lowspeed-timeout for it to be
376 considered too slow and aborted
377 --include-hidden-products
379 Include games that have been set hidden
380 in account page
381 Experimental:
383 --galaxy-install arg
384 Install game using product id [product_id/build_index] or game‐
385 name regex [gamename/build_id] Build index is used to select a
386 build and defaults to 0 if not specified.
387 Example: 12345/2 selects build 2 for
389 product 12345
390 --galaxy-show-builds arg
392 Show game builds using product id [product_id/build_index] or
393 gamename regex [gamename/build_id] Build index is used to select
394 a build and defaults to 0 if not specified.
395 Example: 12345/2 selects build 2 for
397 product 12345
398 --galaxy-platform arg (=w)
400 Select platform Windows = w|win|windows Mac = m|mac|osx Linux =
401 l|lin|linux
402 --galaxy-language arg (=en)
404 Select language English = en|eng|english|en[_-]US German =
405 de|deu|ger|german|de[_-]DE French = fr|fra|fre|french|fr[_-]FR
406 Polish = pl|pol|polish|pl[_-]PL Russian = ru|rus|rus‐
407 sian|ru[_-]RU Chinese = cn|zh|zho|chi|chinese|zh[_-]C N Czech =
408 cz|cs|ces|cze|czech|cs[_-]CZ Spanish = es|spa|spanish|es[_-]ES
409 Hungarian = hu|hun|hungarian|hu[_-]HU Italian = it|ita|ital‐
410 ian|it[_-]IT Japanese = jp|ja|jpn|japanese|ja[_-]JP Turkish =
411 tr|tur|turkish|tr[_-]TR Portuguese = pt|por|portuguese|pt[_-]PT
412 Korean = ko|kor|korean|ko[_-]KR Dutch =
413 nl|nld|dut|dutch|nl[_-]NL Swedish = sv|swe|swedish|sv[_-]SE Nor‐
414 wegian = no|nor|norwegian|nb[_-]no|n n[_-]NO Danish =
415 da|dan|danish|da[_-]DK Finnish = fi|fin|finnish|fi[_-]FI Brazil‐
416 ian Portuguese = br|pt_br|pt-br|ptbr|brazilian_portugues e Slo‐
417 vak = sk|slk|slo|slovak|sk[_-]SK Bulgarian = bl|bg|bul|bulgar‐
418 ian|bg[_-]B G Ukrainian = uk|ukr|ukrainian|uk[_-]UA Spanish
419 (Latin American) = es_mx|es-mx|esmx|es-419|spanish_latin_a meri‐
420 can Arabic = ar|ara|arabic|ar[_-][A-Z]{2} Romanian =
421 ro|ron|rum|romanian|ro[_-][R M]O Hebrew = he|heb|hebrew|he[_-]IL
422 --galaxy-arch arg (=x64)
424 Select architecture 32-bit = 32|x86|32bit|32-bit 64-bit =
425 64|x64|64bit|64-bit
426 --galaxy-no-dependencies
428 Don't download dependencies during --galaxy-install
429 --subdir-galaxy-install arg (=%install_dir%)
431 Set subdirectory for galaxy install
432 Templates:
434 - %install_dir% = Installation directory from Galaxy API re‐
435 sponse - %gamename% = Game name - %title% = Title of the game -
436 %product_id% = Product id of the game - %install_dir_stripped% =
437 %install_dir% with some characters stripped - %title_stripped% =
438 %title% with some characters stripped
439 "stripped" means that every character
441 that doesn't match the following list is removed: > alphanumeric
442 > space > - _ . ( ) [ ] { }
443 --galaxy-cdn-priority arg (=edgecast,highwinds,gog_cdn)
445 Set priority for used CDNs Edgecast = ec|edgecast Highwinds =
446 hw|highwinds|high_winds GOG = gog|gog_cdn
447 Set priority by separating values with
449 "," Combine values by separating with "+"
450 --galaxy-delete-orphans
452 Delete orphaned files during --galaxy-install
453
455 Allows user to specify individual files that should not be downloaded
456 or mentioned as orphans.
457 Each line in the file specifies one blacklist expression, except for
459 empty lines and lines starting with #. First few characters specify
460 blacklist item type and flags. So far, only regular expression (perl
461 variant) are supported, so each line must start with "Rp" characters.
462 After a space comes the expression itself. Expressions are matched
463 against file path relative to what was specified as --directory.
464 Example black list
466 # used to store manually downloaded mods/patches/maps/, don't mention
467 it as orphans
468 Rp ^[^/]*/manual/.*
469 # included with every *divinity game, once is enough
470 Rp beyond_divinity/extras/bd_ladymageknight.zip
471 Rp divinity_2_developers_cut/extras/divinity_2_ladymageknight.zip
472 # extra 6GB is A LOT of space if you don't actually plan to mod your
474 game
475 Rp the_witcher_2/extras/the_witcher_2_redkit.zip
476 Rp the_witcher_2/extras/extras_pack_3_hu_pl_ru_tr_zh_.zip
477 Rp the_witcher_2/extras/extras_pack_2_fr_it_jp_.zip
478
480 Separating values with "," when using language and platform switches
481 enables a priority-based mode: only the first matching one will be
482 downloaded.
483 For example, setting language to fr+en means both French and English
485 will be downloaded (if available) for all games. Setting language to
486 fr,en means that the French version (and only that one) will be down‐
487 loaded if available, and if not, the English version will be down‐
488 loaded.
489 You're allowed to "stack" codes in the priority string if needed. If
491 you set language to es+fr,en it means it'll download both Spanish (es)
492 and French (fr) versions if they are available, and the English (en)
493 one only if none of French and Spanish are available.
494
496 The latest version of this distribution is available from
497 https://github.com/Sude-/lgogdownloader
498
500 $XDG_CONFIG_HOME/lgogdownloader/
501 Storage for configuration files and cookies
502 If $XDG_CONFIG_HOME is not set, it will use $HOME/.config/lgog‐
503 downloader/.
504 $XDG_CACHE_HOME/lgogdownloader/xml/
507 Storage for XML files
508 If $XDG_CACHE_HOME is not set, it will use $HOME/.cache/lgog‐
509 downloader/xml/.
510 $XDG_CONFIG_HOME/lgogdownloader/blacklist.txt
513 Allows user to specify individual files that should not be down‐
514 loaded.
515 It doesn't have to exist, but if it does exist, it must be read‐
516 able to lgogdownloader.
517 $XDG_CONFIG_HOME/lgogdownloader/ignorelist.txt
520 Allows user to specify individual files that should not be men‐
521 tioned as orphans. The file has the same format and interpreta‐
522 tion as a blacklist.
523 It doesn't have to exist, but if it does exist, it must be read‐
524 able to lgogdownloader.
525 $XDG_CONFIG_HOME/lgogdownloader/game_has_dlc.txt
528 Allows user to specify which games have dlc and should have
529 their DLC count information ignored. The file has the same for‐
530 mat and interpretation as a blacklist.
531 It doesn't have to exist, but if it does exist, it must be read‐
532 able to lgogdownloader.
533 If the file exists lgogdownloader uses it instead of list speci‐
534 fied with --dlc-list option
535 $XDG_CONFIG_HOME/lgogdownloader/gamespecific/gamename.conf
538 JSON formatted file. Sets game specific settings for gamename.
539 Allowed settings are language, platform, dlc, ignore-dlc-count
540 subdirectories, directory, subdir-game, subdir-installers, sub‐
541 dir-extras, subdir-patches, subdir-language-packs and subdir-
542 dlc.
543 The dlc option is limited to disabling DLC for specific game. It
544 can't enable DLC listing/downloading if --no-dlc option is used.
545 Must be in the following format:
546 {
547 "language" : <string>,
548 "platform" : <string>,
549 "dlc" : <bool>,
550 "ignore-dlc-count" : <bool>,
551 "subdirectories" : <bool>,
552 "directory" : <string>,
553 "subdir-game" : <string>,
554 "subdir-installers" : <string>,
555 "subdir-extras" : <string>,
556 "subdir-patches" : <string>,
557 "subdir-language-packs" : <string>,
558 "subdir-dlc" : <string>
559 }
560LGOGDownloader 3.7 January 2021 LGOGDOWNLOADER(1)