mister

package
v2.18.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 25, 2026 License: GPL-3.0 Imports: 75 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ArcadeCatalog added in v2.18.0 

func ArcadeCatalog(pl platforms.Platform) ([]misterarcade.Entry, error)

ArcadeCatalog reads the platform's cached or embedded arcade catalog for the scraper.

func ArcadeSystemIDs added in v2.18.0 

func ArcadeSystemIDs() []string

ArcadeSystemIDs returns the systems arcade descriptors are indexed under on this platform: Arcade itself, plus every granular hardware system classification splits out of it.

func BackupDefinitions added in v2.16.0 

func BackupDefinitions(settings platforms.Settings) []platforms.BackupDefinition

func BackupRestoreRoot added in v2.16.0 

func BackupRestoreRoot(settings platforms.Settings) string

func CmdIni 

func CmdIni(_ platforms.Platform, env *platforms.CmdEnv) (platforms.CmdResult, error)

func CmdLaunchCore 

func CmdLaunchCore(_ platforms.Platform, env *platforms.CmdEnv) (platforms.CmdResult, error)

func CmdMisterMgl 

func CmdMisterMgl(_ platforms.Platform, env *platforms.CmdEnv) (platforms.CmdResult, error)

func CmdWallpaper added in v2.10.0 

func CmdWallpaper(_ platforms.Platform, env *platforms.CmdEnv) (platforms.CmdResult, error)

CmdWallpaper sets or unsets the MiSTer main menu wallpaper.

With an argument (e.g. "mister.wallpaper|filename.png"), sets that file from the wallpapers directory as the active wallpaper. Without arguments, unsets the current wallpaper.

The mechanism works by creating a symlink at /media/fat/menu.{ext} pointing to the target file in /media/fat/wallpapers/, then setting the background mode byte in MENU.CFG to wallpaper mode. If the user is on the main menu, the menu core is relaunched to display the change immediately.

func CreateLaunchers added in v2.7.0 

func CreateLaunchers(pl platforms.Platform) []platforms.Launcher

CreateLaunchers creates all standard MiSTer launchers for the given platform. This is exported for use by MiSTeX and other MiSTer variants.

func LoadCsvMappings 

func LoadCsvMappings() (uidMappings, textMappings map[string]string, err error)

func NewArcadeScraper added in v2.18.0 

func NewArcadeScraper(pl platforms.Platform, systems []string) platforms.Scraper

NewArcadeScraper builds the arcade catalog scraper for a MiSTer platform. systems states which arcade systems that platform indexes.

func NewArcadeSetNameCache added in v2.18.0 

func NewArcadeSetNameCache(pl platforms.Platform) misterarcade.SetNameCache

NewArcadeSetNameCache answers set-name lookups from the classification cache granular arcade indexing already wrote, so a scrape costs a map lookup per descriptor instead of re-reading thousands of them from SD storage. An entry only answers while the file still matches the size and mtime it was parsed at, and a cached empty set name is a real answer: that descriptor had none.

func StartCsvMappingsWatcher 

func StartCsvMappingsWatcher(
	getLoadTime func() time.Time,
	setMappings func(map[string]string, map[string]string),
) (func() error, error)

func StartResourceTopologyManager added in v2.17.0 

func StartResourceTopologyManager(ctx context.Context)

StartResourceTopologyManager keeps CPU0 available to the software frontend only while frontend holds its kernel-backed activity lease. The lease is released automatically on exit or forced termination, so Core restarts and frontend startup ordering cannot leave topology in a stale state.

Types

type CoreNameGetter added in v2.9.1 

type CoreNameGetter interface {
	GetCoreName() string
}

CoreNameGetter provides an interface for getting the active core name.

type CsvMappingEntry 

type CsvMappingEntry struct {
	MatchUID  string `csv:"match_uid"`
	MatchText string `csv:"match_text"`
	Text      string `csv:"text"`
}

type FramebufferChecker added in v2.9.1 

type FramebufferChecker interface {
	IsReady() bool
}

FramebufferChecker provides an interface for checking framebuffer readiness.

type MiSTerConsoleManager added in v2.7.0 

type MiSTerConsoleManager struct {
	// contains filtered or unexported fields
}

MiSTerConsoleManager manages console/TTY switching for MiSTer platform.

func (*MiSTerConsoleManager) Clean added in v2.7.0 

func (m *MiSTerConsoleManager) Clean(vt string) error

Clean prepares a console for use (clears screen, hides cursor). This is public to allow launchers to clean specific TTYs.

func (*MiSTerConsoleManager) Close added in v2.7.0 

