Source catalog API

Author-owned HTTP(S) catalogs — not streaming platforms. Intro → plug-in tutorial. Legal → source policy.

init .\catalog --recipe source-catalog
add . --permission network:request

Declare networkHosts (bare domains) in the outer manifest.

Handlers

Handler	Returns
search / browse / listCollection	{ tracks, total, hasMore }
resolve	One playable http(s) URL

User confirms new domains; no retry loops after denial.

Network rules

• Host must be in networkHosts
• No custom ports (443/80)
• Prefer HTTPS; no cookies/tokens for platform bypass

snippet source-provider-search
example network-source
api errors

Related

• plug-in tutorial · dev workflow · examples