methods

package
v2.15.0-beta1 Latest Latest
Warning

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

 Go to latest Published: Jun 21, 2026 License: GPL-3.0 Imports: 66 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var ErrLocalhostOnly = errors.New("method is only available from localhost")

ErrLocalhostOnly is returned when a non-localhost client invokes a method that is restricted to local administration only.

View Source 
var ErrNotAllowed = errors.New("not allowed")

ErrNotAllowed is returned when a run request is not allowed.

Functions

func CancelIndexing added in v2.7.0 

func CancelIndexing() bool

CancelIndexing cancels the currently running indexing operation - used for testing

func ClearIndexingStatus added in v2.7.0 

func ClearIndexingStatus()

ClearIndexingStatus clears the global indexing status - used for testing

func ClearScrapingStatus added in v2.12.0 

func ClearScrapingStatus()

ClearScrapingStatus resets the global scraping status — used for testing.

func GenerateMediaDB added in v2.7.0 

func GenerateMediaDB(
	ctx context.Context,
	pl platforms.Platform,
	cfg *config.Instance,
	ns chan<- models.Notification,
	systems []systemdefs.System,
	db *database.Database,
	pauser *syncutil.Pauser,
) error

func HandleActiveMedia 

func HandleActiveMedia(env requests.RequestEnv) (any, error)

func HandleAddMapping 

func HandleAddMapping(env requests.RequestEnv) (any, error)

func HandleClients added in v2.11.0 

func HandleClients(env requests.RequestEnv) (any, error)

HandleClients lists paired clients (localhost-only).

func HandleClientsDelete added in v2.11.0 

func HandleClientsDelete(env requests.RequestEnv) (any, error)

HandleClientsDelete revokes a paired client (localhost-only, forward-only; existing sessions survive until disconnect).

func HandleClientsPairCancel added in v2.11.0 

func HandleClientsPairCancel(mgr PairingController) func(requests.RequestEnv) (any, error)

HandleClientsPairCancel returns a handler that cancels the active pairing flow. Localhost-only.

func HandleClientsPairStart added in v2.11.0 

func HandleClientsPairStart(mgr PairingController) func(requests.RequestEnv) (any, error)

HandleClientsPairStart returns a handler that initiates a new pairing flow. Localhost-only — the user must have physical access to the device.

func HandleConfirm added in v2.11.0 

func HandleConfirm(env requests.RequestEnv) (any, error)

func HandleDeleteMapping 

func HandleDeleteMapping(env requests.RequestEnv) (any, error)

func HandleGenerateMedia 

func HandleGenerateMedia(env requests.RequestEnv) (any, error)

func HandleHealthCheck added in v2.7.1 

func HandleHealthCheck(_ requests.RequestEnv) (any, error)

func HandleHistory 

func HandleHistory(env requests.RequestEnv) (any, error)

func HandleInbox added in v2.8.0 

func HandleInbox(env requests.RequestEnv) (any, error)

func HandleInboxClear added in v2.8.0 

func HandleInboxClear(env requests.RequestEnv) (any, error)

func HandleInboxDelete added in v2.8.0 

func HandleInboxDelete(env requests.RequestEnv) (any, error)

func HandleInputGamepad added in v2.10.0 

func HandleInputGamepad(env requests.RequestEnv) (any, error)

func HandleInputKeyboard added in v2.10.0 

func HandleInputKeyboard(env requests.RequestEnv) (any, error)

func HandleLaunchers added in v2.12.0 

func HandleLaunchers(env requests.RequestEnv) (any, error)

func HandleLaunchersRefresh 

func HandleLaunchersRefresh(env requests.RequestEnv) (any, error)

func HandleLogsDownload 

func HandleLogsDownload(env requests.RequestEnv) (any, error)

func HandleMappings 

func HandleMappings(env requests.RequestEnv) (any, error)

func HandleMedia 

func HandleMedia(env requests.RequestEnv) (any, error)

func HandleMediaBrowse added in v2.10.0 

func HandleMediaBrowse(env requests.RequestEnv) (any, error)

HandleMediaBrowse handles the media.browse API method for directory-style navigation of indexed media content.

func HandleMediaBrowseIndex added in v2.15.0 

