1LGOGDOWNLOADER(1)                User Commands               LGOGDOWNLOADER(1)
2
3
4

NAME

6       LGOGDownloader - manual page for LGOGDownloader 3.11
7

SYNOPSIS

9       lgogdownloader [OPTION]...
10

DESCRIPTION

12       An  open-source  GOG.com downloader for Linux users which uses the same
13       API as GOG Galaxy.
14
15       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
20       LGOGDownloader 3.11 Options:
21
22       -h [ --help ]
23              Print help message
24
25       --version
26              Print version information
27
28       --login
29              Login
30
31       --list [=arg(=games)]
32              List  games/tags  Games  =  g|games  Details  = d|details JSON =
33              j|json Tags = t|tags
34
35       --download
36              Download
37
38       --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
43       --game arg
44              Set regular expression  filter  for  download/list/repair  (Perl
45              syntax)
46
47       --create-xml [=arg(=automatic)]
48              Create GOG XML for file "automatic" to enable automatic XML cre‐
49              ation
50
51       --notifications
52              Check notifications
53
54       --updated
55              List/download only games with update flag set
56
57       --clear-update-flags
58              Clear update notification flags
59
60       --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
67       --status
68              Show status of files
69
70       Output format:
71              statuscode gamename filename filesize filehash
72
73       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
77       --save-config
78              Create config file with current
79              settings
80
81       --reset-config
82              Reset config settings to default
83
84       --report [=arg(=lgogdownloader-report.log)]
85              Save report of downloaded/repaired
86              files to specified file
87              Default filename: lgogdownloader-report
88              .log
89
90       --update-cache
91              Update game details cache
92
93       --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
106       --download-file arg
107              Download files using fileid
108
109       Format:
110              "gamename/fileid"
111              or: "gogdownloader://gamename/fileid"
112
113       Multiple files:
114              "gamename1/fileid1,gamename2/fileid2"
115              or: "gogdownloader://gamename1/fileid1,
116              gamename2/fileid2"
117
118       This option ignores all subdir options.
119              The files are downloaded to directory
120              specified with --directory option.
121
122       -o [ --output-file ] arg
123              Set filename of file downloaded with
124              --download-file.
125
126       --wishlist
127              Show wishlist
128
129       --cacert arg
130              Path to CA certificate bundle in PEM
131              format
132
133       --respect-umask
134              Do not adjust permissions of sensitive
135              files
136
137       --user-agent arg (=LGOGDownloader/3.11 (Linux x86_64))
138              Set user agent
139
140       --wine-prefix arg (=.)
141              Set wineprefix directory
142
143       --cloud-whitelist arg
144              Include this list of cloud saves, by
145              default all cloud saves are included
146
147       Example: --cloud-whitelist
148              saves/AutoSave-0 saves/AutoSave-1/scree
149              nshot.png
150
151       --cloud-blacklist arg
152              Exclude this list of cloud saves
153              Example: --cloud-blacklist
154
155       saves/AutoSave-0 saves/AutoSave-1/scree
156              nshot.png
157
158       --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
164       --enable-login-gui
165              Enable login GUI when encountering
166              reCAPTCHA on login form
167
168       --tag arg
169              Filter using tags. Separate with "," to
170              use multiple values
171
172       --directory arg (=.)
173              Set download directory
174
175       --limit-rate arg (=0)
176              Limit download rate to value in kB
177              0 = unlimited
178
179       --xml-directory arg
180              Set directory for GOG XML files
181
182       --chunk-size arg (=10)
183              Chunk size (in MB) when creating XML
184
185       --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
192       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
198       --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
239       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
245       --no-remote-xml
246              Don't use remote XML for repair
247
248       --no-unicode
249              Don't use Unicode in the progress bar
250
251       --no-color
252              Don't use coloring in the progress bar
253              or status messages
254
255       --no-duplicate-handling
256              Don't use duplicate handler for
257              installers
258              Duplicate installers from different
259              languages are handled separately
260
261       --no-subdirectories
262              Don't create subdirectories for extras,
263              patches and language packs
264
265       --curl-verbose
266              Set libcurl to verbose mode
267
268       --insecure
269              Don't verify authenticity of SSL
270              certificates
271
272       --timeout arg (=10)
273              Set timeout for connection
274              Maximum time in seconds that connection
275              phase is allowed to take
276
277       --retries arg (=3)
278              Set maximum number of retries on failed
279              download
280
281       --wait arg (=0)
282              Time to wait between requests
283              (milliseconds)
284
285       --subdir-installers arg
286              Set subdirectory for installers
287              Templates:
288              - %platform%
289              - %gamename%
290              - %gamename_firstletter%
291              - %dlcname%
292
293       --subdir-extras arg (=extras)
294              Set subdirectory for extras
295              Templates:
296              - %platform%
297              - %gamename%
298              - %gamename_firstletter%
299              - %dlcname%
300
301       --subdir-patches arg (=patches)
302              Set subdirectory for patches
303              Templates:
304              - %platform%
305              - %gamename%
306              - %gamename_firstletter%
307              - %dlcname%
308
309       --subdir-language-packs arg (=languagepacks)
310              Set subdirectory for language packs
311              Templates:
312              - %platform%
313              - %gamename%
314              - %gamename_firstletter%
315              - %dlcname%
316
317       --subdir-dlc arg (=dlc/%dlcname%)
318              Set subdirectory for dlc
319              Templates:
320              - %platform%
321              - %gamename%
322              - %gamename_firstletter%
323              - %dlcname%
324
325       --subdir-game arg (=%gamename%)
326              Set subdirectory for game
327              Templates:
328              - %platform%
329              - %gamename%
330              - %gamename_firstletter%
331              - %dlcname%
332
333       --use-cache
334              Use game details cache
335
336       --cache-valid arg (=2880)
337              Set how long cached game details are
338              valid (in minutes)
339              Default: 2880 minutes (48 hours)
340
341       --save-serials
342              Save serial numbers when downloading
343
344       --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
352       --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
363       --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
374       --automatic-xml-creation
375              Automatically create XML data after
376              download has completed
377
378       --save-changelogs
379              Save changelogs when downloading
380
381       --threads arg (=4)
382              Number of download threads
383
384       --info-threads arg (=4)
385              Number of threads for getting product
386              info
387
388       --use-dlc-list
389              Use DLC list specified with --dlc-list
390
391       --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
394       --progress-interval arg (=100)
395              Set interval for progress bar update
396              (milliseconds)
397              Value must be between 1 and 10000
398
399       --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
405       --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
412       --include-hidden-products
413              Include games that have been set hidden
414              in account page
415
416       --size-only
417              Don't check the hashes of the files
418              whose size matches that on the server
419
420       --verbosity arg (=0)
421              Set message verbosity level
422              -1 = Less verbose
423              0 = Default
424              1 = Verbose
425              2 = Debug
426
427   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
433       Example: 12345/2 selects build 2 for
434              product 12345
435
436       --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
441       Example: 12345/2 selects build 2 for
442              product 12345
443
444       --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
449       Example: 12345/2 selects build 2 for
450              product 12345
451
452       --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
457       Example: 12345/2 selects build 2 for
458              product 12345
459
460       --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
465       Example: 12345/2 selects build 2 for
466              product 12345
467
468       --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
473       Example: 12345/2 selects build 2 for
474              product 12345
475
476       --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
481       Example: 12345/2 selects build 2 for
482              product 12345
483
484       --galaxy-platform arg (=w)
485              Select  platform Windows = w|win|windows Mac = m|mac|osx Linux =
486              l|lin|linux
487
488       --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
509       --galaxy-arch arg (=x64)
510              Select  architecture  32-bit  =  32|x86|32bit|32-bit  64-bit   =
511              64|x64|64bit|64-bit
512
513       --galaxy-no-dependencies
514              Don't download dependencies during --galaxy-install
515
516       --subdir-galaxy-install arg (=%install_dir%)
517              Set subdirectory for galaxy install
518
519       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
526       "stripped" means that every character
527              that doesn't match the following list is removed: > alphanumeric
528              > space > - _ . ( ) [ ] { }
529
530       --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
536       Set priority by separating values with
537              "," Combine values by separating with "+"
538
539       --galaxy-delete-orphans
540              Delete orphaned files during --galaxy-install
541

BLACKLIST

543       Allows  user  to specify individual files that should not be downloaded
544       or mentioned as orphans.
545
546       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
553       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
561       # 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

PRIORITIES

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
572       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
578       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

AVAILABILITY

584       The  latest  version   of   this   distribution   is   available   from
585       https://github.com/Sude-/lgogdownloader
586

FILES

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
593
594       $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
599
600       $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
606
607       $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
614
615       $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
624
625       $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              }
648
649
650
651LGOGDownloader 3.11               April 2023                 LGOGDOWNLOADER(1)
Impressum