1LGOGDOWNLOADER(1) User Commands LGOGDOWNLOADER(1)
2
6 LGOGDownloader - manual page for LGOGDownloader 3.11
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.11 Options:
21 -h [ --help ]
23 Print help message
24 --version
26 Print version information
27 --login
29 Login
30 --list [=arg(=games)]
32 List games/tags Games = g|games Details = d|details JSON =
33 j|json Tags = t|tags
34 --download
36 Download
37 --repair
39 Repair downloaded files Use --repair --download to redownload
40 files when filesizes don't match (possibly different version).
41 Redownload will rename the old file (appends .old to filename)
42 --game arg
44 Set regular expression filter for download/list/repair (Perl
45 syntax)
46 --create-xml [=arg(=automatic)]
48 Create GOG XML for file "automatic" to enable automatic XML cre‐
49 ation
50 --notifications
52 Check notifications
53 --updated
55 List/download only games with update flag set
56 --clear-update-flags
58 Clear update notification flags
59 --check-orphans arg
61 Check for orphaned files (files found on local filesystem that
62 are not found on GOG servers). Sets regular expression filter
63 (Perl syntax) for files to check. If no argument is given then
64 the regex defaults to '.*\.(zip|exe|bin|dmg|old|deb|tar\.gz|p
65 kg|sh)$'
66 --status
68 Show status of files
69 Output format:
71 statuscode gamename filename filesize filehash
72 Status codes:
74 OK - File is OK ND - File is not downloaded MD5 - MD5 mismatch,
75 different version FS - File size mismatch, incomplete download
76 --save-config
78 Create config file with current
79 settings
80 --reset-config
82 Reset config settings to default
83 --report [=arg(=lgogdownloader-report.log)]
85 Save report of downloaded/repaired
86 files to specified file
87 Default filename: lgogdownloader-report
88 .log
89 --update-cache
91 Update game details cache
92 --no-platform-detection
94 Don't try to detect supported platforms
95 from game shelf.
96 Skips the initial fast platform
97 detection and detects the supported
98 platforms from game details which is
99 slower but more accurate.
100 Useful in case platform identifier is
101 missing for some games in the game
102 shelf.
103 Using --platform with --list doesn't
104 work with this option.
105 --download-file arg
107 Download files using fileid
108 Format:
110 "gamename/fileid"
111 or: "gogdownloader://gamename/fileid"
112 Multiple files:
114 "gamename1/fileid1,gamename2/fileid2"
115 or: "gogdownloader://gamename1/fileid1,
116 gamename2/fileid2"
117 This option ignores all subdir options.
119 The files are downloaded to directory
120 specified with --directory option.
121 -o [ --output-file ] arg
123 Set filename of file downloaded with
124 --download-file.
125 --wishlist
127 Show wishlist
128 --cacert arg
130 Path to CA certificate bundle in PEM
131 format
132 --respect-umask
134 Do not adjust permissions of sensitive
135 files
136 --user-agent arg (=LGOGDownloader/3.11 (Linux x86_64))
138 Set user agent
139 --wine-prefix arg (=.)
141 Set wineprefix directory
142 --cloud-whitelist arg
144 Include this list of cloud saves, by
145 default all cloud saves are included
146 Example: --cloud-whitelist
148 saves/AutoSave-0 saves/AutoSave-1/scree
149 nshot.png
150 --cloud-blacklist arg
152 Exclude this list of cloud saves
153 Example: --cloud-blacklist
154 saves/AutoSave-0 saves/AutoSave-1/scree
156 nshot.png
157 --cloud-force
159 Download or Upload cloud saves even if
160 they're up-to-date
161 Delete remote cloud saves even if no
162 saves are whitelisted
163 --enable-login-gui
165 Enable login GUI when encountering
166 reCAPTCHA on login form
167 --tag arg
169 Filter using tags. Separate with "," to
170 use multiple values
171 --directory arg (=.)
173 Set download directory
174 --limit-rate arg (=0)
176 Limit download rate to value in kB
177 0 = unlimited
178 --xml-directory arg
180 Set directory for GOG XML files
181 --chunk-size arg (=10)
183 Chunk size (in MB) when creating XML
184 --platform arg (=w+l)
186 Select which installers are downloaded
187 Windows = w|win|windows
188 Mac = m|mac|osx
189 Linux = l|lin|linux
190 All = all
191 Set priority by separating values with
193 ","
194 Combine values by separating with "+"
195 Example: Linux if available otherwise
196 Windows and Mac: l,w+m
197 --language arg (=en)
199 Select which language installers are
200 downloaded
201 English = en|eng|english|en[_-]US
202 German = de|deu|ger|german|de[_-]DE
203 French = fr|fra|fre|french|fr[_-]FR
204 Polish = pl|pol|polish|pl[_-]PL
205 Russian = ru|rus|russian|ru[_-]RU
206 Chinese = cn|zh|zho|chi|chinese|zh[_-]C
207 N
208 Czech = cz|cs|ces|cze|czech|cs[_-]CZ
209 Spanish = es|spa|spanish|es[_-]ES
210 Hungarian = hu|hun|hungarian|hu[_-]HU
211 Italian = it|ita|italian|it[_-]IT
212 Japanese = jp|ja|jpn|japanese|ja[_-]JP
213 Turkish = tr|tur|turkish|tr[_-]TR
214 Portuguese = pt|por|portuguese|pt[_-]PT
215 Korean = ko|kor|korean|ko[_-]KR
216 Dutch = nl|nld|dut|dutch|nl[_-]NL
217 Swedish = sv|swe|swedish|sv[_-]SE
218 Norwegian = no|nor|norwegian|nb[_-]no|n
219 n[_-]NO
220 Danish = da|dan|danish|da[_-]DK
221 Finnish = fi|fin|finnish|fi[_-]FI
222 Brazilian Portuguese =
223 br|pt_br|pt-br|ptbr|brazilian_portugues
224 e
225 Slovak = sk|slk|slo|slovak|sk[_-]SK
226 Bulgarian = bl|bg|bul|bulgarian|bg[_-]B
227 G
228 Ukrainian = uk|ukr|ukrainian|uk[_-]UA
229 Spanish (Latin American) =
230 es_mx|es-mx|esmx|es-419|spanish_latin_a
231 merican
232 Arabic = ar|ara|arabic|ar[_-][A-Z]{2}
233 Romanian = ro|ron|rum|romanian|ro[_-][R
234 M]O
235 Hebrew = he|heb|hebrew|he[_-]IL
236 Thai = th|tha|thai|th[_-]TH
237 All = all
238 Set priority by separating values with
240 ","
241 Combine values by separating with "+"
242 Example: German if available otherwise
243 English and French: de,en+fr
244 --no-remote-xml
246 Don't use remote XML for repair
247 --no-unicode
249 Don't use Unicode in the progress bar
250 --no-color
252 Don't use coloring in the progress bar
253 or status messages
254 --no-duplicate-handling
256 Don't use duplicate handler for
257 installers
258 Duplicate installers from different
259 languages are handled separately
260 --no-subdirectories
262 Don't create subdirectories for extras,
263 patches and language packs
264 --curl-verbose
266 Set libcurl to verbose mode
267 --insecure
269 Don't verify authenticity of SSL
270 certificates
271 --timeout arg (=10)
273 Set timeout for connection
274 Maximum time in seconds that connection
275 phase is allowed to take
276 --retries arg (=3)
278 Set maximum number of retries on failed
279 download
280 --wait arg (=0)
282 Time to wait between requests
283 (milliseconds)
284 --subdir-installers arg
286 Set subdirectory for installers
287 Templates:
288 - %platform%
289 - %gamename%
290 - %gamename_firstletter%
291 - %dlcname%
292 --subdir-extras arg (=extras)
294 Set subdirectory for extras
295 Templates:
296 - %platform%
297 - %gamename%
298 - %gamename_firstletter%
299 - %dlcname%
300 --subdir-patches arg (=patches)
302 Set subdirectory for patches
303 Templates:
304 - %platform%
305 - %gamename%
306 - %gamename_firstletter%
307 - %dlcname%
308 --subdir-language-packs arg (=languagepacks)
310 Set subdirectory for language packs
311 Templates:
312 - %platform%
313 - %gamename%
314 - %gamename_firstletter%
315 - %dlcname%
316 --subdir-dlc arg (=dlc/%dlcname%)
318 Set subdirectory for dlc
319 Templates:
320 - %platform%
321 - %gamename%
322 - %gamename_firstletter%
323 - %dlcname%
324 --subdir-game arg (=%gamename%)
326 Set subdirectory for game
327 Templates:
328 - %platform%
329 - %gamename%
330 - %gamename_firstletter%
331 - %dlcname%
332 --use-cache
334 Use game details cache
335 --cache-valid arg (=2880)
337 Set how long cached game details are
338 valid (in minutes)
339 Default: 2880 minutes (48 hours)
340 --save-serials
342 Save serial numbers when downloading
343 --ignore-dlc-count [=arg(=.*)]
345 Set regular expression filter for games
346 to ignore DLC count information
347 Ignoring DLC count information helps in
348 situations where the account page
349 doesn't provide accurate information
350 about DLCs
351 --include arg (=all)
353 Select what to download/list/repair
354 Installers = i|installers
355 Extras = e|extras
356 Patches = p|patches
357 Language packs = l|languagepacks|langpa
358 cks
359 DLCs = d|dlc|dlcs
360 Separate with "," to use multiple
361 values
362 --exclude arg
364 Select what not to download/list/repair
365 Installers = i|installers
366 Extras = e|extras
367 Patches = p|patches
368 Language packs = l|languagepacks|langpa
369 cks
370 DLCs = d|dlc|dlcs
371 Separate with "," to use multiple
372 values
373 --automatic-xml-creation
375 Automatically create XML data after
376 download has completed
377 --save-changelogs
379 Save changelogs when downloading
380 --threads arg (=4)
382 Number of download threads
383 --info-threads arg (=4)
385 Number of threads for getting product
386 info
387 --use-dlc-list
389 Use DLC list specified with --dlc-list
390 --dlc-list arg (=https://raw.githubusercontent.com/Sude-/lgogdownloader-lists/master/game_has_dlc.txt)
392 Set URL for list of games that have DLC
393 --progress-interval arg (=100)
395 Set interval for progress bar update
396 (milliseconds)
397 Value must be between 1 and 10000
398 --lowspeed-timeout arg (=30)
400 Set time in number seconds that the
401 transfer speed should be below the rate
402 set with --lowspeed-rate for it to
403 considered too slow and aborted
404 --lowspeed-rate arg (=200)
406 Set average transfer speed in bytes per
407 second that the transfer should be
408 below during time specified with
409 --lowspeed-timeout for it to be
410 considered too slow and aborted
411 --include-hidden-products
413 Include games that have been set hidden
414 in account page
415 --size-only
417 Don't check the hashes of the files
418 whose size matches that on the server
419 --verbosity arg (=0)
421 Set message verbosity level
422 -1 = Less verbose
423 0 = Default
424 1 = Verbose
425 2 = Debug
426 Experimental:
428 --galaxy-install arg
429 Install game using product id [product_id/build_index] or game‐
430 name regex [gamename/build_id] Build index is used to select a
431 build and defaults to 0 if not specified.
432 Example: 12345/2 selects build 2 for
434 product 12345
435 --galaxy-show-builds arg
437 Show game builds using product id [product_id/build_index] or
438 gamename regex [gamename/build_id] Build index is used to select
439 a build and defaults to 0 if not specified.
440 Example: 12345/2 selects build 2 for
442 product 12345
443 --galaxy-download-cloud-saves arg
445 Download cloud saves using product-id [product_id/build_index]
446 or gamename regex [gamename/build_id] Build index is used to se‐
447 lect a build and defaults to 0 if not specified.
448 Example: 12345/2 selects build 2 for
450 product 12345
451 --galaxy-upload-cloud-saves arg
453 Upload cloud saves using product-id [product_id/build_index] or
454 gamename regex [gamename/build_id] Build index is used to select
455 a build and defaults to 0 if not specified.
456 Example: 12345/2 selects build 2 for
458 product 12345
459 --galaxy-show-cloud-saves arg
461 Show game cloud-saves using product id [product_id/build_index]
462 or gamename regex [gamename/build_id] Build index is used to se‐
463 lect a build and defaults to 0 if not specified.
464 Example: 12345/2 selects build 2 for
466 product 12345
467 --galaxy-show-local-cloud-saves arg
469 Show local cloud-saves using product id [product_id/build_index]
470 or gamename regex [gamename/build_id] Build index is used to se‐
471 lect a build and defaults to 0 if not specified.
472 Example: 12345/2 selects build 2 for
474 product 12345
475 --galaxy-delete-cloud-saves arg
477 Delete cloud-saves using product id [product_id/build_index] or
478 gamename regex [gamename/build_id] Build index is used to select
479 a build and defaults to 0 if not specified.
480 Example: 12345/2 selects build 2 for
482 product 12345
483 --galaxy-platform arg (=w)
485 Select platform Windows = w|win|windows Mac = m|mac|osx Linux =
486 l|lin|linux
487 --galaxy-language arg (=en)
489 Select language English = en|eng|english|en[_-]US German =
490 de|deu|ger|german|de[_-]DE French = fr|fra|fre|french|fr[_-]FR
491 Polish = pl|pol|polish|pl[_-]PL Russian = ru|rus|rus‐
492 sian|ru[_-]RU Chinese = cn|zh|zho|chi|chinese|zh[_-]C N Czech =
493 cz|cs|ces|cze|czech|cs[_-]CZ Spanish = es|spa|spanish|es[_-]ES
494 Hungarian = hu|hun|hungarian|hu[_-]HU Italian = it|ita|ital‐
495 ian|it[_-]IT Japanese = jp|ja|jpn|japanese|ja[_-]JP Turkish =
496 tr|tur|turkish|tr[_-]TR Portuguese = pt|por|portuguese|pt[_-]PT
497 Korean = ko|kor|korean|ko[_-]KR Dutch =
498 nl|nld|dut|dutch|nl[_-]NL Swedish = sv|swe|swedish|sv[_-]SE Nor‐
499 wegian = no|nor|norwegian|nb[_-]no|n n[_-]NO Danish =
500 da|dan|danish|da[_-]DK Finnish = fi|fin|finnish|fi[_-]FI Brazil‐
501 ian Portuguese = br|pt_br|pt-br|ptbr|brazilian_portugues e Slo‐
502 vak = sk|slk|slo|slovak|sk[_-]SK Bulgarian = bl|bg|bul|bulgar‐
503 ian|bg[_-]B G Ukrainian = uk|ukr|ukrainian|uk[_-]UA Spanish
504 (Latin American) = es_mx|es-mx|esmx|es-419|spanish_latin_a meri‐
505 can Arabic = ar|ara|arabic|ar[_-][A-Z]{2} Romanian =
506 ro|ron|rum|romanian|ro[_-][R M]O Hebrew = he|heb|hebrew|he[_-]IL
507 Thai = th|tha|thai|th[_-]TH
508 --galaxy-arch arg (=x64)
510 Select architecture 32-bit = 32|x86|32bit|32-bit 64-bit =
511 64|x64|64bit|64-bit
512 --galaxy-no-dependencies
514 Don't download dependencies during --galaxy-install
515 --subdir-galaxy-install arg (=%install_dir%)
517 Set subdirectory for galaxy install
518 Templates:
520 - %install_dir% = Installation directory from Galaxy API re‐
521 sponse - %gamename% = Game name - %title% = Title of the game -
522 %product_id% = Product id of the game - %install_dir_stripped% =
523 %install_dir% with some characters stripped - %title_stripped% =
524 %title% with some characters stripped
525 "stripped" means that every character
527 that doesn't match the following list is removed: > alphanumeric
528 > space > - _ . ( ) [ ] { }
529 --galaxy-cdn-priority arg (=edgecast,highwinds,akamai,lumen,gog_cdn)
531 Set priority for used CDNs Edgecast = ec|edgecast Highwinds =
532 hw|highwinds|high_winds GOG = gog|gog_cdn Lumen = lumen|lu‐
533 men_cdn Akamai = akamai|akamai_cdn|akamai_ec|ak amai_edge‐
534 cast_proxy
535 Set priority by separating values with
537 "," Combine values by separating with "+"
538 --galaxy-delete-orphans
540 Delete orphaned files during --galaxy-install
541
543 Allows user to specify individual files that should not be downloaded
544 or mentioned as orphans.
545 Each line in the file specifies one blacklist expression, except for
547 empty lines and lines starting with #. First few characters specify
548 blacklist item type and flags. So far, only regular expression (perl
549 variant) are supported, so each line must start with "Rp" characters.
550 After a space comes the expression itself. Expressions are matched
551 against file path relative to what was specified as --directory.
552 Example black list
554 # used to store manually downloaded mods/patches/maps/, don't mention
555 it as orphans
556 Rp ^[^/]*/manual/.*
557 # included with every *divinity game, once is enough
558 Rp beyond_divinity/extras/bd_ladymageknight.zip
559 Rp divinity_2_developers_cut/extras/divinity_2_ladymageknight.zip
560 # extra 6GB is A LOT of space if you don't actually plan to mod your
562 game
563 Rp the_witcher_2/extras/the_witcher_2_redkit.zip
564 Rp the_witcher_2/extras/extras_pack_3_hu_pl_ru_tr_zh_.zip
565 Rp the_witcher_2/extras/extras_pack_2_fr_it_jp_.zip
566
568 Separating values with "," when using language and platform switches
569 enables a priority-based mode: only the first matching one will be
570 downloaded.
571 For example, setting language to fr+en means both French and English
573 will be downloaded (if available) for all games. Setting language to
574 fr,en means that the French version (and only that one) will be down‐
575 loaded if available, and if not, the English version will be down‐
576 loaded.
577 You're allowed to "stack" codes in the priority string if needed. If
579 you set language to es+fr,en it means it'll download both Spanish (es)
580 and French (fr) versions if they are available, and the English (en)
581 one only if none of French and Spanish are available.
582
584 The latest version of this distribution is available from
585 https://github.com/Sude-/lgogdownloader
586
588 $XDG_CONFIG_HOME/lgogdownloader/
589 Storage for configuration files and cookies
590 If $XDG_CONFIG_HOME is not set, it will use $HOME/.config/lgog‐
591 downloader/.
592 $XDG_CACHE_HOME/lgogdownloader/xml/
595 Storage for XML files
596 If $XDG_CACHE_HOME is not set, it will use $HOME/.cache/lgog‐
597 downloader/xml/.
598 $XDG_CONFIG_HOME/lgogdownloader/blacklist.txt
601 Allows user to specify individual files that should not be down‐
602 loaded.
603 It doesn't have to exist, but if it does exist, it must be read‐
604 able to lgogdownloader.
605 $XDG_CONFIG_HOME/lgogdownloader/ignorelist.txt
608 Allows user to specify individual files that should not be men‐
609 tioned as orphans. The file has the same format and interpreta‐
610 tion as a blacklist.
611 It doesn't have to exist, but if it does exist, it must be read‐
612 able to lgogdownloader.
613 $XDG_CONFIG_HOME/lgogdownloader/game_has_dlc.txt
616 Allows user to specify which games have dlc and should have
617 their DLC count information ignored. The file has the same for‐
618 mat and interpretation as a blacklist.
619 It doesn't have to exist, but if it does exist, it must be read‐
620 able to lgogdownloader.
621 If the file exists lgogdownloader uses it instead of list speci‐
622 fied with --dlc-list option
623 $XDG_CONFIG_HOME/lgogdownloader/gamespecific/gamename.conf
626 JSON formatted file. Sets game specific settings for gamename.
627 Allowed settings are language, platform, dlc, ignore-dlc-count
628 subdirectories, directory, subdir-game, subdir-installers, sub‐
629 dir-extras, subdir-patches, subdir-language-packs and subdir-
630 dlc.
631 The dlc option is limited to disabling DLC for specific game. It
632 can't enable DLC listing/downloading if --no-dlc option is used.
633 Must be in the following format:
634 {
635 "language" : <string>,
636 "platform" : <string>,
637 "dlc" : <bool>,
638 "ignore-dlc-count" : <bool>,
639 "subdirectories" : <bool>,
640 "directory" : <string>,
641 "subdir-game" : <string>,
642 "subdir-installers" : <string>,
643 "subdir-extras" : <string>,
644 "subdir-patches" : <string>,
645 "subdir-language-packs" : <string>,
646 "subdir-dlc" : <string>
647 }
648LGOGDownloader 3.11 July 2023 LGOGDOWNLOADER(1)