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 crate. You don't need to be a Steamworks partner to get installation directory locations from the Steamworks API.
This crate supports Windows, macOS and Linux.
Simply add to your Cargo.toml file:
[dependencies]
steamlocate = "0.*"To use steamid-ng with steamlocate, add this to your Cargo.toml file:
[dependencies]
steamid-ng = "1.*"
[dependencies.steamlocate]
version = "0.*"
features = ["steamid_ng"]All functions in this crate cache their results, meaning you can call them as many times as you like and they will always return the same reference.
If you need to get uncached results, simply instantiate a new SteamDir.
This crate supports steamid-ng and can automatically convert SteamApp::last_user to a SteamID for you.
To enable this support, use the steamid_ng Cargo.toml feature.
extern crate steamlocate;
use steamlocate::SteamDir;
match SteamDir::locate() {
Some(steamdir) => println!("{:#?}", steamdir),
None => panic!("Couldn't locate Steam on this computer!")
}SteamDir (
path: PathBuf: "C:\\Program Files (x86)\\Steam"
)This will locate Garry's Mod anywhere on the filesystem.
extern crate steamlocate;
use steamlocate::SteamDir;
let mut steamdir = SteamDir::locate().unwrap();
match steamdir.app(&4000) {
Some(app) => println!("{:#?}", app),
None => panic!("Couldn't locate Garry's Mod on this computer!")
}SteamApp (
appid: u32: 4000,
path: PathBuf: "C:\\Program Files (x86)\\steamapps\\common\\GarrysMod",
vdf: <steamy_vdf::Table>,
name: Some(String: "Garry's Mod"),
last_user: Some(u64: 76561198040894045)
)extern crate steamlocate;
use steamlocate::{SteamDir, SteamApp};
use std::collections::HashMap;
let mut steamdir = SteamDir::locate().unwrap();
let apps: &HashMap<u32, Option<SteamApp>> = steamdir.apps();
println!("{:#?}", apps);{
4000: SteamApp (
appid: u32: 4000,
path: PathBuf: "C:\\Program Files (x86)\\steamapps\\common\\GarrysMod",
vdf: <steamy_vdf::Table>,
name: Some(String: "Garry's Mod"),
last_user: Some(u64: 76561198040894045)
)
...
}extern crate steamlocate;
use steamlocate::{SteamDir, LibraryFolders};
use std::{vec, path::PathBuf};
let mut steamdir: SteamDir = SteamDir::locate().unwrap();
let libraryfolders: &LibraryFolders = steamdir.libraryfolders();
let paths: &Vec<PathBuf> = &libraryfolders.paths;
println!("{:#?}", paths);{
"C:\\Program Files (x86)\\Steam\\steamapps",
"D:\\Steam\\steamapps",
"E:\\Steam\\steamapps",
"F:\\Steam\\steamapps",
...
}Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the MIT license, shall be dual licensed as above, without any additional terms or conditions.