Refiners

Refiners enrich a Video object by adding information to it.

A refiner is a simple function:

subliminal.refiners.refine(video, **kwargs)
Parameters:
  • video (Video) – the video to refine.

  • **kwargs – additional parameters for refiners.

Metadata

subliminal.refiners.metadata.refine(video, embedded_subtitles=True, **kwargs)[source]

Refine a video by searching its metadata.

Several Video attributes can be found:

  • resolution

  • video_codec

  • audio_codec

  • subtitle_languages

Parameters:

embedded_subtitles (bool) – search for embedded subtitles.

TVDB

subliminal.refiners.tvdb.refine(video, **kwargs)[source]

Refine a video by searching TheTVDB.

Note

This refiner only work for instances of Episode.

Several attributes can be found:

  • series

  • year

  • series_imdb_id

  • series_tvdb_id

  • title

  • imdb_id

  • tvdb_id

OMDb

subliminal.refiners.omdb.refine(video, apikey=None, **kwargs)[source]

Refine a video by searching OMDb API.

Several Episode attributes can be found:

  • series

  • year

  • series_imdb_id

Similarly, for a Movie:

  • title

  • year

  • imdb_id