func (m *MiSTerConsoleManager) Close() error

Close exits console mode and returns to normal display.

func (*MiSTerConsoleManager) Open added in v2.7.0 

func (m *MiSTerConsoleManager) Open(ctx context.Context, vt string) error

Open switches to console mode on the specified VT. The provided context can be used to cancel the operation if the launcher is superseded.

func (*MiSTerConsoleManager) Restore added in v2.7.0 

func (m *MiSTerConsoleManager) Restore(vt string) error

Restore restores console cursor state. This is public to allow launchers to restore specific TTYs.

type Platform 

type Platform struct {
	shared.InputManager
	// contains filtered or unexported fields
}

func NewPlatform 

func NewPlatform() *Platform

func (*Platform) ApplyProfile added in v2.16.0 

func (p *Platform) ApplyProfile(ref platforms.ProfileRef, enabledItems []string) error

ApplyProfile implements platforms.ProfileDataSwapper.

func (*Platform) BackupDefinitions added in v2.16.0 

func (p *Platform) BackupDefinitions() []platforms.BackupDefinition

func (*Platform) BackupRestoreRoot added in v2.16.0 

func (p *Platform) BackupRestoreRoot() string

func (*Platform) CheckAndClearArcadeCardLaunch added in v2.7.0 

func (p *Platform) CheckAndClearArcadeCardLaunch(setname string) bool

CheckAndClearArcadeCardLaunch checks if the setname was recently launched via card. Returns true if there's a match within the last 15 seconds, false otherwise. Clears the cache after checking to prevent stale suppressions.

func (*Platform) ConsoleManager added in v2.7.0 

func (p *Platform) ConsoleManager() platforms.ConsoleManager

func (*Platform) ForwardCmd 

func (p *Platform) ForwardCmd(env *platforms.CmdEnv) (platforms.CmdResult, error)

func (*Platform) GetDBLoadTime 

func (p *Platform) GetDBLoadTime() time.Time

func (*Platform) ID 

func (*Platform) ID() string

func (*Platform) LaunchMedia 

func (p *Platform) LaunchMedia(
	cfg *config.Instance, path string, launcher *platforms.Launcher, db *database.Database,
	opts *platforms.LaunchOptions,
) error

func (*Platform) LaunchSystem 

func (p *Platform) LaunchSystem(cfg *config.Instance, id string) error

func (*Platform) LaunchSystemLauncher added in v2.17.0 

func (p *Platform) LaunchSystemLauncher(cfg *config.Instance, systemID string, launcher *platforms.Launcher) error

LaunchSystemLauncher implements platforms.SystemLauncherSelector, loading the specific core a launcher maps to (e.g. an alt core) instead of the system's default. The caller (cmdSystem) has already verified launcher belongs to systemID.

func (*Platform) Launchables added in v2.15.0 

func (p *Platform) Launchables(cfg *config.Instance) []launchables.Launchable

Launchables exposes launch-only MiSTer core entries that do not already have media launchers.

func (*Platform) LauncherRuntime added in v2.17.0 

func (*Platform) LauncherRuntime(cfg *config.Instance, l *platforms.Launcher) models.LauncherRuntime

LauncherRuntime implements platforms.LauncherRuntimeProvider, reporting the FPGA core a launcher loads. It never rescans the filesystem — it only reads whatever the RBF cache currently holds, which Launchers keeps fresh.

func (*Platform) Launchers 

func (p *Platform) Launchers(cfg *config.Instance) []platforms.Launcher

func (*Platform) LookupMapping 

func (p *Platform) LookupMapping(t *tokens.Token) (string, bool)

func (*Platform) ManagedByPackageManager added in v2.10.0 

func (*Platform) ManagedByPackageManager() bool

ManagedByPackageManager checks if this install is managed by MiSTer Downloader or update_all by looking for known database entries in the downloader configuration file.

func (*Platform) MinimumUIDisplay added in v2.16.0 

func (*Platform) MinimumUIDisplay(kind models.UIEventKind) time.Duration

func (*Platform) NormalizeLaunchPath added in v2.18.0 

func (*Platform) NormalizeLaunchPath(path string) string

func (*Platform) PrepareBackup added in v2.17.0 

func (p *Platform) PrepareBackup() (platforms.BackupPlan, func() error, error)

func (*Platform) PrepareBackupRestore added in v2.16.0 

func (p *Platform) PrepareBackupRestore() (func(bool) error, error)

func (*Platform) PresentUI added in v2.16.0 

