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

NAME

6       LGOGDownloader - manual page for LGOGDownloader 3.8
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.8 Options:
21
22       -h [ --help ]
23              Print help message
24
25       --version
26              Print version information
27
28       --login
29              Login
30
31       --list List games
32
33       --list-details
34              List games with detailed info
35
36       --download
37              Download
38
39       --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
44       --game arg
45              Set  regular  expression  filter  for download/list/repair (Perl
46              syntax)
47
48       --create-xml [=arg(=automatic)]
49              Create GOG XML for file "automatic" to enable automatic XML cre‐
50              ation
51
52       --notifications
53              Check notifications
54
55       --updated
56              List/download only games with update flag set
57
58       --clear-update-flags
59              Clear update notification flags
60
61       --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
68       --status
69              Show status of files
70
71       Output format:
72              statuscode gamename filename filesize filehash
73
74       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
78       --save-config
79              Create config file with current
80              settings
81
82       --reset-config
83              Reset config settings to default
84
85       --report [=arg(=lgogdownloader-report.log)]
86              Save report of downloaded/repaired
87              files to specified file
88              Default filename: lgogdownloader-report
89              .log
90
91       --update-cache
92              Update game details cache
93
94       --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
107       --download-file arg
108              Download files using fileid
109
110       Format:
111              "gamename/fileid"
112              or: "gogdownloader://gamename/fileid"
113
114       Multiple files:
115              "gamename1/fileid1,gamename2/fileid2"
116              or: "gogdownloader://gamename1/fileid1,
117              gamename2/fileid2"
118
119       This option ignores all subdir options.
120              The files are downloaded to directory
121              specified with --directory option.
122
123       -o [ --output-file ] arg
124              Set filename of file downloaded with
125              --download-file.
126
127       --wishlist
128              Show wishlist
129
130       --cacert arg
131              Path to CA certificate bundle in PEM
132              format
133
134       --respect-umask
135              Do not adjust permissions of sensitive
136              files
137
138       --user-agent arg (=LGOGDownloader/3.8 (Linux x86_64))
139              Set user agent
140
141       --enable-login-gui
142              Enable login GUI when encountering
143              reCAPTCHA on login form
144
145       --directory arg (=.)
146              Set download directory
147
148       --limit-rate arg (=0)
149              Limit download rate to value in kB
150              0 = unlimited
151
152       --xml-directory arg
153              Set directory for GOG XML files
154
155       --chunk-size arg (=10)
156              Chunk size (in MB) when creating XML
157
158       --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
165       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
171       --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
212       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
218       --no-remote-xml
219              Don't use remote XML for repair
220
221       --no-unicode
222              Don't use Unicode in the progress bar
223
224       --no-color
225              Don't use coloring in the progress bar
226              or status messages
227
228       --no-duplicate-handling
229              Don't use duplicate handler for
230              installers
231              Duplicate installers from different
232              languages are handled separately
233
234       --no-subdirectories
235              Don't create subdirectories for extras,
236              patches and language packs
237
238       --verbose
239              Print lots of information
240
241       --curl-verbose
242              Set libcurl to verbose mode
243
244       --insecure
245              Don't verify authenticity of SSL
246              certificates
247
248       --timeout arg (=10)
249              Set timeout for connection
250              Maximum time in seconds that connection
251              phase is allowed to take
252
253       --retries arg (=3)
254              Set maximum number of retries on failed
255              download
256
257       --wait arg (=0)
258              Time to wait between requests
259              (milliseconds)
260
261       --subdir-installers arg
262              Set subdirectory for installers
263              Templates:
264              - %platform%
265              - %gamename%
266              - %gamename_firstletter%
267              - %dlcname%
268
269       --subdir-extras arg (=extras)
270              Set subdirectory for extras
271              Templates:
272              - %platform%
273              - %gamename%
274              - %gamename_firstletter%
275              - %dlcname%
276
277       --subdir-patches arg (=patches)
278              Set subdirectory for patches
279              Templates:
280              - %platform%
281              - %gamename%
282              - %gamename_firstletter%
283              - %dlcname%
284
285       --subdir-language-packs arg (=languagepacks)
286              Set subdirectory for language packs
287              Templates:
288              - %platform%
289              - %gamename%
290              - %gamename_firstletter%
291              - %dlcname%
292
293       --subdir-dlc arg (=dlc/%dlcname%)
294              Set subdirectory for dlc
295              Templates:
296              - %platform%
297              - %gamename%
298              - %gamename_firstletter%
299              - %dlcname%
300
301       --subdir-game arg (=%gamename%)
302              Set subdirectory for game
303              Templates:
304              - %platform%
305              - %gamename%
306              - %gamename_firstletter%
307              - %dlcname%
308
309       --use-cache
310              Use game details cache
311
312       --cache-valid arg (=2880)
313              Set how long cached game details are
314              valid (in minutes)
315              Default: 2880 minutes (48 hours)
316
317       --save-serials
318              Save serial numbers when downloading
319
320       --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
328       --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
339       --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
350       --automatic-xml-creation
351              Automatically create XML data after
352              download has completed
353
354       --save-changelogs
355              Save changelogs when downloading
356
357       --threads arg (=4)
358              Number of download threads
359
360       --info-threads arg (=4)
361              Number of threads for getting product
362              info
363
364       --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
367       --progress-interval arg (=100)
368              Set interval for progress bar update
369              (milliseconds)
370              Value must be between 1 and 10000
371
372       --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
378       --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
385       --include-hidden-products
386              Include games that have been set hidden
387              in account page
388
389   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
395       Example: 12345/2 selects build 2 for
396              product 12345
397
398       --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
403       Example: 12345/2 selects build 2 for
404              product 12345
405
406       --galaxy-platform arg (=w)
407              Select platform Windows = w|win|windows Mac = m|mac|osx Linux  =
408              l|lin|linux
409
410       --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
431       --galaxy-arch arg (=x64)
432              Select   architecture  32-bit  =  32|x86|32bit|32-bit  64-bit  =
433              64|x64|64bit|64-bit
434
435       --galaxy-no-dependencies
436              Don't download dependencies during --galaxy-install
437
438       --subdir-galaxy-install arg (=%install_dir%)
439              Set subdirectory for galaxy install
440
441       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
448       "stripped" means that every character
449              that doesn't match the following list is removed: > alphanumeric
450              > space > - _ . ( ) [ ] { }
451
452       --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
456       Set priority by separating values with
457              "," Combine values by separating with "+"
458
459       --galaxy-delete-orphans
460              Delete orphaned files during --galaxy-install
461

BLACKLIST

463       Allows user to specify individual files that should not  be  downloaded
464       or mentioned as orphans.
465
466       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
473       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
481       #  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

PRIORITIES

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
492       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
498       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

AVAILABILITY

504       The   latest   version   of   this   distribution   is  available  from
505       https://github.com/Sude-/lgogdownloader
506

FILES

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
513
514       $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
519
520       $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
526
527       $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
534
535       $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
544
545       $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              }
568
569
570
571LGOGDownloader 3.8              September 2021               LGOGDOWNLOADER(1)
Impressum