Varstahl / GOG-Galaxy-HTML5-exporter

Uses the Galaxy 2 exported CSV to build a searchable HTML5 game library list.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GOG Galaxy 2.0 CSV export HTML5 formatter

This script helps users convert the CSV data exported through GOG Galaxy Export Script to a nice, searchable, customizable HTML5 format.

Screenshot

Features

  • Customizable HTML5, game partials, CSS and JS
  • Vanilla JS implementation
  • Live cover images resizing and spacing
  • Interactive offline search

Usage

Standard example

python csv_parser.py --image-list
wget -nc -P images -i ./imagelist.txt
python csv_parser.py --html5

CLI

File specification

  • -i Filename or --input Filename to specify the full path of the CSV file (defaults to ./gameDB.csv)
  • -l Filename or --list Filename to specify the full path of the output cover list URLs file (defaults to ./imagelist.txt)
  • -o Filename or --output Filename to specify the full path of the output HTML5 file (defaults to ./index.html)

Commands

  • --image-list creates a list containing the best matching URL for each game in the library
  • --html5 creates the HTML5 game library
    • --title custom title for the html page
    • --embed embeds .css and .js files instead of linking them

Note: while exporting, a few other actions are automatically performed:

  • delete unused images that have been replaced in the catalog
  • --html5: rename image files to remove the HTML5 attributes if necessary (i.e. renames image.webp?namespace=gamesdb into image.webp)

Customization

Each of the files in the template can be overridden by creating a new file ending in .custom.<extension>, such as style.custom.css or game.custom.html. This allows minimal and personalised changes only where needed.

HTML5 controls

You can open the controls by pressing CTRL+Space. From there you can search games, resize the game covers width, and the spacing between each other.

Requirements

  • Python 3
    • csv
    • natsort
    • unidecode
  • A CSV exported through GOG Galaxy Export Script
  • wget, if you want the images in an easy way

Known current limitations

  • Works better when the CSV is extracted with the -a command
  • The search results aren't weighted yet, and only consider titles

About

Uses the Galaxy 2 exported CSV to build a searchable HTML5 game library list.

License:MIT License


Languages

Language:Python 46.2%Language:SCSS 31.2%Language:JavaScript 20.5%Language:HTML 2.1%