1LGOGDOWNLOADER(1) User Commands LGOGDOWNLOADER(1)
2
6 LGOGDownloader - manual page for LGOGDownloader 3.8
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.8 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.8 (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 Thai = th|tha|thai|th[_-]TH
210 All = all
211 Set priority by separating values with
213 ","
214 Combine values by separating with "+"
215 Example: German if available otherwise
216 English and French: de,en+fr
217 --no-remote-xml
219 Don't use remote XML for repair
220 --no-unicode
222 Don't use Unicode in the progress bar
223 --no-color
225 Don't use coloring in the progress bar
226 or status messages
227 --no-duplicate-handling
229 Don't use duplicate handler for
230 installers
231 Duplicate installers from different
232 languages are handled separately
233 --no-subdirectories
235 Don't create subdirectories for extras,
236 patches and language packs
237 --verbose
239 Print lots of information
240 --curl-verbose
242 Set libcurl to verbose mode
243 --insecure
245 Don't verify authenticity of SSL
246 certificates
247 --timeout arg (=10)
249 Set timeout for connection
250 Maximum time in seconds that connection
251 phase is allowed to take
252 --retries arg (=3)
254 Set maximum number of retries on failed
255 download
256 --wait arg (=0)
258 Time to wait between requests
259 (milliseconds)
260 --subdir-installers arg
262 Set subdirectory for installers
263 Templates:
264 - %platform%
265 - %gamename%
266 - %gamename_firstletter%
267 - %dlcname%
268 --subdir-extras arg (=extras)
270 Set subdirectory for extras
271 Templates:
272 - %platform%
273 - %gamename%
274 - %gamename_firstletter%
275 - %dlcname%
276 --subdir-patches arg (=patches)
278 Set subdirectory for patches
279 Templates:
280 - %platform%
281 - %gamename%
282 - %gamename_firstletter%
283 - %dlcname%
284 --subdir-language-packs arg (=languagepacks)
286 Set subdirectory for language packs
287 Templates:
288 - %platform%
289 - %gamename%
290 - %gamename_firstletter%
291 - %dlcname%
292 --subdir-dlc arg (=dlc/%dlcname%)
294 Set subdirectory for dlc
295 Templates:
296 - %platform%
297 - %gamename%
298 - %gamename_firstletter%
299 - %dlcname%
300 --subdir-game arg (=%gamename%)
302 Set subdirectory for game
303 Templates:
304 - %platform%
305 - %gamename%
306 - %gamename_firstletter%
307 - %dlcname%
308 --use-cache
310 Use game details cache
311 --cache-valid arg (=2880)
313 Set how long cached game details are
314 valid (in minutes)
315 Default: 2880 minutes (48 hours)
316 --save-serials
318 Save serial numbers when downloading
319 --ignore-dlc-count [=arg(=.*)]
321 Set regular expression filter for games
322 to ignore DLC count information
323 Ignoring DLC count information helps in
324 situations where the account page
325 doesn't provide accurate information
326 about DLCs
327 --include arg (=all)
329 Select what to download/list/repair
330 Installers = i|installers
331 Extras = e|extras
332 Patches = p|patches
333 Language packs = l|languagepacks|langpa
334 cks
335 DLCs = d|dlc|dlcs
336 Separate with "," to use multiple
337 values
338 --exclude arg
340 Select what not to download/list/repair
341 Installers = i|installers
342 Extras = e|extras
343 Patches = p|patches
344 Language packs = l|languagepacks|langpa
345 cks
346 DLCs = d|dlc|dlcs
347 Separate with "," to use multiple
348 values
349 --automatic-xml-creation
351 Automatically create XML data after
352 download has completed
353 --save-changelogs
355 Save changelogs when downloading
356 --threads arg (=4)
358 Number of download threads
359 --info-threads arg (=4)
361 Number of threads for getting product
362 info
363 --dlc-list arg (=https://raw.githubusercontent.com/Sude-/lgogdownloader-lists/master/game_has_dlc.txt)
365 Set URL for list of games that have DLC
366 --progress-interval arg (=100)
368 Set interval for progress bar update
369 (milliseconds)
370 Value must be between 1 and 10000
371 --lowspeed-timeout arg (=30)
373 Set time in number seconds that the
374 transfer speed should be below the rate
375 set with --lowspeed-rate for it to
376 considered too slow and aborted
377 --lowspeed-rate arg (=200)
379 Set average transfer speed in bytes per
380 second that the transfer should be
381 below during time specified with
382 --lowspeed-timeout for it to be
383 considered too slow and aborted
384 --include-hidden-products
386 Include games that have been set hidden
387 in account page
388 Experimental:
390 --galaxy-install arg
391 Install game using product id [product_id/build_index] or game‐
392 name regex [gamename/build_id] Build index is used to select a
393 build and defaults to 0 if not specified.
394 Example: 12345/2 selects build 2 for
396 product 12345
397 --galaxy-show-builds arg
399 Show game builds using product id [product_id/build_index] or
400 gamename regex [gamename/build_id] Build index is used to select
401 a build and defaults to 0 if not specified.
402 Example: 12345/2 selects build 2 for
404 product 12345
405 --galaxy-platform arg (=w)
407 Select platform Windows = w|win|windows Mac = m|mac|osx Linux =
408 l|lin|linux
409 --galaxy-language arg (=en)
411 Select language English = en|eng|english|en[_-]US German =
412 de|deu|ger|german|de[_-]DE French = fr|fra|fre|french|fr[_-]FR
413 Polish = pl|pol|polish|pl[_-]PL Russian = ru|rus|rus‐
414 sian|ru[_-]RU Chinese = cn|zh|zho|chi|chinese|zh[_-]C N Czech =
415 cz|cs|ces|cze|czech|cs[_-]CZ Spanish = es|spa|spanish|es[_-]ES
416 Hungarian = hu|hun|hungarian|hu[_-]HU Italian = it|ita|ital‐
417 ian|it[_-]IT Japanese = jp|ja|jpn|japanese|ja[_-]JP Turkish =
418 tr|tur|turkish|tr[_-]TR Portuguese = pt|por|portuguese|pt[_-]PT
419 Korean = ko|kor|korean|ko[_-]KR Dutch =
420 nl|nld|dut|dutch|nl[_-]NL Swedish = sv|swe|swedish|sv[_-]SE Nor‐
421 wegian = no|nor|norwegian|nb[_-]no|n n[_-]NO Danish =
422 da|dan|danish|da[_-]DK Finnish = fi|fin|finnish|fi[_-]FI Brazil‐
423 ian Portuguese = br|pt_br|pt-br|ptbr|brazilian_portugues e Slo‐
424 vak = sk|slk|slo|slovak|sk[_-]SK Bulgarian = bl|bg|bul|bulgar‐
425 ian|bg[_-]B G Ukrainian = uk|ukr|ukrainian|uk[_-]UA Spanish
426 (Latin American) = es_mx|es-mx|esmx|es-419|spanish_latin_a meri‐
427 can Arabic = ar|ara|arabic|ar[_-][A-Z]{2} Romanian =
428 ro|ron|rum|romanian|ro[_-][R M]O Hebrew = he|heb|hebrew|he[_-]IL
429 Thai = th|tha|thai|th[_-]TH
430 --galaxy-arch arg (=x64)
432 Select architecture 32-bit = 32|x86|32bit|32-bit 64-bit =
433 64|x64|64bit|64-bit
434 --galaxy-no-dependencies
436 Don't download dependencies during --galaxy-install
437 --subdir-galaxy-install arg (=%install_dir%)
439 Set subdirectory for galaxy install
440 Templates:
442 - %install_dir% = Installation directory from Galaxy API re‐
443 sponse - %gamename% = Game name - %title% = Title of the game -
444 %product_id% = Product id of the game - %install_dir_stripped% =
445 %install_dir% with some characters stripped - %title_stripped% =
446 %title% with some characters stripped
447 "stripped" means that every character
449 that doesn't match the following list is removed: > alphanumeric
450 > space > - _ . ( ) [ ] { }
451 --galaxy-cdn-priority arg (=edgecast,highwinds,gog_cdn)
453 Set priority for used CDNs Edgecast = ec|edgecast Highwinds =
454 hw|highwinds|high_winds GOG = gog|gog_cdn
455 Set priority by separating values with
457 "," Combine values by separating with "+"
458 --galaxy-delete-orphans
460 Delete orphaned files during --galaxy-install
461
463 Allows user to specify individual files that should not be downloaded
464 or mentioned as orphans.
465 Each line in the file specifies one blacklist expression, except for
467 empty lines and lines starting with #. First few characters specify
468 blacklist item type and flags. So far, only regular expression (perl
469 variant) are supported, so each line must start with "Rp" characters.
470 After a space comes the expression itself. Expressions are matched
471 against file path relative to what was specified as --directory.
472 Example black list
474 # used to store manually downloaded mods/patches/maps/, don't mention
475 it as orphans
476 Rp ^[^/]*/manual/.*
477 # included with every *divinity game, once is enough
478 Rp beyond_divinity/extras/bd_ladymageknight.zip
479 Rp divinity_2_developers_cut/extras/divinity_2_ladymageknight.zip
480 # extra 6GB is A LOT of space if you don't actually plan to mod your
482 game
483 Rp the_witcher_2/extras/the_witcher_2_redkit.zip
484 Rp the_witcher_2/extras/extras_pack_3_hu_pl_ru_tr_zh_.zip
485 Rp the_witcher_2/extras/extras_pack_2_fr_it_jp_.zip
486
488 Separating values with "," when using language and platform switches
489 enables a priority-based mode: only the first matching one will be
490 downloaded.
491 For example, setting language to fr+en means both French and English
493 will be downloaded (if available) for all games. Setting language to
494 fr,en means that the French version (and only that one) will be down‐
495 loaded if available, and if not, the English version will be down‐
496 loaded.
497 You're allowed to "stack" codes in the priority string if needed. If
499 you set language to es+fr,en it means it'll download both Spanish (es)
500 and French (fr) versions if they are available, and the English (en)
501 one only if none of French and Spanish are available.
502
504 The latest version of this distribution is available from
505 https://github.com/Sude-/lgogdownloader
506
508 $XDG_CONFIG_HOME/lgogdownloader/
509 Storage for configuration files and cookies
510 If $XDG_CONFIG_HOME is not set, it will use $HOME/.config/lgog‐
511 downloader/.
512 $XDG_CACHE_HOME/lgogdownloader/xml/
515 Storage for XML files
516 If $XDG_CACHE_HOME is not set, it will use $HOME/.cache/lgog‐
517 downloader/xml/.
518 $XDG_CONFIG_HOME/lgogdownloader/blacklist.txt
521 Allows user to specify individual files that should not be down‐
522 loaded.
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/ignorelist.txt
528 Allows user to specify individual files that should not be men‐
529 tioned as orphans. The file has the same format and interpreta‐
530 tion as a blacklist.
531 It doesn't have to exist, but if it does exist, it must be read‐
532 able to lgogdownloader.
533 $XDG_CONFIG_HOME/lgogdownloader/game_has_dlc.txt
536 Allows user to specify which games have dlc and should have
537 their DLC count information ignored. The file has the same for‐
538 mat and interpretation as a blacklist.
539 It doesn't have to exist, but if it does exist, it must be read‐
540 able to lgogdownloader.
541 If the file exists lgogdownloader uses it instead of list speci‐
542 fied with --dlc-list option
543 $XDG_CONFIG_HOME/lgogdownloader/gamespecific/gamename.conf
546 JSON formatted file. Sets game specific settings for gamename.
547 Allowed settings are language, platform, dlc, ignore-dlc-count
548 subdirectories, directory, subdir-game, subdir-installers, sub‐
549 dir-extras, subdir-patches, subdir-language-packs and subdir-
550 dlc.
551 The dlc option is limited to disabling DLC for specific game. It
552 can't enable DLC listing/downloading if --no-dlc option is used.
553 Must be in the following format:
554 {
555 "language" : <string>,
556 "platform" : <string>,
557 "dlc" : <bool>,
558 "ignore-dlc-count" : <bool>,
559 "subdirectories" : <bool>,
560 "directory" : <string>,
561 "subdir-game" : <string>,
562 "subdir-installers" : <string>,
563 "subdir-extras" : <string>,
564 "subdir-patches" : <string>,
565 "subdir-language-packs" : <string>,
566 "subdir-dlc" : <string>
567 }
568LGOGDownloader 3.8 January 2022 LGOGDOWNLOADER(1)