subdl

Documentation

Overview

Package subdl implements the SubDL subtitle provider. REST API at api.subdl.com/api/v1, requires API key. Supports movies and TV episodes via IMDB/TMDB search. Rate limits: 2000/day, 1,000,000 lifetime.

Index

• func Factory(_ context.Context, settings map[string]any) (api.Provider, error)
• type Provider
  • func (p *Provider) Download(ctx context.Context, sub *api.Subtitle) ([]byte, error)
  • func (p *Provider) Name() api.ProviderID
  • func (p *Provider) Search(ctx context.Context, req *api.SearchRequest) ([]api.Subtitle, error)

Functions

func Factory

func Factory(_ context.Context, settings map[string]any) (api.Provider, error)

Factory creates a SubDL provider from settings.

Types

type Provider

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

Provider implements the SubDL API client.

func (*Provider) Download

func (p *Provider) Download(ctx context.Context, sub *api.Subtitle) ([]byte, error)

Download fetches the subtitle content for the given search result. SubDL download URLs are relative paths; absolute URLs are rejected.

func (*Provider) Name

func (p *Provider) Name() api.ProviderID

Name returns the provider identifier for SubDL.

func (*Provider) Search

func (p *Provider) Search(ctx context.Context, req *api.SearchRequest) ([]api.Subtitle, error)

Search finds subtitles matching the request via IMDB/TMDB ID or title.