#steam #download #com #content #utility #command-line-tool #steamgriddb

bin+lib steamgriddb-dl

A CLI utility for downloading content from www.steamgriddb.com

3 releases (stable)

1.0.1 Jan 5, 2025
0.9.0 Jan 2, 2025

#1383 in Command line utilities

Download history 345/week @ 2025-01-01 36/week @ 2025-01-08

381 downloads per month

MIT license

20KB
455 lines

SteamGridDB DL

Using this tool for dummies

To be written. Will link to its own document.

Installation

If you have Cargo installed, all you need to do is run

cargo install steamgriddb-dl

After which the tool can be run using the following command in your shell:

steamgriddb-dl <id> <options>

Alternatively, the binary can be downloaded from the releases page, after which you can easily run it from the downloaded directory, or after adding it to a folder in your $PATH.

Usage

steamgriddb-dl <id> <options>

Where <id> is the id-number for a collection on SteamGridDB (ie. https://www.steamgriddb.com/collection/[number]). This does not parse the full URL, so only the number will work.

Option Purpose
-n Dry run. Runs the tool as normal— printing all of the files that are to be saved and their directories, but without actually saving them.
--directory=<dir> In some cases the tool cannot find your Steam installation's personal configuration directory, or you may want to save the images in a collection elsewhere. This option lets the user set an override directory.
-h Prints help information.

Build

At the moment, no special actions have to be taken to build the binaries. If you have Cargo installed, you can simply use

cargo build

or for release binaries

cargo build -r

...to build the executable yourself. See also the Rust documentation.

Dependencies

~5MB
~87K SLoC