Skip to content

Tormak9970/Steam-Art-Manager

Repository files navigation

SARM Badge Version Badge Downloads Badge License Badge

Steam Art Manager

A tool for setting the artwork of your Steam library.

Steam Art Manager's Main UI


Features

  • Easily edit the art for your games
  • View the art available on SteamGridDB for your games
  • Upload custom images
  • Import and Export your art to a zip file
  • Clean out unused grid images easily

Download and Install

To get the most recent release, head to the latest release and download the installer for your platform.

For Windows:

  • Downloading from GitHub: Download the steam-art-manager.msi file, and run it to install SARM.

For Linux:

  • AppImage:
    1. Download the appimage-installer.sh bash script.
    2. Right click it, go to permissions, and mark it as executable.
    3. Double click the script to install SARM.
  • Deb - Download the steam-art-manager.deb file, and run it to install SARM.
  • Flatpak - Coming Soon

How to use the app

When using Steam Art Manager, your workflow will typically be:

  • Open Steam Art Manager
  • Set your SteamGridDB api key (if you wish to browse images from SteamGridDB)
  • Wait for it to load your games
  • Go through your games, setting the art to whatever you choose
  • Save the changes

Setting up the API key

If you want to use or browse images from SteamGridDB you will need an api key (which is easy and free). To get one:

  1. Go to SteamGridDB, and sign in with Steam.
  2. Go to preferences, then API, and generate a new key if you don't already have one.
  3. Copy the api key.
  4. In Steam Art Manager, click the "Set API Key" button and paste the key in the text field and click "Save".

Managing your art

For custom artwork:

  • Click the "Upload Your Own!" button and select your file.

For SteamGridDB:

  • Browse through the images that show up when you select a game, and select one. It will be saved in memory until you apply your changes, so you can do as many as you want at once!

Exporting to a Zip

In order to export the zip, simply wait for your games to load, open the Tools window, and then click the "Export Zip" button, and choose a save location!

Importing from a Zip

To import a zip, open the Tools window and click the "Import Zip" button and select your zip file and just like that all of your game art should be updated!

Cleaning "Dead" Grids

Sometimes Steam randomly changes the appid of non steam games, which leads to having a lot of images that aren't in use. To remove these, open the Tools window and click the broom icon, and choose the settings you would like to use.

Update Game Tiles

Want to update the icons used in your start menu or desktop shortcuts? Open the Tools window and click the tiles icon.


Building the app

Please note: you may edit and distrubute this program as you see fit but you must retain the license and the copyright notice I included (feel free to mark your contributions as I have).

Setting Up the Enviroment

I used the Tauri framework (V2) for the program, so you will need to to setup your enviroment as specified here. Additionally, you need a Node.js installation, as well as bun, which can be found here.

Cloning the Program

The next step is to get a local copy of the repository. This can be done many ways, I recommend forking this repository and cloning that.

IMPORTANT:
If you make changes you are not allowed to redistribute the application with me labeled as the developer. Please remember to change the author information in the package.json and the related copyright information in src-tauri/tauri.config.json file. You should also change the copyright notice in src/windows/main/Main.svelte.

Installing Dependencies

Once you have cloned the repository and opened it in your preffered Editor/IDE (I recommend VSCode), you will need to install the program's dependencies. To do this, you will need to run two commands:
First:

bun i

Next:

cd src-tauri
cargo install

Running the Application

Now you are finally ready to get the app up and running! Assuming everything is set up correctly, all you need to do is run:

bun tauri dev

Building With Your Changes

Once you have made your edits and are ready to share it with the world, run the following command:

bun run tauri build

This will generate a .msi file in src-tauri/target/release/bundle/msi/app_name.msi. And there you go, you've got a distributeable installer!


Translations

Know a language other then English and want to help out?
Shoot me an email ([email protected])!


Acknowledgements

Big thanks to doZenn for the advice and info on stuff related to steamgriddb.
Other resources / references I used:


Licensing

Copyright Travis Lane (Tormak)