yamu 0.1.0

game library manager

yamu

A game library manager for geeks.

I needed a simple way to manage my game collection across multiple platforms (Steam, GOG, itch.io, etc). Existing tools covered different subsets of my needs, so I created yamu to fill in the gaps and provide an interface that allows for extremely fast categorization and searching of my game library. This tool is built to be highly extensible via plugins, so you can add support for new platforms or features as needed.

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"

Acknowledgements

• The beets project for inspiring the design of this tool.
• Yamu icon created by Ehtisham Abid