func (p *Platform) PresentUI(
	ctx context.Context,
	event *models.UIEvent,
) (func() error, error)

func (*Platform) ProfileItems added in v2.16.0 

func (*Platform) ProfileItems() []platforms.ProfileItem

ProfileItems implements platforms.ProfileDataSwapper.

func (*Platform) RefreshLauncherDependencies added in v2.16.0 

func (p *Platform) RefreshLauncherDependencies() error

func (*Platform) ReturnToMenu added in v2.7.0 

func (p *Platform) ReturnToMenu() error

func (*Platform) RootDirs 

func (*Platform) RootDirs(cfg *config.Instance) []string

func (*Platform) ScanHook 

func (p *Platform) ScanHook(token *tokens.Token) error

func (*Platform) Scrapers added in v2.12.0 

func (p *Platform) Scrapers(_ *config.Instance) map[string]platforms.Scraper

func (*Platform) Screenshot added in v2.10.0 

func (*Platform) Screenshot() (*platforms.ScreenshotResult, error)

Screenshot triggers a MiSTer screenshot via the command interface and waits for the resulting file to appear in the screenshots directory. The full image is read into memory and returned as bytes. Typical PNGs are ~200-500KB which is fine for single-client usage on ARM. If screenshots grow significantly larger, consider a streaming approach instead.

func (*Platform) SetArcadeCardLaunch added in v2.7.0 

func (p *Platform) SetArcadeCardLaunch(setname string)

SetArcadeCardLaunch caches the arcade setname when launching via card.

func (*Platform) SetDB 

func (p *Platform) SetDB(uidMap, textMap map[string]string)

func (*Platform) SetTrackedProcess added in v2.6.1 

func (p *Platform) SetTrackedProcess(proc *os.Process)

func (*Platform) Settings 

func (*Platform) Settings() platforms.Settings

func (*Platform) StartPost 

func (p *Platform) StartPost(
	ctx context.Context,
	cfg *config.Instance,
	launcherManager platforms.LauncherContextManager,
	activeMedia func() *models.ActiveMedia,
	setActiveMedia func(*models.ActiveMedia),
	db *database.Database,
	scheduler *idle.Scheduler,
) error

func (*Platform) StartPre 

func (p *Platform) StartPre(cfg *config.Instance) error

func (*Platform) Stop 

func (p *Platform) Stop() error

func (*Platform) StopActiveLauncher 

func (p *Platform) StopActiveLauncher(intent platforms.StopIntent) error

func (*Platform) SupportedReaders 

func (p *Platform) SupportedReaders(cfg *config.Instance) []readers.Reader

func (*Platform) TTY2OLEDPictureName added in v2.16.1 

func (*Platform) TTY2OLEDPictureName(media *models.ActiveMedia) string

TTY2OLEDPictureName returns MiSTer's arcade setname, matching upstream picture filenames.

func (*Platform) WatchProfileData added in v2.16.0 

func (*Platform) WatchProfileData(ctx context.Context, onChange func())

WatchProfileData implements platforms.ProfileDataWatcher: it invokes onChange whenever the mount table changes (the kernel signals POLLPRI on /proc/self/mountinfo), debounced, until ctx is done. This is how the service notices a cifs boot script mounting over saves after us, a USB root drive appearing late, or a manual unmount.

type Romset 

type Romset struct {
	Name    string `xml:"name,attr"`
	AltName string `xml:"altname,attr"`
}

type Romsets 

type Romsets struct {
	XMLName xml.Name `xml:"romsets"`
	Romsets []Romset `xml:"romset"`
}

type ScummVMGame added in v2.7.0 

type ScummVMGame struct {
	TargetID    string // Section name, used to launch the game
	Description string // Human-readable game title
	Path        string // Configured game directory, used for metadata discovery
	GameID      string // Engine game ID, shared by every variant of one game
}

ScummVMGame represents a game configured in scummvm.ini

type TTYReader added in v2.9.1 

type TTYReader interface {
	GetActiveTTY() (string, error)
}

TTYReader provides an interface for reading the active TTY.

Source Files

View all Source files

Directories

Path Synopsis
Package catalog preserves the original Core import path for the standalone github.com/ZaparooProject/zaparoo-core/mister/catalog module.
 Package catalog preserves the original Core import path for the standalone github.com/ZaparooProject/zaparoo-core/mister/catalog module.
Package mgl preserves the original Core import path for the standalone github.com/ZaparooProject/zaparoo-core/mister/mgl module.
 Package mgl preserves the original Core import path for the standalone github.com/ZaparooProject/zaparoo-core/mister/mgl module.
activegame

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.