Provider Management

A Provider instance is SyncTV’s connection configuration for a remote Provider gRPC service. It stores only the endpoint, TLS settings, JWT secret, custom CA, timeout, and the Provider types declared by that remote service. Upstream media-source accounts, tokens, cookies, user agents, and backend-specific settings belong to user Provider credentials or the remote Provider deployment, not this instance configuration.

Remote Provider instances can currently declare alist, bilibili, and emby. Media sources also include local types such as direct-url, rtmp, and live-proxy; those are not valid --provider values for remote Provider instances.

Common Commands

synctv provider available
synctv provider list
synctv provider create <NAME> <PROVIDER_ENDPOINT> --provider alist
synctv provider update <NAME> --provider-endpoint <PROVIDER_ENDPOINT> --provider alist
synctv provider enable <NAME>
synctv provider disable <NAME>
synctv provider reconnect <NAME>
synctv provider delete <NAME>

Before You Change a Provider

Operation	Check first
Create	Endpoint, TLS/JWT/CA settings, and declared --provider values match the remote service
Update	Endpoint, TLS, JWT secret, CA, timeout, and supported Provider types
Disable	Whether playlists, media rows, or provider credentials still depend on it
Delete	Whether playlists, media rows, provider credentials, or remote instances still reference it
Reconnect	Upstream reachability and credential expiry

Playback Validation

1. An administrator can browse or search media.
2. A normal user sees media according to permissions.
3. Direct and proxy playback behave as expected.
4. Range seek works for upstreams that support Range.
5. Header-sensitive sources use correct User-Agent, Referer, Range, and authentication headers.

Concepts are in Media Sources. User-facing setup is in Add Media.