// OPENBOX DOCS

Storefront Manager

Browse owned and installed catalogs, import either set, and automate imports.

The Storefronts dialog (top bar) browses your storefront catalogs — owned versus installed — and imports either set into the library. It covers Steam, Heroic, Lutris, and Gameyfin.

What each source shows

Source	Owned list comes from	Installed list comes from
Steam	`userdata/*/config/localconfig.vdf`	`steamapps/appmanifest_*.acf`
Heroic	`store_cache` library JSON	installed manifests (`legendaryConfig`, `gog_store`, `nile_config`)
Lutris	`lutris --list-games --json`	`lutris --list-games --installed --json`
Gameyfin	The configured server's catalog	The same catalog, filtered to installed titles

Import owned / uninstalled

Storefront entries without local files are imported as owned-but-uninstalled (store_installed: false). For Gameyfin, the Play button on such an entry becomes INSTALL, downloading through the configured provider into the install folder (the Settings field is empty by default and shows a ~/Games/Gameyfin placeholder). For Steam/Heroic/Lutris, an owned-but-uninstalled entry launches once the client has the game installed — the import simply keeps the title in your catalog ahead of time.

Auto-import on startup

Four Auto-import on startup checkboxes (one per source) make the same imports run every launch. A background worker also re-imports watched folders every 10 seconds, backing off to 5 minutes when the library cannot be read.

Import exclusions

Per-source import exclusions keep specific titles out of future imports and rescans. Add one per title from the Storefronts dialog (or via /api/import/exclusions); excluded entries are filtered from storefront imports and rescans. Heroic exclusions can be store-specific (Epic/GOG/Amazon).

Troubleshooting

Problem	Cause / fix
Catalog empty for a source	The source has no readable manifests/caches. Check the paths in Import sources.
Gameyfin catalog fails	The server URL is unconfigured or unreachable; use Test Gameyfin connection first.
A title keeps re-importing	Add an import exclusion for it, or check it is not a storefront rescan.
Auto-import imports too much	Uncheck the source's auto-import box, and use exclusions for the titles you do not want.