yquem

A JavaScript library which fetches subtitles for tv shows episodes from Beta Series API.

This library works weel with Medoc.

Features

• Detect recent episodes (default 2 day old) from a specific directory (filename must be {show} - {season}x{episode}.{format});
• Download first subtitle found on Beta Series for this episode next to the episode file.

Install

$ npm install yquem

Usage

const Yquem = require("yquem")
 
const yquem = new Yquem(`d:`)
 
yquem
  .run()
  .then(results => {
    console.log(results)
  })
  .catch(err => {
    console.error(err)
  })

Documentation

Instance methods

run()

Look for recent files from the specified directory, try to grab subtitles from filename, returns a Promise when done.

Static methods

getRecentFilesFromDirectory([path], [fileAge])

Return a list of recent files from the specified directory.

• path <string> Directory to scan.
• fileAge <string> | <number> Number of days to consider a file to be recent.

hasSubtitle([file], { languages: 'en' })

Check if a subtitle file exist next to the episode file specified.

• file <string> Complete path of a episode file
• options <object> :
  • languages <string | array> List of languages to look for, default: en

getSubtile([file], { languages: 'en' })

Search a subtitle onn Beta Series and download it next to the episode file specified.

• file <string> Complete path of a episode file
• options <object> :
  • languages <string | array> List of languages to look for, default: en

download([url])

Download file from a given url.

• url <string> URL as a string.

getSubtitles([show])

Get the list of subtitles found on Beta Series for an episode.

• show <object> :
  • name <string> Name of the show
  • season <string> | <number> Season number
  • episode <string> | <number> Episode number

getShowName([filename])

Extract show name from filename.

• filename <string> Episode filename, format : Krypton - 1x01.

getShowNumber([filename])

Extract season number and episode number from filename.

• filename <string> Episode filename, format : Smallville - 6x08.

getShow([name])

Get the show object from Beta Series API.

• name <string> Show name.

getEpisodeByShow([id], [episode])

Get the episode object from Beta Series API.

• id <string | number> Show identifier.
• episode <string> Episode description, format : S01E01.

writeFile([data], [destinationPath])

Write a new file to destinationPath.

• data <buffer> Date of the new file.
• destinationPath <string> Complete path of the new file.

buildEpisodeName([name], [season], [episode])

Return the formatted episode name, ie : Final Space - 2x03.

• name <string> Name of the show
• season <string> | <number> Season number
• episode <string> | <number> Episode number