https://github.com/rolv-apneseth/lib_game_detector

A Rust library for detecting and parsing data about games currently installed on the system
https://github.com/rolv-apneseth/lib_game_detector

Last synced: about 1 month ago
JSON representation

A Rust library for detecting and parsing data about games currently installed on the system

• Host: GitHub
• URL: https://github.com/rolv-apneseth/lib_game_detector
• Owner: Rolv-Apneseth
• License: agpl-3.0
• Created: 2023-09-09T16:56:38.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-05-22T18:25:15.000Z (8 months ago)
• Last Synced: 2024-05-22T18:31:24.695Z (8 months ago)
• Language: Rust
• Size: 142 KB
• Stars: 6
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# lib_game_detector

[![Crate](https://img.shields.io/crates/v/lib_game_detector.svg)](https://crates.io/crates/lib_game_detector)

[![License](https://img.shields.io/badge/License-AGPLv3-green.svg)](https://github.com/Rolv-Apneseth/lib_game_detector/blob/main/LICENSE)

A Rust library for detecting and parsing data about games installed on the system. Currently

only supports Linux.

## Description

This is a Rust library intended to be used for programs which need information on currently

installed games, such as a games launcher, or mod manager. It can provide information such as

what games are installed across multiple launchers (such as Steam and Heroic Games Launcher),

where those games are installed, what command will launch them, and more.

## Quick start

Install with `cargo add lib_game_detector` or add the following to your `Cargo.toml`:

```toml

[dependencies]

lib_game_detector = "0.0.8"

```

## Usage

```rust

use lib_game_detector::{data::SupportedLaunchers, get_detector};

let detector = get_detector();

let detected_launchers = detector.get_detected_launchers();

let all_games = detector.get_all_detected_games();

let all_games_by_launcher = detector.get_all_detected_games_per_launcher();

let all_games_from_steam = detector.get_all_detected_games_from_specific_launcher(SupportedLaunchers::Steam);

```

## Examples

- See [rofi-games](https://github.com/Rolv-Apneseth/rofi-games) for an example which uses this library to find games and their box art to use for displaying in a launcher

- Check the [examples folder](https://github.com/Rolv-Apneseth/lib_game_detector/tree/main/examples)

## Currently supported game sources

- Steam

  - Non-Steam games added as shortcuts are also supported. Make sure to restart Steam at least once for new shortcuts to be detected

- Heroic Games Launcher (Legendary, Nile and GOG)

- Lutris

- Bottles

  - Only lists entries included in the Library

- Modded Minecraft (Prism Launcher, ATLauncher)

  - Titles are given as `Minecraft - {instance name}`

## License

[AGPL-3.0](./LICENSE)