> ## Documentation Index
> Fetch the complete documentation index at: https://docs.questarr.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Gameyfin

> Show the games Questarr imports in a Gameyfin library.

# Gameyfin

[Gameyfin](https://github.com/gameyfin/gameyfin) is a web library for a PC game collection: it scans
folders, fetches metadata and lets people download games from a browser. It has no acquisition, so the
two apps complement each other: Questarr finds and imports games, Gameyfin presents them.

Questarr needs no integration code for this. The two share a folder and Gameyfin does the rest.

## Share the library folder

Questarr imports a game to `<library root>/<platform folder>/<game folder>` (for PC games the platform
folder is `PC`; see [Library Import](https://docs.questarr.app/LIBRARY_IMPORT.md)). Gameyfin treats every folder directly inside a
library directory as one game.

1. Make the folder visible to both containers (same host path, mounted read-write for Questarr and
   read-only is enough for Gameyfin).
2. In Gameyfin, create a library and add the Questarr platform folder (for example `/data/PC`) as one of
   its directories.
3. In Gameyfin, turn on **Enable automatic library scanning using file system watchers** (check that it is
   enabled in your version). When Questarr finishes an import, Gameyfin notices the new folder and scans that library.
   Without the watcher, trigger a scan from Gameyfin or rely on its scheduled scan.
4. In Questarr, keep **Sort add-on files into subfolders** and **Rename Pattern** as you like: Gameyfin
   reads the game name from the folder name, so a pattern such as `{Title}` or `{Title} ({Year})`
   matches best.

## What is not possible today

Gameyfin has no API key or token. Everything beyond folder scanning goes through its web interface
endpoints, which need an administrator session and a CSRF token, and `triggerScan` is admin only. Questarr
would have to store a Gameyfin administrator password and replay a browser login, which it deliberately
does not do. For that reason these ideas are not implemented:

* Triggering a Gameyfin scan from Questarr (the file system watcher covers this).
* Pulling Gameyfin game requests into Questarr's wanted list, and reporting their status back.
* Marking games owned in Questarr from the Gameyfin catalog.

Requests from a request app are covered by the [SeerrNG provider](https://docs.questarr.app/SEERRNG.md) instead. If Gameyfin adds
scoped API tokens, the scan trigger and the ownership sync become small additions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.