tomaspavlic / opensubtitles-api

OpenSubtitles.org API Client Library for .NET

OpenSubtitles.org API Client

With Covid-19 pandemic requests for our API went skyrocket, our servers could not handle so much traffic, so we decided to limit API usage just to authenticated requests for User Agents. In short it means, you have to provide opensubtitles.org username and password in LogIn() method.

Installation

## .NET CLI
dotnet add package Topdev.OpenSubtitles.Client

## Package Manager
Install-Package Topdev.OpenSubtitles.Client

Usage

var openSubtitlesApi = new OpenSubtitlesApi();

await openSubtitlesApi.LogInAsync("eng", "OSTestUserAgentTemp", "username", "password");

var subtitles = await openSubtitlesApi.FindSubtitlesAsync(
    SearchMethod.Qeury,
    "Game of thrones s01e01",
    "eng");

await openSubtitlesApi.DownloadSubtitleAsync(subtitles[0], null);

XmlRpcClient

Additionally project contains XmlRpcClient.

var rpcClient = new XmlRpcClient("http://some-rpc-endpoint");
var T = await rpcClient.InvokeAsync<T>("methodName", parameters);

Donations

Please feel free to donate to me. I'm not going to force you to donate, you can use my software completely free of charge and without limitation for any purpose you want. If you really want to give something to me then you are welcome to do so. I don't expect donations, nor do I insist that you give them.

ETH - 22a99ed4ebe631ff87332e6bcdcc6ef5ec01289f

opensubtitles-api's Issues

Limit search results

Hello, how to search with more results? I tried with many keywords but just return max 5 results

License

Hi,

I wanted to use your library but there is no license included. When you get a chance, can you please add one?
https://choosealicense.com/ is a good reference on picking a license.

Cody