Installation
Tout d'abord, vous aurez besoin d'installer Python (v2.7 minimum).
Une fois installé, il faudra également installer quelques dépendances : requests, html5lib et pyOpenSSL. Sous linux, ceux-ci peuvent être disponible sous forme de packages (par ex python3-openssl, python3-requests et python3-html5lib). Sous windows, il faudra surement passer par l'outil pip, fourni dans l'installation, et lancer une commande du genre "pip install pyOpenSSL" (idem avec html5lib et requests).
Une fois installé, téléchargez le script de gogrepoc et enregistrez-le dans le dossier où vous souhaitez stocker votre bilibothèque GOG.
Enfin, ouvrez une ligne de commande sur le dossier du script et lancez la commande suivante (remplacez la commande python3 par celle correspondante a votre installation) :
python3 gogrepoc.py login
Saisissez votre login/mot de passe GOG afin d'enregistrer les informations d'authentification nécessaires pour la suite.
Utilisation
gogrepoc propose plusieurs commandes :
- update : permet de vérifier et mettre à jour les infos concernant vos jeux, dans un fichier manifest . A faire obligatoirement.
- download : permet de télécharger votre bibliothèque GOG, selon certains critères
- verify : permet de vérifier l'intégrité des fichiers téléchargés
- import : permet d'importer une bibliothèque existante depuis un autre dossier
- backup : permet de créer une copie de votre bibliothèque
- clean : permet de mettre tous les fichiers non-présent dans votre fichier manifest dans un dossier "!orphaned". Utile pour nettoyer votre bibliothèque.
- trash : supprime le contenu du dossier "!orphaned".
Pour obtenir l'aide sur une commande, il suffit de faire :
python3 gogrepoc.py <commande> -h
Voici donc un exemple de script que j'utilise afin de faciliter la mise à jour de ma bibliothèque GOG locale :
python3 gogrepo.py update -os windows -lang en fr -skiphidden python3 gogrepo.py download -skipextras -skipfiles patch* python3 gogrepo.py clean . python3 gogrepo.py trash .
La première ligne permet de récupérer les informations des jeux en se limitant aux versions Windows, en anglais et français, et en ne prenant pas en compte les jeux cachés. La seconde ligne permet de lancer le téléchargement en se basant sur les informations issues du manifest (obtenu via update) et en excluant les fichiers extra (soundtrack, wallpapers, etc...) et les éventuels patchs. La troisième permet de déplacer les précédentes versions des jeux non présentes dans le manifest dans le dossier !orphaned. La dernière supprimer le contenu du dossier !orphaned.
Il me suffit donc de lancer ce script pour mettre a jour rapidement ma bibliothèque GOG locale. A noter que si vous masquez des jeux sur votre bibliothèque GOG, il faudra peut-être rajouter le paramètre -full a la commande update afin que la modification soit prise en compte.