func HandleMediaBrowseIndex(env requests.RequestEnv) (any, error)

HandleMediaBrowseIndex handles the media.browse.index API method. It returns the ordered first-character buckets for a browse scope, each with a count and a ready-to-use seek cursor, so a client can draw a "jump to letter" rail and jump into the full ordered list in one round trip. media.browse itself is unchanged: the per-bucket cursor is a normal browse cursor.

func HandleMediaCleanOrphans added in v2.12.0 

func HandleMediaCleanOrphans(env requests.RequestEnv) (any, error)

HandleMediaCleanOrphans removes missing Media records and their associated orphaned data (tags, properties, fully-orphaned titles). Returns the number of missing Media rows deleted.

func HandleMediaControl added in v2.10.0 

func HandleMediaControl(env requests.RequestEnv) (any, error)

func HandleMediaGenerateCancel added in v2.7.0 

func HandleMediaGenerateCancel(env requests.RequestEnv) (any, error)

func HandleMediaGenerateResume added in v2.11.0 

func HandleMediaGenerateResume(env requests.RequestEnv) (any, error)

func HandleMediaHistory added in v2.10.0 

func HandleMediaHistory(env requests.RequestEnv) (any, error)

func HandleMediaHistoryLatest added in v2.14.0 

func HandleMediaHistoryLatest(env requests.RequestEnv) (any, error)

func HandleMediaHistoryTop added in v2.10.0 

func HandleMediaHistoryTop(env requests.RequestEnv) (any, error)

func HandleMediaImage added in v2.12.0 

func HandleMediaImage(env requests.RequestEnv) (any, error)

HandleMediaImage returns a single best-match image for a media record as a base64-encoded blob.

func HandleMediaLookup added in v2.10.0 

func HandleMediaLookup(env requests.RequestEnv) (any, error)

func HandleMediaMeta added in v2.12.0 

func HandleMediaMeta(env requests.RequestEnv) (any, error)

HandleMediaMeta returns the full metadata graph for a single Media record: the Media itself, its parent MediaTitle, System, level-separated Tags, and level-separated Properties. Binary payloads are not included; use media.image to fetch image bytes.

func HandleMediaMetaUpdate added in v2.15.0 

func HandleMediaMetaUpdate(env requests.RequestEnv) (any, error)

func HandleMediaScrape added in v2.12.0 

func HandleMediaScrape(env requests.RequestEnv) (any, error)

HandleMediaScrape starts a named scraper as a tracked background operation. Returns immediately with a null result; progress is broadcast as "media.scraping" notifications. Scraping and indexing are mutually exclusive.

func HandleMediaScrapeCancel added in v2.12.0 

func HandleMediaScrapeCancel(env requests.RequestEnv) (any, error)

func HandleMediaScrapeResume added in v2.12.0 

func HandleMediaScrapeResume(env requests.RequestEnv) (any, error)

HandleMediaScrapeResume manually resumes a paused media.scrape operation.

func HandleMediaScrapeStatus added in v2.12.0 

func HandleMediaScrapeStatus(env requests.RequestEnv) (any, error)

HandleMediaScrapeStatus returns the latest known media.scrape status snapshot.

func HandleMediaSearch 

func HandleMediaSearch(env requests.RequestEnv) (any, error)

func HandleMediaTags added in v2.7.0 

func HandleMediaTags(env requests.RequestEnv) (any, error)

func HandleMediaTagsUpdate added in v2.12.0 

func HandleMediaTagsUpdate(env requests.RequestEnv) (any, error)

func HandleMediaTitleParse added in v2.13.0 

func HandleMediaTitleParse(
	env requests.RequestEnv,
) (any, error)

HandleMediaTitleParse computes a MediaTitle from a system ID and path without touching the filesystem or database. Used to preview the title parsing and slug generation that the media scanner would produce.

func HandlePlaytime added in v2.7.0 

func HandlePlaytime(env requests.RequestEnv) (any, error)

func HandlePlaytimeLimits added in v2.7.0 

func HandlePlaytimeLimits(env requests.RequestEnv) (any, error)

func HandlePlaytimeLimitsUpdate added in v2.7.0 

func HandlePlaytimeLimitsUpdate(env requests.RequestEnv) (any, error)

