Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/williamvenner/steamlocate-rs
🎮 Rust Crate for locating Steam game installation directories (and Steam itself!)
https://github.com/williamvenner/steamlocate-rs
acf acf-format appmanifest cargo crate game games library module rust steam steamapp steamapps vdf vdf-format
Last synced: 5 days ago
JSON representation
🎮 Rust Crate for locating Steam game installation directories (and Steam itself!)
- Host: GitHub
- URL: https://github.com/williamvenner/steamlocate-rs
- Owner: WilliamVenner
- License: mit
- Created: 2021-02-20T21:19:16.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-11-14T02:52:46.000Z (2 months ago)
- Last Synced: 2025-01-11T13:08:20.745Z (12 days ago)
- Topics: acf, acf-format, appmanifest, cargo, crate, game, games, library, module, rust, steam, steamapp, steamapps, vdf, vdf-format
- Language: Rust
- Homepage:
- Size: 151 KB
- Stars: 41
- Watchers: 7
- Forks: 15
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://crates.io/crates/steamlocate)
[](https://docs.rs/steamlocate/)
[](https://github.com/WilliamVenner/steamlocate/blob/master/LICENSE)
[](https://github.com/WilliamVenner/steamlocate-rs/actions?query=workflow%3A%22ci%22)
# steamlocate
A crate which efficiently locates any Steam application on the filesystem,
and/or the Steam installation itself.
This crate is best used when you do not want to depend on the Steamworks API
for your program. In some cases the Steamworks API may be more appropriate to
use, in which case I recommend the fantastic
[steamworks](https://github.com/Thinkofname/steamworks-rs) crate. You don't
need to be a Steamworks partner to get installation directory locations from
the Steamworks API.
# Using steamlocate
Simply add `steamlocate` using
[`cargo`](https://doc.rust-lang.org/cargo/getting-started/installation.html).
```console
$ cargo add steamlocate
```
# Examples
## Locate the Steam installation and a specific game
The `SteamDir` is going to be your entrypoint into _most_ parts of the API.
After you locate it you can access related information.
```rust,ignore
let steam_dir = steamlocate::SteamDir::locate()?;
println!("Steam installation - {}", steam_dir.path().display());
// ^^ prints something like `Steam installation - C:\Program Files (x86)\Steam`
const GMOD_APP_ID: u32 = 4_000;
let (garrys_mod, _lib) = steam_dir
.find_app(GMOD_APP_ID)?
.expect("Of course we have G Mod");
assert_eq!(garrys_mod.name.as_ref().unwrap(), "Garry's Mod");
println!("{garrys_mod:#?}");
// ^^ prints something like vv
```
```rust,ignore
App {
app_id: 4_000,
install_dir: "GarrysMod",
name: Some("Garry's Mod"),
universe: Some(Public),
// much much more data
}
```
## Get an overview of all libraries and apps on the system
You can iterate over all of Steam's libraries from the steam dir. Then from each library you
can iterate over all of its apps.
```rust,ignore
let steam_dir = steamlocate::SteamDir::locate()?;
for library in steam_dir.libraries()? {
let library = library?;
println!("Library - {}", library.path().display());
for app in library.apps() {
let app = app?;
println!(" App {} - {:?}", app.app_id, app.name);
}
}
```
On my laptop this prints
```text
Library - /home/wintermute/.local/share/Steam
App 1628350 - Steam Linux Runtime 3.0 (sniper)
App 1493710 - Proton Experimental
App 4000 - Garry's Mod
Library - /home/wintermute/temp steam lib
App 391540 - Undertale
App 1714040 - Super Auto Pets
App 2348590 - Proton 8.0
```
## Contribution
Unless you explicitly state otherwise, any contribution intentionally
submitted for inclusion in the work by you, as defined in the MIT license,
shall be licensed as above, without any additional terms or conditions.