NAME¶

LGOGDownloader - downloader for GOG.com games and other files

SYNOPSIS¶

lgogdownloader [ OPTION]...

DESCRIPTION¶

An open-source GOG.com downloader for Linux users which uses the same API as the official GOGDownloader. LGOGDownloader can download purchased games, query GOG.com to see if game files have changed, as well as downloading extras such as artwork and manuals. It is capable of downloading language-specific installers for games where they exist. These games are currently offered only for the Microsoft Windows® and Apple OS X® operating systems. To play these games under GNU/Linux will require a compatibility layer such as Wine. Usage of such a program is outside the scope of this document. LGOGDownloader 2.19 Options:

-h [ --help ]

Print help message

--version

Print version information

--login

Login

--list

List games

--list-details

List games with detailed info

--download

Download

--repair

Repair downloaded files Use --repair --download to redownload files when filesizes don't match (possibly different version). Redownload will rename the old file (appends .old to filename)

--game arg

Set regular expression filter for download/list/repair (Perl syntax) Aliases: "all", "free"

--create-xml arg

Create GOG XML for file "automatic" to enable automatic XML creation

--update-check

Check for update notifications

--check-orphans arg

Check for orphaned files (files found
on local filesystem that are not found
on GOG servers). Sets regular
expression filter (Perl syntax) for
files to check. If no argument is given
then the regex defaults to
'.*\.(zip|exe|bin|dmg|old|deb|tar\.gz|p
kg)$'
    

--status

Show status of files
    

Output format:

statuscode gamename filename filesize
filehash
    

Status codes:

OK - File is OK
ND - File is not downloaded
MD5 - MD5 mismatch, different version
    

--save-config

Create config file with current
settings
    

--reset-config

Reset config settings to default
    

--report [=arg(=lgogdownloader-report.log)]

Save report of downloaded/repaired
files to specified file
Default filename: lgogdownloader-report
.log
    

--no-cover

Don't download cover images. Overrides
--cover option.
Useful for making exceptions when
"cover" is set to true in config file.
    

--update-cache

Update game details cache
    

--directory arg (=.)

Set download directory
    

--limit-rate arg (=0)

Limit download rate to value in kB
0 = unlimited
    

--xml-directory arg

Set directory for GOG XML files
    

--chunk-size arg (=10)

Chunk size (in MB) when creating XML
    

--platform arg (=5)

Select which installers are downloaded
1 = Windows
2 = Mac
4 = Linux
7 = All
    

--language arg (=1)

Select which language installers are
downloaded
1 = English
2 = German
4 = French
8 = Polish
16 = Russian
32 = Chinese
64 = Czech
128 = Spanish
256 = Hungarian
512 = Italian
1024 = Japanese
2048 = Turkish
4096 = Portuguese
8192 = Korean
16384 = Dutch
32768 = Swedish
65536 = Norwegian
131072 = Danish
262144 = Finnish
Add the values to download multiple
languages
All = 524287
French + Polish = 4+8 = 12
    

--no-installers

Don't download/list/repair installers
    

--no-extras

Don't download/list/repair extras

--no-patches

Don't download/list/repair patches

--no-language-packs

Don't download/list/repair language packs

--no-dlc

Don't download/list/repair DLCs

--no-deb

Don't download/list/repair deb packages

--no-targz

Don't download/list/repair tarballs

--cover

Download cover images

--no-remote-xml

Don't use remote XML for repair

--no-unicode

Don't use Unicode in the progress bar

--no-color

Don't use coloring in the progress bar

--no-duplicate-handling

Don't use duplicate handler for installers Duplicate installers from different languages are handled separately

--no-subdirectories

Don't create subdirectories for extras, patches and language packs

--verbose

Print lots of information

--insecure

Don't verify authenticity of SSL certificates

--timeout arg (=10)

Set timeout for connection Maximum time in seconds that connection phase is allowed to take

--retries arg (=3)

Set maximum number of retries on failed download

--wait arg (=0)

Time to wait between requests (milliseconds)

--cover-list arg (=https://sites.google.com/site/gogdownloader/covers.xml)

Set URL for cover list

--subdir-installers arg

Set subdirectory for extras Templates: - %platform% - %gamename% - %dlcname%

--subdir-extras arg (=extras)

Set subdirectory for extras Templates: - %platform% - %gamename% - %dlcname%

--subdir-patches arg (=patches)

Set subdirectory for patches Templates: - %platform% - %gamename% - %dlcname%

--subdir-language-packs arg (=languagepacks)

Set subdirectory for language packs Templates: - %platform% - %gamename% - %dlcname%

--subdir-dlc arg (=dlc/%dlcname%)

Set subdirectory for dlc Templates: - %platform% - %gamename% - %dlcname%

--subdir-game arg (=%gamename%)

Set subdirectory for game Templates: - %platform% - %gamename% - %dlcname%

--use-cache

Use game details cache

--cache-valid arg (=2880)

Set how long cached game details are valid (in minutes) Default: 2880 minutes (48 hours)

BLACKLIST¶

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

AVAILABILITY¶

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

FILES¶

$XDG_CONFIG_HOME/lgogdownloader/

Storage for configuration files and cookies

 

If $XDG_CONFIG_HOME is not set, it will use $HOME/.config/lgogdownloader/.

$XDG_CACHE_HOME/lgogdownloader/xml/

Storage for XML files

 

If $XDG_CACHE_HOME is not set, it will use $HOME/.cache/lgogdownloader/xml/.

$XDG_CONFIG_HOME/lgogdownloader/blacklist.txt

Allows user to specify individual files that should not be downloaded or mentioned as orphans.

 

It doesn't have to exist, but if it does exist, it must be readable to lgogdownloader.

$XDG_CONFIG_HOME/lgogdownloader/gamename.conf

JSON formatted file. Sets game specific settings for gamename.

 

Allowed settings are language, platform and dlc.

 

The dlc option is limited to disabling DLC for specific game. It can't enable DLC listing/downloading if --no-dlc option is used.

 

Must be in the following format:

 

{
"language" : <int>,
"platform" : <int>,
"dlc" : <bool>

 

}