Command line and library to search and download subtitles.
npm install subtitler
shell
npm install subtitler -g
`
API
$3
`js
var opensubtitles = require("subtitler");
opensubtitles.api.login()
.then(function(token){
// got the auth token
});
`
$3
`js
var opensubtitles = require("subtitler");
opensubtitles.api.searchForFile(login, lang, movieFilePath);
.then(functions(results){
//got the search results
});
opensubtitles.api.searchForTitle(token, lang, text)
.then(functions(results){
//got the search results
});
opensubtitles.api.searchForTag(token, lang, tag)
.then(functions(results){
//got the search results
});
opensubtitles.api.search(token, lang, {
query: "",
tag: ""
})
.then(functions(results){
//got the search results
});
`
$3
`js
var opensubtitles = require("subtitler");
opensubtitles.api.logout(login);
`
Command line
`shell
subtitler
--lang eng|pob|...
-n
--download
--retries
--retryIn
`
> if a file or directory is provided -- download is activated by default
> if free text is provided -- performs a query into opensubtitles with it!
> --lang The language to search. Defaults to LANG environment variable.
> -n specifies the number of subtitles to list or download if (--download is specified)
> --download Flag to download the results. The downloaded result will have the same same as the file if it can, working well with TV players, etc...
> --retries The number of retries in API error
> --retryIn The seconds to wait before the next retry
$3
`js
//Portuguese
--lang por
//Brazilian
--lang pob
//English
--lang eng
//French
--lang fre
//Spanish
--lang spa
`
Check the languages table on here.
Or the languages aliases on here.
$3
Download subtitles for a file, automatically naming the subtitle file to be the
same as the movie.
`shell
subtitler Cars.avi --lang en_us
LANG=en_us subtitler Cars.avi
`
Search for subtitles (limit 5):
`shell
subtitler Cars --lang eng --n 5
`
Search and download to the current directory the first 5 subtitles:
`shell
subtitler Cars --lang eng -n 5 --download
`
Contribute
Pull requests are welcome but please make sure the the linting and unit tests are working before you
do that. Also adding unit tests will increase the acceptance of the pull request by 10000%!
` bash
grunt dev
``