func HandleReaderWrite 

func HandleReaderWrite(
	params json.RawMessage,
	allReaders []readers.Reader,
	lastScanned *tokens.Token,
	setWroteToken func(*tokens.Token),
) (any, error)

func HandleReaderWriteCancel 

func HandleReaderWriteCancel(
	params json.RawMessage,
	allReaders []readers.Reader,
) (any, error)

func HandleReaders 

func HandleReaders(allReaders []readers.Reader) (any, error)

func HandleReloadMappings 

func HandleReloadMappings(env requests.RequestEnv) (any, error)

func HandleRun 

func HandleRun(env requests.RequestEnv) (any, error)

func HandleRunRest 

func HandleRunRest(
	cfg *config.Instance,
	st *state.State,
	itq chan<- tokens.Token,
) http.HandlerFunc

func HandleScrapers added in v2.12.0 

func HandleScrapers(env requests.RequestEnv) (any, error)

HandleScrapers returns the list of registered scrapers with their IDs and human-readable names.

func HandleScreenshot added in v2.10.0 

func HandleScreenshot(env requests.RequestEnv) (any, error)

func HandleSettings 

func HandleSettings(env requests.RequestEnv) (any, error)

func HandleSettingsAuthClaim added in v2.10.0 

func HandleSettingsAuthClaim(env requests.RequestEnv, fetchWK wellKnownFetcher) (any, error)

HandleSettingsAuthClaim redeems a claim token against a remote auth server and stores the resulting credentials in auth.toml. It uses .well-known/zaparoo trust discovery to extend the credential to additional trusted domains.

func HandleSettingsReload 

func HandleSettingsReload(env requests.RequestEnv) (any, error)

func HandleSettingsUpdate 

func HandleSettingsUpdate(env requests.RequestEnv) (any, error)

func HandleStop 

func HandleStop(env requests.RequestEnv) (any, error)

func HandleSystems 

func HandleSystems(env requests.RequestEnv) (any, error)

func HandleTokens 

func HandleTokens(env requests.RequestEnv) (any, error)

func HandleUpdateActiveMedia 

func HandleUpdateActiveMedia(env requests.RequestEnv) (any, error)

func HandleUpdateApply added in v2.10.0 

func HandleUpdateApply(
	env requests.RequestEnv,
	applyFn func(ctx context.Context, platformID, channel string) (string, error),
	restartFn func(),
) (any, error)

func HandleUpdateCheck added in v2.10.0 

func HandleUpdateCheck(
	env requests.RequestEnv,
	checkFn func(ctx context.Context, platformID, channel string) (*updater.Result, error),
) (any, error)

func HandleUpdateMapping 

func HandleUpdateMapping(env requests.RequestEnv) (any, error)

func HandleVersion 

func HandleVersion(env requests.RequestEnv) (any, error)

func InitMediaThumbCache added in v2.14.1 

func InitMediaThumbCache(pl platforms.Platform)

InitMediaThumbCache creates or replaces the process-wide thumb cache for the given platform. Must be called once during service start, before any media.image requests are handled. Uses atomic store so concurrent StartWithReady calls in tests do not race.

func IsIndexing added in v2.11.0 

func IsIndexing() bool

IsIndexing reports whether media indexing is currently in progress.

func IsScrapingRunning added in v2.12.0 

func IsScrapingRunning() bool

IsScrapingRunning reports whether a media.scrape operation is currently active.

func PublishScrapePauseStatus added in v2.12.0 

func PublishScrapePauseStatus(ns chan<- models.Notification, paused bool)

func ResumeMediaScrape added in v2.14.0 

func ResumeMediaScrape(env *requests.RequestEnv, operation database.ScrapingOperation) error

func WipeMediaThumbCache added in v2.14.1 

func WipeMediaThumbCache()

WipeMediaThumbCache removes all cached thumbnails. Called after a successful scrape (image sources may have changed) or media reindex so the cache does not serve stale art.

Types

type NoContent 

type NoContent struct{}

type PairingController added in v2.11.0 

type PairingController interface {
	StartPairing() (pin string, expiresAt time.Time, err error)
	CancelPairing()
}

PairingController is the subset of PairingManager needed by the RPC handlers.

Source Files

View all Source files

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.