Awesome
<!-- [![Translations](https://img.shields.io/badge/translations-help%20out-brightgreen?style=flat-square)](#translations) -->
Steam Art Manager
A tool for setting the artwork of your Steam library.
<br/>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:
- Download the
appimage-installer.sh
bash script. - Right click it, go to permissions, and mark it as executable.
- Double click the script to install SARM.
- Download the
- 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:
- Go to SteamGridDB, and sign in with Steam.
- Go to preferences, then API, and generate a new key if you don't already have one.
- Copy the api key.
- 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.
<br/>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). <br/>
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. <br/>
IMPORTANT:<br/>
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: <br/> First:<br/>
bun i
Next:<br/>
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:<br/>
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? <br/> Shoot me an email (Tormak9970@gmail.com)!
<br/>Acknowledgements
Big thanks to doZenn for the advice and info on stuff related to steamgriddb. <br/> Other resources / references I used:
<br/>Licensing
- This program is licensed under the GNU General Public License Version 3 <br/>
- The SARM Icon is based of the Fontawesome bucket icon, which is licensed under the Fontawesome Commercial License 2023 <br/>
- Additionally, if you use SARM for any projects, add it to a package manager, etc, please let me know! <br/>
- Lastly, please provide appropriate credit for code usage
Copyright Travis Lane (Tormak)