Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mhergon/MPMoviePlayerController-Subtitles
Easy way to show SRT files on MPMoviePlayerController
https://github.com/mhergon/MPMoviePlayerController-Subtitles
Last synced: 3 months ago
JSON representation
Easy way to show SRT files on MPMoviePlayerController
- Host: GitHub
- URL: https://github.com/mhergon/MPMoviePlayerController-Subtitles
- Owner: mhergon
- License: apache-2.0
- Created: 2013-12-04T17:42:52.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2017-04-11T21:09:43.000Z (over 7 years ago)
- Last Synced: 2024-07-18T14:12:52.185Z (4 months ago)
- Language: Swift
- Size: 20.7 MB
- Stars: 189
- Watchers: 13
- Forks: 25
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - MPMoviePlayerController-Subtitles - MPMoviePlayerController-Subtitles is a library to display subtitles on iOS. It's built as a Swift extension and it's very easy to integrate. (Media / Video)
- awesome-ios-star - MPMoviePlayerController-Subtitles - MPMoviePlayerController-Subtitles is a library to display subtitles on iOS. It's built as a Swift extension and it's very easy to integrate. (Media / Video)
README
MPMoviePlayerController-Subtitles is a library to display subtitles on iOS. It's built as a Swift extension and it's very easy to integrate.
## How To Get Started
### Installation with CocoaPods
```ruby
platform :ios, '8.0'
pod "MPMoviePlayerController-Subtitles"
```
### Manually installation
[Download](https://github.com/mhergon/MPMoviePlayerController-Subtitles/raw/master/MPMoviePlayerController-Subtitles.swift) (right-click) and add to your project.
### Requirements
| Version | Language | Minimum iOS Target |
|:--------------------:|:---------------------------:|:---------------------------:|
| 2.2.x | Swift 3.x | iOS 8 |
| 2.0.x | Swift 2.x | iOS 8 |
| 1.x | Objective-C | iOS 6 |
### Usage with player
```swift
import MPMoviePlayerControllerSubtitles
```
```swift
// Video file
let videoFile = Bundle.main.path(forResource: "trailer_720p", ofType: "mov")
// Subtitle file
let subtitleFile = Bundle.main.path(forResource: "trailer_720p", ofType: "srt")
let subtitleURL = URL(fileURLWithPath: subtitleFile!)
// Movie player
let moviePlayerView = MPMoviePlayerViewController(contentURL: URL(fileURLWithPath: videoFile!))
presentMoviePlayerViewControllerAnimated(moviePlayerView)
// Add subtitles
moviePlayerView?.moviePlayer.addSubtitles().open(file: subtitleURL)
moviePlayerView?.moviePlayer.addSubtitles().open(file: subtitleURL, encoding: String.Encoding.utf8)
// Change text properties
moviePlayerView?.moviePlayer.subtitleLabel?.textColor = UIColor.red
// Play
moviePlayerView?.moviePlayer.play()
```
#### Screenshot
### Usage without player
From version 2.2 you can search text in the SubRip file or text without need play any file.
```swift
import MPMoviePlayerControllerSubtitles
```
```swift
// Subtitle file
let subtitleFile = Bundle.main.path(forResource: "trailer_720p", ofType: "srt")
let subtitleURL = URL(fileURLWithPath: subtitleFile!)
// Subtitle parser
let parser = Subtitles(file: subtitleURL, encoding: .utf8)
// Do something with result
let subtitles = parser.searchSubtitles(at: 2.0) // Search subtitle at 2.0 seconds
```
## Contact
- [Linkedin][2]
- [Twitter][3] (@mhergon)
[2]: https://es.linkedin.com/in/marchervera
[3]: http://twitter.com/mhergon "Marc Hervera"
## License
Licensed under Apache License v2.0.
Copyright 2017 Marc Hervera.