Skip to main content

game library manager

Project description

yamu

A game library manager for geeks.

Yamu provides a simple way to manage game collections across multiple platforms (Steam, GOG, itch.io, etc). The tool is is extensible to support new platforms and features via plugins, and is composable with other UNIX tools and cli utilities.

Installation

Run pipx install yamu to install via pipx.

Quick start

Run yamu --help to see commands.

yamu import                           # Import games from configured platforms
yamu list platform:steam genre:action # List all Steam games in the action genre
yamu completion                       # Mark games as completed, interaactively
yamu fetchart                         # Fetch cover art games
yamu web                              # Open the web interface to view your library

For yamu import, configure plugins in ~/.config/yamu/config.yaml:

library: "~/.local/share/yamu/library.db"
plugins:
  - web 
  - steam
  - fetchart
  - igdb

steam:
  api_key: "your_key"
  steam_ids:
    - "steam64_id"

igdb:
  client_id: "your_client_id"
  client_secret: "your_client_secret"

Development

Create a virtual environment, install dev dependencies, and run tests:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
python -m pytest

Acknowledgements

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yamu-0.2.0.tar.gz (33.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yamu-0.2.0-py3-none-any.whl (43.2 kB view details)

Uploaded Python 3

File details

Details for the file yamu-0.2.0.tar.gz.

File metadata

  • Download URL: yamu-0.2.0.tar.gz
  • Upload date:
  • Size: 33.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for yamu-0.2.0.tar.gz
Algorithm Hash digest
SHA256 e02ac0a320dfedfb2600ea915339878178138ae763e8c8206c14e5cd9c59ff97
MD5 e917d0f34fe943f459539a2137e91f43
BLAKE2b-256 b5191f5ca4160ae2a8546e17f0b7d5fc67dc452617881b81cc30d074468aea80

See more details on using hashes here.

Provenance

The following attestation bundles were made for yamu-0.2.0.tar.gz:

Publisher: publish.yml on vagos/yamu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file yamu-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: yamu-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 43.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for yamu-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cb32f9527ba29e29c648cef964436e629498f4851f026c154e2d151ac1562e35
MD5 d5c731da3f5e93dcc8ae396579c54d5d
BLAKE2b-256 2755c67887541896243135e2868dd74bc3e92743e2235157962393032d6db6de

See more details on using hashes here.

Provenance

The following attestation bundles were made for yamu-0.2.0-py3-none-any.whl:

Publisher: publish.yml on vagos/yamu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page