Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
An Obj-C API for Searching and Downloading Subtitles from OpenSubtitles.
Objective-C Ruby
branch: master

Merge pull request #4 from JavierQuerol/master

Add IMDB rating and compatibility with modern archs
latest commit fe37ad4ed3
@orta authored
Failed to load latest commit information.
.gitignore Initial commit
LICENSE added docs + podspec
OROpenSubtitleDownloader.h added imdbID property to OpenSubtitleSearchResult
OROpenSubtitleDownloader.podspec Update OROpenSubtitleDownloader.podspec syntax


An Obj-C API for Searching and Downloading Subtitles from OpenSubtitles. Currently supports only searching and downloading of srt files are support. Pull Requests with more features are welcome.

OpenSubtitles Documentation

/// OROpenSubtitleDownloader makes it easier to handle downloading and searching
/// for subtitles via the API

@interface OROpenSubtitleDownloader : NSObject <XMLRPCConnectionDelegate>

/// By using init the object will create it's own user agent based on bundle info
- (OROpenSubtitleDownloader *)init;

/// Use a custom user agent
- (OROpenSubtitleDownloader *)initWithUserAgent:(NSString *)userAgent;

/// The object that recieves notifications for new subtitles
@property (nonatomic, weak) NSObject <OROpenSubtitleDownloaderDelegate> *delegate;

/// Internal state of subtitle downloader
@property (nonatomic, readonly) OROpenSubtitleState state;

/// Language string, defaults to "eng", 
/// See: for full list
@property (nonatomic, strong) NSString *languageString;

/// Search and get a return block with an array of OpenSubtitleSearchResult
- (void)searchForSubtitlesWithHash:(NSString *)hash andFilesize:(NSNumber *)filesize :(void(^) (NSArray *subtitles))searchResult;

/// Downloads a subtitle result to a file after being unzipped
- (void)downloadSubtitlesForResult:(OpenSubtitleSearchResult *)result toPath:(NSString *)path :(void(^)())onResultsFound;
Something went wrong with that request. Please try again.