scan

type Candidate struct {
	Title        string // as the source names it
	TitleTrusted bool   // the title comes from a store or installer record, not a folder name
	Dir          string // install folder
	Exe          string // executable that starts the game ("" when a LaunchURI does)
	Args         string
	WorkDir      string
	LaunchURI    string // store link that starts the game (steam://rungameid/…)
	Source       Source
	How          string // human-readable: how it was found

	SteamAppID int
	GogID      string
	EpicApp    string // namespace:catalogItem:appName
	UbisoftID  string

	Publisher string // from the installer entry
	Repacker  string // "DODI", "FitGirl", … when a repacker installed it
	SizeBytes int64

	// Playtime the store recorded (Steam's localconfig.vdf).
	StorePlaytime   int64 // seconds
	StoreLastPlayed int64 // unix seconds

	Emulator  string // "RUNE", "CODEX", "Goldberg", … ; "" when none was found
	EmuMarker string // the file that gave it away
	EmuDir    string // folder (relative to Dir) where the marker or steam_settings was found
	AppIDFrom string // file the Steam AppID was read from (unofficial copies)
	DRMFree   string // "GOG" when a GOG game info file was found outside a GOG install
	PadHint   string // "libScePad" or "SDL": the game handles a DualSense itself
}

type Emulation struct {
	Emulator  string // "RUNE", "Goldberg", …; "" when the copy looks official
	Marker    string // the file that gave it away
	AppID     int    // Steam app id the emulator is set up as
	AppIDFrom string
	Gog       *gogInfo // a GOG game info file, when present
	GogFile   string
	PadHint   string // "libScePad" (Sony's DualSense library) or "SDL" when the game ships one
	// EmuDir is the folder, relative to the game folder, where the emulator
	// marker (or steam_settings) was found; "." for the game folder itself.
	EmuDir string
}

type Options struct {
	Folders          []string // watched folders from Settings
	AutoFolders      bool     // also look in common game folders on every drive
	DetectUnofficial bool     // look for Steam emulators and cracks in game folders
	Signed           func(path string) bool
}

type Result struct {
	Games    []Candidate
	Took     time.Duration
	PerStore map[Source]int
}

type Source string

type SteamStat struct {
	Playtime   int64 // seconds
	LastPlayed int64 // unix seconds
}