Skip to content

Custom Game Artwork

Eamonn Rea edited this page Mar 15, 2023 · 3 revisions

SteamTinkerLaunch v12.12 and above allow you to set custom locally-stored artwork for games from a GUI and from the command line. It allows you to set custom artwork for a game by specifying absolute file paths, and SteamTinkerLaunch will manage moving these into the Steam Grid directory with the appropriate name. You can specify if you want SteamTinkerLaunch to copy, symlink or move these files.

image

Overview

SteamTinkerLaunch allows you to set the following kinds of game grid artwork. You can find reference images and information about Valve's recommended sizing and such on the Steamworks Library Assets page.

  • Hero artwork - This is the banner on the game screen in your library, above the play button. Valve recommend a resolution of 3840x1240.
  • Logo artwork - This logo displays overtop the Hero. Valve recommend a resolution of 1280x720, but any 16:9 aspect ratio should work.
  • Boxart - This is the rectangular art which is displayed in your library view, akin to a physical game's boxart. Valve recommend a resolution of 600x900, but higher should work as well.
  • Tenfoot - A small banner which is displayed for your most recently played game. Valve recommend a resolution of 600x350.

Not all artwork is mandatory, you only need to select or input the paths to the artwork that you want to set. This means if you want to you only have to specify the logo, or boxart. Blank fields will simply be ignored.

Usage

GUI

You can open the GUI for setting the artwork with steamtinkerlaunch setgameart <app_id> and no other arguments. From the GUI you can click on the file picker which will allow you to browse to your images.

This is a standard GTK filepicker, meaning you can press Ctrl+L to bring up a textbox where you can manually enter a path to your file. You can also drag files into this dialog which will open the folder where the file is located, and highlight that file.

Similarly, you can also drag the images you wish to use onto the filepicker button itself, negating the need to browse to the file at all.

Command Line

It is also possible to use this functionality from the command line. The arguments and shorthands used are detailed on the steamtinkerlaunch help page. By default, if no flag on how to set the art is provided, it will default to --copy.

An example command may look something like this: steamtinkerlaunch sga 206440 --logo="/home/gaben/Pictures/GameGrids/206440/logo.png"

It is a good idea to surround your file paths with quotes, especially if they contain spaces!

Notes

AppIDs

SteamTinkerLaunch will not validate the AppID to ensure it is a valid game. This is for performance reasons as it would be costly to search for the installed/owned AppIDs. It also offers flexibility as if you know the AppID ahead of time (e.g. for a Non-Steam game) then you don't need to worry about any validation messages. Just make sure you actually enter the correct AppID.

There are various ways to find out the AppID for a game:

  • The store page URL
  • The game files directory's steam_appid.txt
  • SteamTinkerLaunch's built-in command: steamtinkerlaunch gi <game name>
  • Within Steam under a game's Properties -> Updates

Restart Steam

You will have to restart Steam for artwork changes to take effect, as Steam will usually not refresh grids while it is open. However you can still set artwork while Steam is open, it just won't show up until a restart in the vast majority of instances.

File Types

Steam supports most standard image formats, including PNG, JPG and in some cases some animated image formats. Some games offer custom animated grids in their local files (e.g., Yakuza 0). You can of course set these file types using this SteamTinkerLaunch feature, as all this functionality does is copy files and give them an appropriate name while preserving their original extension.

Online Grids

It is possible to select online grids for a game automatically from SteamGridDB, but it is separate from this feature which is specific to adding locally-saved artwork. See the SteamTinkerLaunch SteamGridDB wiki page for usage details.

Clone this wiki locally