Cover Up is a CLI application meant to aid with downloading missing covers, banners, and icons in Lutris. This is a common issue, because Lutris only fetches assets from IGDB (Internet Game Database).
Warning
I haven't implemented an undo feature yet, so if you run the program, it's only possible to undo by manually removing all assets.
Important
If a banner can't be found, Cover Up tries to put the game's logo on top of a hero. If there's no logo, the hero will be used as a banner.
Note
This project is a WIP and currently fetches assets from SteamGridDB only. Not all games on SteamGridDB have assets and there is no fallback option yet. However, it is possible to upload assets to SteamGridDB.
- Download
lutris-coverupfrom releases - Make the binary executable:
$ chmod +x lutris-coverup
# mv lutris-coverup /usr/local/bin
$ lutris-coverup -k <STEAMGRIDDB_API_KEY>
-h, --help Show this message and exit.
-v, --version Show the version and exit.
-k, --api-key TEXT SteamGridDB API key [required]
-r, --resize [none|stretch|crop]
Lutris uses a different aspect ratio than SteamGridDB.
Specify whether the new assets should be stretched or
cropped to fill [default: STRETCH]
-t, --target [all|covers|banners|icons]
The assets to be updated [default: ALL]
-l, --lutris-path DIRECTORY Path to the directory containing coverart, banners, and
pga.db [default: ~/.local/share/lutris]
-i, --icon-path DIRECTORY Path to the directory containing the game icons [default:
~/.local/share/icons/hicolor/128x128/apps]
You need to pass a SteamGridDB API key for this application to work.
- Sign in to SteamGridDB with your Steam account
- Go to Preferences > API
- Copy your API key
Lutris fetches its assets from IGDB and resizes them. Covers and banners fetched from SteamGridDB are not the same aspect ratio, so the covers are a bit more narrow. The --resize flag, described in Usage, allows you to specify whether the assets should be stretched, cropped, or left as is after resizing them.
Icons are all square 1:1 images.
| Covers | Covers | Banners | Banners | |
|---|---|---|---|---|
| IGDB | 3:4 | 600x800 | 8:3 | ? |
| Lutris | 3:4 | 264x352 | 8:3 | 184x69 |
| SteamGridDB | 2:3 | 600x900 | 96:31 | 1920x620 |
Use this if you only want to update covers, banners, or, icons.
Lutris stores game covers in coverart, banners in banners, and all your games' information in an SQLite database called pga.db.
Lutris stores game icons in a separate directory icons/hicolor/128x128/apps.
- @Deytron for the foundation in Lutris Cover Art Downloader
- SteamGridDB for the assets