1LGOGDOWNLOADER(1) User Commands LGOGDOWNLOADER(1)
2
6 LGOGDownloader - manual page for LGOGDownloader 3.9
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.9 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.9 (Linux x86_64))
139 Set user agent
140 --enable-login-gui
142 Enable login GUI when encountering
143 reCAPTCHA on login form
144 --list-tags
146 List tags
147 --tag arg
149 Filter using tags. Separate with "," to
150 use multiple values
151 --directory arg (=.)
153 Set download directory
154 --limit-rate arg (=0)
156 Limit download rate to value in kB
157 0 = unlimited
158 --xml-directory arg
160 Set directory for GOG XML files
161 --chunk-size arg (=10)
163 Chunk size (in MB) when creating XML
164 --platform arg (=w+l)
166 Select which installers are downloaded
167 Windows = w|win|windows
168 Mac = m|mac|osx
169 Linux = l|lin|linux
170 All = all
171 Set priority by separating values with
173 ","
174 Combine values by separating with "+"
175 Example: Linux if available otherwise
176 Windows and Mac: l,w+m
177 --language arg (=en)
179 Select which language installers are
180 downloaded
181 English = en|eng|english|en[_-]US
182 German = de|deu|ger|german|de[_-]DE
183 French = fr|fra|fre|french|fr[_-]FR
184 Polish = pl|pol|polish|pl[_-]PL
185 Russian = ru|rus|russian|ru[_-]RU
186 Chinese = cn|zh|zho|chi|chinese|zh[_-]C
187 N
188 Czech = cz|cs|ces|cze|czech|cs[_-]CZ
189 Spanish = es|spa|spanish|es[_-]ES
190 Hungarian = hu|hun|hungarian|hu[_-]HU
191 Italian = it|ita|italian|it[_-]IT
192 Japanese = jp|ja|jpn|japanese|ja[_-]JP
193 Turkish = tr|tur|turkish|tr[_-]TR
194 Portuguese = pt|por|portuguese|pt[_-]PT
195 Korean = ko|kor|korean|ko[_-]KR
196 Dutch = nl|nld|dut|dutch|nl[_-]NL
197 Swedish = sv|swe|swedish|sv[_-]SE
198 Norwegian = no|nor|norwegian|nb[_-]no|n
199 n[_-]NO
200 Danish = da|dan|danish|da[_-]DK
201 Finnish = fi|fin|finnish|fi[_-]FI
202 Brazilian Portuguese =
203 br|pt_br|pt-br|ptbr|brazilian_portugues
204 e
205 Slovak = sk|slk|slo|slovak|sk[_-]SK
206 Bulgarian = bl|bg|bul|bulgarian|bg[_-]B
207 G
208 Ukrainian = uk|ukr|ukrainian|uk[_-]UA
209 Spanish (Latin American) =
210 es_mx|es-mx|esmx|es-419|spanish_latin_a
211 merican
212 Arabic = ar|ara|arabic|ar[_-][A-Z]{2}
213 Romanian = ro|ron|rum|romanian|ro[_-][R
214 M]O
215 Hebrew = he|heb|hebrew|he[_-]IL
216 Thai = th|tha|thai|th[_-]TH
217 All = all
218 Set priority by separating values with
220 ","
221 Combine values by separating with "+"
222 Example: German if available otherwise
223 English and French: de,en+fr
224 --no-remote-xml
226 Don't use remote XML for repair
227 --no-unicode
229 Don't use Unicode in the progress bar
230 --no-color
232 Don't use coloring in the progress bar
233 or status messages
234 --no-duplicate-handling
236 Don't use duplicate handler for
237 installers
238 Duplicate installers from different
239 languages are handled separately
240 --no-subdirectories
242 Don't create subdirectories for extras,
243 patches and language packs
244 --verbose
246 Print lots of information
247 --curl-verbose
249 Set libcurl to verbose mode
250 --insecure
252 Don't verify authenticity of SSL
253 certificates
254 --timeout arg (=10)
256 Set timeout for connection
257 Maximum time in seconds that connection
258 phase is allowed to take
259 --retries arg (=3)
261 Set maximum number of retries on failed
262 download
263 --wait arg (=0)
265 Time to wait between requests
266 (milliseconds)
267 --subdir-installers arg
269 Set subdirectory for installers
270 Templates:
271 - %platform%
272 - %gamename%
273 - %gamename_firstletter%
274 - %dlcname%
275 --subdir-extras arg (=extras)
277 Set subdirectory for extras
278 Templates:
279 - %platform%
280 - %gamename%
281 - %gamename_firstletter%
282 - %dlcname%
283 --subdir-patches arg (=patches)
285 Set subdirectory for patches
286 Templates:
287 - %platform%
288 - %gamename%
289 - %gamename_firstletter%
290 - %dlcname%
291 --subdir-language-packs arg (=languagepacks)
293 Set subdirectory for language packs
294 Templates:
295 - %platform%
296 - %gamename%
297 - %gamename_firstletter%
298 - %dlcname%
299 --subdir-dlc arg (=dlc/%dlcname%)
301 Set subdirectory for dlc
302 Templates:
303 - %platform%
304 - %gamename%
305 - %gamename_firstletter%
306 - %dlcname%
307 --subdir-game arg (=%gamename%)
309 Set subdirectory for game
310 Templates:
311 - %platform%
312 - %gamename%
313 - %gamename_firstletter%
314 - %dlcname%
315 --use-cache
317 Use game details cache
318 --cache-valid arg (=2880)
320 Set how long cached game details are
321 valid (in minutes)
322 Default: 2880 minutes (48 hours)
323 --save-serials
325 Save serial numbers when downloading
326 --ignore-dlc-count [=arg(=.*)]
328 Set regular expression filter for games
329 to ignore DLC count information
330 Ignoring DLC count information helps in
331 situations where the account page
332 doesn't provide accurate information
333 about DLCs
334 --include arg (=all)
336 Select what to download/list/repair
337 Installers = i|installers
338 Extras = e|extras
339 Patches = p|patches
340 Language packs = l|languagepacks|langpa
341 cks
342 DLCs = d|dlc|dlcs
343 Separate with "," to use multiple
344 values
345 --exclude arg
347 Select what not to download/list/repair
348 Installers = i|installers
349 Extras = e|extras
350 Patches = p|patches
351 Language packs = l|languagepacks|langpa
352 cks
353 DLCs = d|dlc|dlcs
354 Separate with "," to use multiple
355 values
356 --automatic-xml-creation
358 Automatically create XML data after
359 download has completed
360 --save-changelogs
362 Save changelogs when downloading
363 --threads arg (=4)
365 Number of download threads
366 --info-threads arg (=4)
368 Number of threads for getting product
369 info
370 --use-dlc-list
372 Use DLC list specified with --dlc-list
373 --dlc-list arg (=https://raw.githubusercontent.com/Sude-/lgogdownloader-lists/master/game_has_dlc.txt)
375 Set URL for list of games that have DLC
376 --progress-interval arg (=100)
378 Set interval for progress bar update
379 (milliseconds)
380 Value must be between 1 and 10000
381 --lowspeed-timeout arg (=30)
383 Set time in number seconds that the
384 transfer speed should be below the rate
385 set with --lowspeed-rate for it to
386 considered too slow and aborted
387 --lowspeed-rate arg (=200)
389 Set average transfer speed in bytes per
390 second that the transfer should be
391 below during time specified with
392 --lowspeed-timeout for it to be
393 considered too slow and aborted
394 --include-hidden-products
396 Include games that have been set hidden
397 in account page
398 --size-only
400 Don't check the hashes of the files
401 whose size matches that on the server
402 Experimental:
404 --galaxy-install arg
405 Install game using product id [product_id/build_index] or game‐
406 name regex [gamename/build_id] Build index is used to select a
407 build and defaults to 0 if not specified.
408 Example: 12345/2 selects build 2 for
410 product 12345
411 --galaxy-show-builds arg
413 Show game builds using product id [product_id/build_index] or
414 gamename regex [gamename/build_id] Build index is used to select
415 a build and defaults to 0 if not specified.
416 Example: 12345/2 selects build 2 for
418 product 12345
419 --galaxy-platform arg (=w)
421 Select platform Windows = w|win|windows Mac = m|mac|osx Linux =
422 l|lin|linux
423 --galaxy-language arg (=en)
425 Select language English = en|eng|english|en[_-]US German =
426 de|deu|ger|german|de[_-]DE French = fr|fra|fre|french|fr[_-]FR
427 Polish = pl|pol|polish|pl[_-]PL Russian = ru|rus|rus‐
428 sian|ru[_-]RU Chinese = cn|zh|zho|chi|chinese|zh[_-]C N Czech =
429 cz|cs|ces|cze|czech|cs[_-]CZ Spanish = es|spa|spanish|es[_-]ES
430 Hungarian = hu|hun|hungarian|hu[_-]HU Italian = it|ita|ital‐
431 ian|it[_-]IT Japanese = jp|ja|jpn|japanese|ja[_-]JP Turkish =
432 tr|tur|turkish|tr[_-]TR Portuguese = pt|por|portuguese|pt[_-]PT
433 Korean = ko|kor|korean|ko[_-]KR Dutch =
434 nl|nld|dut|dutch|nl[_-]NL Swedish = sv|swe|swedish|sv[_-]SE Nor‐
435 wegian = no|nor|norwegian|nb[_-]no|n n[_-]NO Danish =
436 da|dan|danish|da[_-]DK Finnish = fi|fin|finnish|fi[_-]FI Brazil‐
437 ian Portuguese = br|pt_br|pt-br|ptbr|brazilian_portugues e Slo‐
438 vak = sk|slk|slo|slovak|sk[_-]SK Bulgarian = bl|bg|bul|bulgar‐
439 ian|bg[_-]B G Ukrainian = uk|ukr|ukrainian|uk[_-]UA Spanish
440 (Latin American) = es_mx|es-mx|esmx|es-419|spanish_latin_a meri‐
441 can Arabic = ar|ara|arabic|ar[_-][A-Z]{2} Romanian =
442 ro|ron|rum|romanian|ro[_-][R M]O Hebrew = he|heb|hebrew|he[_-]IL
443 Thai = th|tha|thai|th[_-]TH
444 --galaxy-arch arg (=x64)
446 Select architecture 32-bit = 32|x86|32bit|32-bit 64-bit =
447 64|x64|64bit|64-bit
448 --galaxy-no-dependencies
450 Don't download dependencies during --galaxy-install
451 --subdir-galaxy-install arg (=%install_dir%)
453 Set subdirectory for galaxy install
454 Templates:
456 - %install_dir% = Installation directory from Galaxy API re‐
457 sponse - %gamename% = Game name - %title% = Title of the game -
458 %product_id% = Product id of the game - %install_dir_stripped% =
459 %install_dir% with some characters stripped - %title_stripped% =
460 %title% with some characters stripped
461 "stripped" means that every character
463 that doesn't match the following list is removed: > alphanumeric
464 > space > - _ . ( ) [ ] { }
465 --galaxy-cdn-priority arg (=edgecast,highwinds,akamai,lumen,gog_cdn)
467 Set priority for used CDNs Edgecast = ec|edgecast Highwinds =
468 hw|highwinds|high_winds GOG = gog|gog_cdn Lumen = lumen|lu‐
469 men_cdn Akamai = akamai|akamai_cdn|akamai_ec|ak amai_edge‐
470 cast_proxy
471 Set priority by separating values with
473 "," Combine values by separating with "+"
474 --galaxy-delete-orphans
476 Delete orphaned files during --galaxy-install
477
479 Allows user to specify individual files that should not be downloaded
480 or mentioned as orphans.
481 Each line in the file specifies one blacklist expression, except for
483 empty lines and lines starting with #. First few characters specify
484 blacklist item type and flags. So far, only regular expression (perl
485 variant) are supported, so each line must start with "Rp" characters.
486 After a space comes the expression itself. Expressions are matched
487 against file path relative to what was specified as --directory.
488 Example black list
490 # used to store manually downloaded mods/patches/maps/, don't mention
491 it as orphans
492 Rp ^[^/]*/manual/.*
493 # included with every *divinity game, once is enough
494 Rp beyond_divinity/extras/bd_ladymageknight.zip
495 Rp divinity_2_developers_cut/extras/divinity_2_ladymageknight.zip
496 # extra 6GB is A LOT of space if you don't actually plan to mod your
498 game
499 Rp the_witcher_2/extras/the_witcher_2_redkit.zip
500 Rp the_witcher_2/extras/extras_pack_3_hu_pl_ru_tr_zh_.zip
501 Rp the_witcher_2/extras/extras_pack_2_fr_it_jp_.zip
502
504 Separating values with "," when using language and platform switches
505 enables a priority-based mode: only the first matching one will be
506 downloaded.
507 For example, setting language to fr+en means both French and English
509 will be downloaded (if available) for all games. Setting language to
510 fr,en means that the French version (and only that one) will be down‐
511 loaded if available, and if not, the English version will be down‐
512 loaded.
513 You're allowed to "stack" codes in the priority string if needed. If
515 you set language to es+fr,en it means it'll download both Spanish (es)
516 and French (fr) versions if they are available, and the English (en)
517 one only if none of French and Spanish are available.
518
520 The latest version of this distribution is available from
521 https://github.com/Sude-/lgogdownloader
522
524 $XDG_CONFIG_HOME/lgogdownloader/
525 Storage for configuration files and cookies
526 If $XDG_CONFIG_HOME is not set, it will use $HOME/.config/lgog‐
527 downloader/.
528 $XDG_CACHE_HOME/lgogdownloader/xml/
531 Storage for XML files
532 If $XDG_CACHE_HOME is not set, it will use $HOME/.cache/lgog‐
533 downloader/xml/.
534 $XDG_CONFIG_HOME/lgogdownloader/blacklist.txt
537 Allows user to specify individual files that should not be down‐
538 loaded.
539 It doesn't have to exist, but if it does exist, it must be read‐
540 able to lgogdownloader.
541 $XDG_CONFIG_HOME/lgogdownloader/ignorelist.txt
544 Allows user to specify individual files that should not be men‐
545 tioned as orphans. The file has the same format and interpreta‐
546 tion as a blacklist.
547 It doesn't have to exist, but if it does exist, it must be read‐
548 able to lgogdownloader.
549 $XDG_CONFIG_HOME/lgogdownloader/game_has_dlc.txt
552 Allows user to specify which games have dlc and should have
553 their DLC count information ignored. The file has the same for‐
554 mat and interpretation as a blacklist.
555 It doesn't have to exist, but if it does exist, it must be read‐
556 able to lgogdownloader.
557 If the file exists lgogdownloader uses it instead of list speci‐
558 fied with --dlc-list option
559 $XDG_CONFIG_HOME/lgogdownloader/gamespecific/gamename.conf
562 JSON formatted file. Sets game specific settings for gamename.
563 Allowed settings are language, platform, dlc, ignore-dlc-count
564 subdirectories, directory, subdir-game, subdir-installers, sub‐
565 dir-extras, subdir-patches, subdir-language-packs and subdir-
566 dlc.
567 The dlc option is limited to disabling DLC for specific game. It
568 can't enable DLC listing/downloading if --no-dlc option is used.
569 Must be in the following format:
570 {
571 "language" : <string>,
572 "platform" : <string>,
573 "dlc" : <bool>,
574 "ignore-dlc-count" : <bool>,
575 "subdirectories" : <bool>,
576 "directory" : <string>,
577 "subdir-game" : <string>,
578 "subdir-installers" : <string>,
579 "subdir-extras" : <string>,
580 "subdir-patches" : <string>,
581 "subdir-language-packs" : <string>,
582 "subdir-dlc" : <string>
583 }
584LGOGDownloader 3.9 September 2022 LGOGDOWNLOADER(1)