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

NAME

6       LGOGDownloader - manual page for LGOGDownloader 3.7
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.7 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.7 (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              All = all
210
211       Set priority by separating values with
212              ","
213              Combine values by separating with "+"
214              Example: German if available otherwise
215              English and French: de,en+fr
216
217       --no-remote-xml
218              Don't use remote XML for repair
219
220       --no-unicode
221              Don't use Unicode in the progress bar
222
223       --no-color
224              Don't use coloring in the progress bar
225              or status messages
226
227       --no-duplicate-handling
228              Don't use duplicate handler for
229              installers
230              Duplicate installers from different
231              languages are handled separately
232
233       --no-subdirectories
234              Don't create subdirectories for extras,
235              patches and language packs
236
237       --verbose
238              Print lots of information
239
240       --curl-verbose
241              Set libcurl to verbose mode
242
243       --insecure
244              Don't verify authenticity of SSL
245              certificates
246
247       --timeout arg (=10)
248              Set timeout for connection
249              Maximum time in seconds that connection
250              phase is allowed to take
251
252       --retries arg (=3)
253              Set maximum number of retries on failed
254              download
255
256       --wait arg (=0)
257              Time to wait between requests
258              (milliseconds)
259
260       --subdir-installers arg
261              Set subdirectory for installers
262              Templates:
263              - %platform%
264              - %gamename%
265              - %dlcname%
266
267       --subdir-extras arg (=extras)
268              Set subdirectory for extras
269              Templates:
270              - %platform%
271              - %gamename%
272              - %dlcname%
273
274       --subdir-patches arg (=patches)
275              Set subdirectory for patches
276              Templates:
277              - %platform%
278              - %gamename%
279              - %dlcname%
280
281       --subdir-language-packs arg (=languagepacks)
282              Set subdirectory for language packs
283              Templates:
284              - %platform%
285              - %gamename%
286              - %dlcname%
287
288       --subdir-dlc arg (=dlc/%dlcname%)
289              Set subdirectory for dlc
290              Templates:
291              - %platform%
292              - %gamename%
293              - %dlcname%
294
295       --subdir-game arg (=%gamename%)
296              Set subdirectory for game
297              Templates:
298              - %platform%
299              - %gamename%
300              - %dlcname%
301
302       --use-cache
303              Use game details cache
304
305       --cache-valid arg (=2880)
306              Set how long cached game details are
307              valid (in minutes)
308              Default: 2880 minutes (48 hours)
309
310       --save-serials
311              Save serial numbers when downloading
312
313       --ignore-dlc-count [=arg(=.*)]
314              Set regular expression filter for games
315              to ignore DLC count information
316              Ignoring DLC count information helps in
317              situations where the account page
318              doesn't provide accurate information
319              about DLCs
320
321       --include arg (=all)
322              Select what to download/list/repair
323              Installers = i|installers
324              Extras = e|extras
325              Patches = p|patches
326              Language packs = l|languagepacks|langpa
327              cks
328              DLCs = d|dlc|dlcs
329              Separate with "," to use multiple
330              values
331
332       --exclude arg
333              Select what not to download/list/repair
334              Installers = i|installers
335              Extras = e|extras
336              Patches = p|patches
337              Language packs = l|languagepacks|langpa
338              cks
339              DLCs = d|dlc|dlcs
340              Separate with "," to use multiple
341              values
342
343       --automatic-xml-creation
344              Automatically create XML data after
345              download has completed
346
347       --save-changelogs
348              Save changelogs when downloading
349
350       --threads arg (=4)
351              Number of download threads
352
353       --info-threads arg (=4)
354              Number of threads for getting product
355              info
356
357       --dlc-list arg (=https://raw.githubusercontent.com/Sude-/lgogdownloader-lists/master/game_has_dlc.txt)
358              Set URL for list of games that have DLC
359
360       --progress-interval arg (=100)
361              Set interval for progress bar update
362              (milliseconds)
363              Value must be between 1 and 10000
364
365       --lowspeed-timeout arg (=30)
366              Set time in number seconds that the
367              transfer speed should be below the rate
368              set with --lowspeed-rate for it to
369              considered too slow and aborted
370
371       --lowspeed-rate arg (=200)
372              Set average transfer speed in bytes per
373              second that the transfer should be
374              below during time specified with
375              --lowspeed-timeout for it to be
376              considered too slow and aborted
377
378       --include-hidden-products
379              Include games that have been set hidden
380              in account page
381
382   Experimental:
383       --galaxy-install arg
384              Install game using product id [product_id/build_index] or  game‐
385              name  regex  [gamename/build_id] Build index is used to select a
386              build and defaults to 0 if not specified.
387
388       Example: 12345/2 selects build 2 for
389              product 12345
390
391       --galaxy-show-builds arg
392              Show game builds using product  id  [product_id/build_index]  or
393              gamename regex [gamename/build_id] Build index is used to select
394              a build and defaults to 0 if not specified.
395
396       Example: 12345/2 selects build 2 for
397              product 12345
398
399       --galaxy-platform arg (=w)
400              Select platform Windows = w|win|windows Mac = m|mac|osx Linux  =
401              l|lin|linux
402
403       --galaxy-language arg (=en)
404              Select  language  English  =  en|eng|english|en[_-]US  German  =
405              de|deu|ger|german|de[_-]DE French  =  fr|fra|fre|french|fr[_-]FR
406              Polish    =   pl|pol|polish|pl[_-]PL   Russian   =   ru|rus|rus‐
407              sian|ru[_-]RU Chinese = cn|zh|zho|chi|chinese|zh[_-]C N Czech  =
408              cz|cs|ces|cze|czech|cs[_-]CZ  Spanish  = es|spa|spanish|es[_-]ES
409              Hungarian =  hu|hun|hungarian|hu[_-]HU  Italian  =  it|ita|ital‐
410              ian|it[_-]IT  Japanese  =  jp|ja|jpn|japanese|ja[_-]JP Turkish =
411              tr|tur|turkish|tr[_-]TR Portuguese =  pt|por|portuguese|pt[_-]PT
412              Korean        =       ko|kor|korean|ko[_-]KR       Dutch       =
413              nl|nld|dut|dutch|nl[_-]NL Swedish = sv|swe|swedish|sv[_-]SE Nor‐
414              wegian    =   no|nor|norwegian|nb[_-]no|n   n[_-]NO   Danish   =
415              da|dan|danish|da[_-]DK Finnish = fi|fin|finnish|fi[_-]FI Brazil‐
416              ian  Portuguese = br|pt_br|pt-br|ptbr|brazilian_portugues e Slo‐
417              vak = sk|slk|slo|slovak|sk[_-]SK Bulgarian  =  bl|bg|bul|bulgar‐
418              ian|bg[_-]B  G  Ukrainian  =  uk|ukr|ukrainian|uk[_-]UA  Spanish
419              (Latin American) = es_mx|es-mx|esmx|es-419|spanish_latin_a meri‐
420              can    Arabic    =   ar|ara|arabic|ar[_-][A-Z]{2}   Romanian   =
421              ro|ron|rum|romanian|ro[_-][R M]O Hebrew = he|heb|hebrew|he[_-]IL
422
423       --galaxy-arch arg (=x64)
424              Select  architecture  32-bit  =  32|x86|32bit|32-bit  64-bit   =
425              64|x64|64bit|64-bit
426
427       --galaxy-no-dependencies
428              Don't download dependencies during --galaxy-install
429
430       --subdir-galaxy-install arg (=%install_dir%)
431              Set subdirectory for galaxy install
432
433       Templates:
434              -  %install_dir%  =  Installation  directory from Galaxy API re‐
435              sponse - %gamename% = Game name - %title% = Title of the game  -
436              %product_id% = Product id of the game - %install_dir_stripped% =
437              %install_dir% with some characters stripped - %title_stripped% =
438              %title% with some characters stripped
439
440       "stripped" means that every character
441              that doesn't match the following list is removed: > alphanumeric
442              > space > - _ . ( ) [ ] { }
443
444       --galaxy-cdn-priority arg (=edgecast,highwinds,gog_cdn)
445              Set priority for used CDNs Edgecast =  ec|edgecast  Highwinds  =
446              hw|highwinds|high_winds GOG = gog|gog_cdn
447
448       Set priority by separating values with
449              "," Combine values by separating with "+"
450
451       --galaxy-delete-orphans
452              Delete orphaned files during --galaxy-install
453

BLACKLIST

455       Allows  user  to specify individual files that should not be downloaded
456       or mentioned as orphans.
457
458       Each line in the file specifies one blacklist  expression,  except  for
459       empty  lines  and  lines starting with #.  First few characters specify
460       blacklist item type and flags.  So far, only regular  expression  (perl
461       variant)  are  supported, so each line must start with "Rp" characters.
462       After a space comes the  expression  itself.  Expressions  are  matched
463       against file path relative to what was specified as --directory.
464
465       Example black list
466       #  used  to store manually downloaded mods/patches/maps/, don't mention
467       it as orphans
468       Rp ^[^/]*/manual/.*
469       # included with every *divinity game, once is enough
470       Rp beyond_divinity/extras/bd_ladymageknight.zip
471       Rp divinity_2_developers_cut/extras/divinity_2_ladymageknight.zip
472
473       # extra 6GB is A LOT of space if you don't actually plan  to  mod  your
474       game
475       Rp the_witcher_2/extras/the_witcher_2_redkit.zip
476       Rp the_witcher_2/extras/extras_pack_3_hu_pl_ru_tr_zh_.zip
477       Rp the_witcher_2/extras/extras_pack_2_fr_it_jp_.zip
478

PRIORITIES

480       Separating  values  with  "," when using language and platform switches
481       enables a priority-based mode: only the  first  matching  one  will  be
482       downloaded.
483
484       For  example,  setting  language to fr+en means both French and English
485       will be downloaded (if available) for all games.  Setting  language  to
486       fr,en  means  that the French version (and only that one) will be down‐
487       loaded if available, and if not, the  English  version  will  be  down‐
488       loaded.
489
490       You're  allowed  to  "stack" codes in the priority string if needed. If
491       you set language to es+fr,en it means it'll download both Spanish  (es)
492       and  French  (fr)  versions if they are available, and the English (en)
493       one only if none of French and Spanish are available.
494

AVAILABILITY

496       The  latest  version   of   this   distribution   is   available   from
497       https://github.com/Sude-/lgogdownloader
498

FILES

500       $XDG_CONFIG_HOME/lgogdownloader/
501              Storage for configuration files and cookies
502              If  $XDG_CONFIG_HOME is not set, it will use $HOME/.config/lgog‐
503              downloader/.
504
505
506       $XDG_CACHE_HOME/lgogdownloader/xml/
507              Storage for XML files
508              If $XDG_CACHE_HOME is not set, it  will  use  $HOME/.cache/lgog‐
509              downloader/xml/.
510
511
512       $XDG_CONFIG_HOME/lgogdownloader/blacklist.txt
513              Allows user to specify individual files that should not be down‐
514              loaded.
515              It doesn't have to exist, but if it does exist, it must be read‐
516              able to lgogdownloader.
517
518
519       $XDG_CONFIG_HOME/lgogdownloader/ignorelist.txt
520              Allows  user to specify individual files that should not be men‐
521              tioned as orphans.  The file has the same format and interpreta‐
522              tion as a blacklist.
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/game_has_dlc.txt
528              Allows user to specify which games  have  dlc  and  should  have
529              their  DLC count information ignored. The file has the same for‐
530              mat and interpretation as a blacklist.
531              It doesn't have to exist, but if it does exist, it must be read‐
532              able to lgogdownloader.
533              If the file exists lgogdownloader uses it instead of list speci‐
534              fied with --dlc-list option
535
536
537       $XDG_CONFIG_HOME/lgogdownloader/gamespecific/gamename.conf
538              JSON formatted file. Sets game specific settings for gamename.
539              Allowed settings are language, platform,  dlc,  ignore-dlc-count
540              subdirectories,  directory, subdir-game, subdir-installers, sub‐
541              dir-extras, subdir-patches,  subdir-language-packs  and  subdir-
542              dlc.
543              The dlc option is limited to disabling DLC for specific game. It
544              can't enable DLC listing/downloading if --no-dlc option is used.
545              Must be in the following format:
546              {
547                  "language" : <string>,
548                  "platform" : <string>,
549                  "dlc" : <bool>,
550                  "ignore-dlc-count" : <bool>,
551                  "subdirectories" : <bool>,
552                  "directory" : <string>,
553                  "subdir-game" : <string>,
554                  "subdir-installers" : <string>,
555                  "subdir-extras" : <string>,
556                  "subdir-patches" : <string>,
557                  "subdir-language-packs" : <string>,
558                  "subdir-dlc" : <string>
559              }
560
561
562
563LGOGDownloader 3.7               January 2021                LGOGDOWNLOADER(1)
Impressum