// 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.