#api-bindings #game

game-scanner

Game Scanner for any launcher and OS

11 stable releases

1.1.4 Apr 9, 2022
1.1.2 Mar 6, 2022
1.1.0 Nov 7, 2021
1.0.6 Jun 3, 2021
1.0.4 May 31, 2021

#174 in Games

Download history 13/week @ 2024-07-27 5/week @ 2024-09-21

260 downloads per month

MIT license

105KB
3K SLoC

Game Scanner

GitHub Workflow Status Crates.io npm (scoped)

Game Scanner for any launcher and OS.

Data structure

You can find the Rust data structure in prelude.rs, and the Javascript data structure in index.d.ts.

Launchers Support

OS

Launcher Multi-directories¹ Windows Linux MacOS
Amazon
Blizzard
Epic Games
GOG
Origin
Riot Games
Steam
Ubisoft

[1]: Multi-directories: is different game install locations (e.g., folders, and drivers).

Game Commands support

Launcher Install Launch Uninstall
Amazon
Blizzard
Epic Games
GOG
Origin
Riot Games
Steam
Ubisoft

Game State support

Launcher Installed Needs Update Downloading Total Bytes Received Bytes
Amazon
Blizzard
Epic Games
GOG
Origin
Riot Games
Steam
Ubisoft

Operations

Launcher List Games Find Game¹ Get launcher executable
Amazon
Blizzard
Epic Games
GOG
Origin
Riot Games
Steam
Ubisoft

[1]: Find Game: you can find for a specific game passing only the id.

Management

Launcher Launch Get Processes Close
Amazon
Blizzard
Epic Games
GOG
Origin
Riot Games
Steam
Ubisoft

[1]: Game Processes: return a list with all Id or PID of processes from a specific game.

Requirements

  • Rust
    • cargo >= v1.49.0
    • rustup >= v1.23.1
    • rustc >= v1.49.0

NodeJS Binding

Usage

List games

const game_scanner = require("@equal-games/game-scanner");

const games = game_scanner.steam.games();

// [{
//     _type: 'steam',
//     id: '945360',
//     name: 'Among Us',
//     path: 'C:\\Program Files (x86)\\Steam\\steamapps\\common\\Among Us',
//     commands: { install: [Array], launch: [Array], uninstall: [Array] },
//     state: {
//         installed: true,
//         needs_update: true,
//         downloading: true,
//         total_bytes: 39626416,
//         received_bytes: 0
//     }
// }]

Find game

const game_scanner = require("@equal-games/game-scanner");

const games = game_scanner.steam.find('945360');

// {
//     _type: 'steam',
//     id: '945360',
//     name: 'Among Us',
//     path: 'C:\\Program Files (x86)\\Steam\\steamapps\\common\\Among Us',
//     commands: { install: [Array], launch: [Array], uninstall: [Array] },
//     state: {
//         installed: true,
//         needs_update: true,
//         downloading: true,
//         total_bytes: 39626416,
//         received_bytes: 0
//     }
// }

Install/Uninstall game

const game_scanner = require("@equal-games/game-scanner");

const game = game_scanner.steam.games().find(game => !game.state.installed);

game_scanner.mananger.install_game(game);

game_scanner.mananger.uninstall_game(game);

Launch/Close game

const game_scanner = require("@equal-games/game-scanner");

const game = game_scanner.steam.games().find(game => game.state.installed);

game_scanner.mananger.launch_game(game);
// After 30 seconds
game_scanner.mananger.close_game(game);

Requirements

  • Visual Studio >= 2019
    • Desktop Development with C++
      • MSVC >= v142
      • Windows 10 SDK >= 10.0.18362.0
  • Node
    • node >= 12.20.0
    • npm >= 6.14.8
  • windows-build-tools >= 5.2.2
    • npm config set msvs_version 2019
    • npm config set python python2.7

Resources

Code of Conduct

If you are interested in contributing to the project, please take a look at the Code of Conduct.

License

This project is licensed under the terms of the MIT license.

Dependencies

~32MB
~605K SLoC