{"id":1581,"url":"https://github.com/josejuanqm/VersaPlayer","last_synced_at":"2025-08-02T04:31:40.720Z","repository":{"id":43642622,"uuid":"152906194","full_name":"josejuanqm/VersaPlayer","owner":"josejuanqm","description":"Versatile Video Player implementation for iOS, macOS, and tvOS","archived":false,"fork":false,"pushed_at":"2024-01-18T10:18:32.000Z","size":5498,"stargazers_count":810,"open_issues_count":0,"forks_count":120,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-07-26T14:53:34.935Z","etag":null,"topics":["ads","airplay","avplayer","avplayeritem","extensible","extensions","google","ios","picture-in-picture","pip","swift","swift4","video","video-player","video-player-library"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/josejuanqm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-13T19:16:27.000Z","updated_at":"2025-06-30T20:10:39.000Z","dependencies_parsed_at":"2024-06-18T14:08:28.997Z","dependency_job_id":"8bfd2bb9-1fd9-4145-9ad5-8eff4583bc08","html_url":"https://github.com/josejuanqm/VersaPlayer","commit_stats":{"total_commits":118,"total_committers":14,"mean_commits":8.428571428571429,"dds":0.4576271186440678,"last_synced_commit":"78ad6cab978924a7d029fa59f108e1c05b15b1a8"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/josejuanqm/VersaPlayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josejuanqm%2FVersaPlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josejuanqm%2FVersaPlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josejuanqm%2FVersaPlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josejuanqm%2FVersaPlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/josejuanqm","download_url":"https://codeload.github.com/josejuanqm/VersaPlayer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josejuanqm%2FVersaPlayer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268334612,"owners_count":24233793,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ads","airplay","avplayer","avplayeritem","extensible","extensions","google","ios","picture-in-picture","pip","swift","swift4","video","video-player","video-player-library"],"created_at":"2024-01-05T20:15:50.386Z","updated_at":"2025-08-02T04:31:40.430Z","avatar_url":"https://github.com/josejuanqm.png","language":"Swift","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=KGX5UDWNHBRNY"],"categories":["Media","Swift","HarmonyOS","OOM-Leaks-Crash"],"sub_categories":["Video","Windows Manager","Player"],"readme":"[![CI Status](https://img.shields.io/travis/jose.juan.qm@gmail.com/VersaPlayer.svg?style=flat)](https://travis-ci.org/jose.juan.qm@gmail.com/VersaPlayer)\n[![Version](https://img.shields.io/cocoapods/v/VersaPlayer.svg?style=flat)](https://cocoapods.org/pods/VersaPlayer)\n[![License](https://img.shields.io/cocoapods/l/VersaPlayer.svg?style=flat)](https://cocoapods.org/pods/VersaPlayer)\n[![Platform](https://img.shields.io/cocoapods/p/VersaPlayer.svg?style=flat)](https://cocoapods.org/pods/VersaPlayer)\n\n### News\n##### :tada: - Since 2.1.3 VersaPlayer now supports iOS, macOS, and tvOS\n\n---\n\n\u003cdiv\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/josejuanqm/VersaPlayer/blob/master/Image.png\" /\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#example\"\u003eExample\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\n    \u003c/li\u003e\n    \u003col\u003e\n      \u003cli\u003e\n        \u003ca href=\"#basic-usage\"\u003eBasic Usage\u003c/a\u003e\n      \u003c/li\u003e\n      \u003cli\u003e\n        \u003ca href=\"#adding-controls\"\u003eAdding Controls\u003c/a\u003e\n      \u003c/li\u003e\n      \u003cli\u003e\n        \u003ca href=\"#advanced-usage\"\u003eAdvanced Usage\u003c/a\u003e\n      \u003c/li\u003e\n      \u003col\u003e\n        \u003cli\u003e\n          \u003ca href=\"#drm\"\u003eEncrypted Content (Digital Rights Management)\u003c/a\u003e\n        \u003c/li\u003e\n        \u003cli\u003e\n          \u003ca href=\"#tracks\"\u003eTrack Selection\u003c/a\u003e\n        \u003c/li\u003e\n        \u003col\u003e\n          \u003cli\u003e\n            \u003ca href=\"#audio-tracks\"\u003eAudio Tracks\u003c/a\u003e\n          \u003c/li\u003e\n          \u003cli\u003e\n            \u003ca href=\"#video-tracks\"\u003eVideo Tracks\u003c/a\u003e\n          \u003c/li\u003e\n          \u003cli\u003e\n            \u003ca href=\"#caption-tracks\"\u003eCaption Tracks\u003c/a\u003e\n          \u003c/li\u003e\n          \u003col\u003e\n            \u003cli\u003e\n              \u003ca href=\"#caption-styling\"\u003eCaption Styling\u003c/a\u003e\n            \u003c/li\u003e\n          \u003c/ol\u003e\n        \u003c/ol\u003e\n      \u003c/ol\u003e\n    \u003c/ol\u003e\n    \u003cli\u003e\n      \u003ca href=\"#extensions\"\u003eExtensions\u003c/a\u003e\n    \u003c/li\u003e\n    \u003col\u003e\n      \u003cli\u003e\n        \u003ca href=\"#extensions\"\u003eAirplay Extension\u003c/a\u003e\n      \u003c/li\u003e\n      \u003cli\u003e\n        \u003ca href=\"#extensions\"\u003eAds Extension\u003c/a\u003e\n      \u003c/li\u003e\n      \u003cli\u003e\n        \u003ca href=\"#extensions\"\u003eOverlay Content Extension\u003c/a\u003e\n      \u003c/li\u003e\n    \u003c/ol\u003e\n    \u003cli\u003e\n      \u003ca href=\"#documentation\"\u003eDocumentation\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#contributors\"\u003eAwesome People (Contributors)\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#donation\"\u003eDonation\u003c/a\u003e\n    \u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/div\u003e\n\n## Community\n\nIf you have any doubts or need help with anything, head over to [Gitter](https://gitter.im/VersaPlayer/Lobby) and ask it there!\n\n## Example\n\nTo run the example project, clone the repo, and run `pod install` from the Example directory first.\n\n\u003cdiv\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/josejuanqm/VersaPlayer/blob/master/RepoAssets/iphone.png\" /\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n**IMPORTANT:** If you do not have an Apple ID with a developer account for code signing apps, the build  will fail with a code signing error. To work around this, you can delete the \"Code Signing Identity\" build setting of the \"Application\" target to work around the issue.\n\n**Alternatively**, if you do have a developer account, you can create the file \"Examples/Xcode-config/DEVELOPMENT_TEAM.xcconfig\" with the following build setting as its content:\n\u003e DEVELOPMENT_TEAM = [Your TeamID]\n\nFor a more detailed description of this, you can have a look at the comments at the end of the file \"Examples/Xcode-config/Base.xcconfig\". \n\n## Installation\n\n[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects.\nYou can install it with the following command:\n\n```bash\n$ gem install cocoapods\n```\n\nVersaPlayer is available through [CocoaPods](https://cocoapods.org). To install\nit, simply add the following line to your Podfile:\n\n```ruby\npod 'VersaPlayer'\n```\n\n### Carthage\n\n[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate Alamofire into your Xcode project using Carthage, specify it in your `Cartfile`:\n\n```ogdl\ngithub \"josejuanqm/VersaPlayer\" \"3.0.0\"\n```\n\n## Usage\n\n### Basic Usage\n\nVersaPlayer aims to be simple to use but also flexible, to start using VersaPlayer first create a view programatically or via storyboard. Then add this few lines of code to start playing your video.\n\n```swift\n    @IBOutlet weak var playerView: VersaPlayerView!\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        if let url = URL.init(string: \"http://rmcdn.2mdn.net/Demo/html5/output.mp4\") {\n            let item = VersaPlayerItem(url: url)\n            playerView.set(item: item)\n        }\n    }\n```\n\n### Adding Controls\n\nTo add controls for your player use the VersaPlayerControls class, which comes packed with outlets to control your player, you can also add as many as you like by making a custom implementation.\n\nVersaPlayerControls class include the following outlets:\n\nOutlet Name             | Type             |  Action\n------------------------- | ------------------------- | -------------------------\nplayPauseButton | VersaStatefullButton | Toggle playback\nfullscreenButton | VersaStatefullButton | Toggle fullscreen mode\npipButton | VersaStatefullButton | Toggle PIP mode in supported devices\nrewindButton | VersaStatefullButton | Rewind playback\nforwardButton | VersaStatefullButton | Fast forward playback\nskipForwardButton | VersaStatefullButton | Skip forward the time specified in second at skipSize (found in VersaPlayerControls)\nskipBackwardButton | VersaStatefullButton | Skip backward the time specified in second at skipSize (found in VersaPlayerControls)\nseekbarSlider | VersaSeekbarSlider | Seek through playback\ncurrentTimeLabel | VersaTimeLabel | Indicate the current time\ntotalTimeLabel | VersaTimeLabel | Indicate the total time\nbufferingView | UIView | Shown when player is buffering\n\n```swift\n    @IBOutlet weak var playerView: VersaPlayerView!\n    @IBOutlet weak var controls: VersaPlayerControls!\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        playerView.use(controls: controls)\n        if let url = URL.init(string: \"http://rmcdn.2mdn.net/Demo/html5/output.mp4\") {\n            let item = VersaPlayerItem(url: url)\n            playerView.set(item: item)\n        }\n    }\n```\n\n### Advanced Usage\n\n#### DRM\n\nVersaPlayer also brings support for encrypted content, to make use of this functionality you must implement VersaPlayerDecryptionDelegate and assign it to VersaPlayer's decryptionDelegate property.\n\nTo read more about this topic go to:\n\nhttps://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Protocols/VersaPlayerDecryptionDelegate.html\n\n#### Tracks\n\nTo make use of different media tracks, such as audio, video, or captioning, use VersaPlayerMediaTracks, found in VersaPlayer class.\n\nto learn more about this properties go to:\n\nhttps://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Classes/VersaPlayerMediaTrack.html\n\n##### Audio Tracks\n\nAudio tracks are specially helpfull when dealing with different languages, for example for a movie playback. \n\nTo select an audio track simply fetch available tracks with VersaPlayer's audioTracks property.\n\n```swift\n    @IBOutlet weak var playerView: VersaPlayer!\n\n    ...\n    \n    let tracks: [VersaPlayerMediaTrack] = playerView.player.currentItem?.audioTracks\n    /// the name of the track\n    let name = tracks.first?.name\n    /// the language of the track\n    let name = tracks.first?.language\n    /// selecting the first one\n    tracks.first?.select(for: playerView.player)\n```\n\n##### Video Tracks\n\nVideo tracks are most helpfull when dealing with different renditions or different streams per video quality. \n\nTo select an video track simply follow the same principles as an audio track.\n\n```swift\n    @IBOutlet weak var playerView: VersaPlayer!\n\n    ...\n    \n    let tracks: [VersaPlayerMediaTrack] = playerView.player.currentItem?.videoTracks\n    /// the name of the track\n    let name = tracks.first?.name\n    /// selecting the first one\n    tracks.first?.select(for: playerView.player)\n```\n\n##### Caption Tracks\n\nCaption tracks are almost always helpfull. This can be used from a movie playback all the way to assitive content. \n\nTo select an video track simply follow the same principles as video and audio tracks.\n\n```swift\n    @IBOutlet weak var playerView: VersaPlayer!\n\n    ...\n    \n    let tracks: [VersaPlayerMediaTrack] = playerView.player.currentItem?.captionTracks\n    /// the name of the track\n    let name = tracks.first?.name\n    /// the language of the track\n    let name = tracks.first?.language\n    /// selecting the first one\n    tracks.first?.select(for: playerView.player)\n```\n\n###### Caption Styling\n\nCaption styling are not usually managed by the user, but when necessary, captionStyling property from VersaPlayer comes in handy.\n\nExplore all the available attributes that can be changed here:\n\nhttps://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Classes/VersaPlayerCaptionStyling.html\n\n## Extensions\n\nVersa is aimed to be versatile, and that's why it comes with an extensions feature, that lets you customize any aspect of the player by inheriting from VersaPlayerExtension.\n\nThis class comes with a player attribute that points to the player instance from which is being used.\nTo add an extension use the add(extension ext:) method found in https://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Classes/VersaPlayer.html.\n\nHere are some extensions for VersaPlayer that may be useful for you.\n\n1. [AirPlay Extension](https://github.com/josejuanqm/VersaPlayerAirplayExtension)\n\n2. [Ads Extension](https://github.com/josejuanqm/VersaPlayerAdsExtension)\n\n3. [Overlay Content Extension](https://github.com/josejuanqm/VersaPlayerOverlayContentExtension)\n\n\n## Documentation\n\nFull documentation avilable https://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/\n\n## Author\n\nJose Quintero - jose.juan.qm@gmail.com\n\n## Contributors\n\nPeople that make VersaPlayer possible, Thank you!\n\n\u003cspan\u003e\u003ca href=\"https://github.com/josejuanqm\"\u003e\u003cimg src=\"https://github.com/josejuanqm.png\" alt=\"josejuanqm\" width=\"50px\"\u003e\u003c/a\u003e\u003c/span\u003e\n\u003cspan\u003e\u003ca href=\"https://github.com/pbeast\"\u003e\u003cimg src=\"https://github.com/pbeast.png\" alt=\"pbeast\" width=\"50px\"\u003e\u003c/a\u003e\u003c/span\u003e\n\u003cspan\u003e\u003ca href=\"https://github.com/danibachar\"\u003e\u003cimg src=\"https://github.com/danibachar.png\" alt=\"danibachar\" width=\"50px\"\u003e\u003c/a\u003e\u003c/span\u003e\n\u003cspan\u003e\u003ca href=\"https://github.com/HuseyinVural\"\u003e\u003cimg src=\"https://github.com/HuseyinVural.png\" alt=\"HuseyinVural\" width=\"50px\"\u003e\u003c/a\u003e\u003c/span\u003e\n\n## Donation\n\nIf you like this project or has been helpful to you, you can buy me a cup of coffe :)\nAppreciate it!\n\n[![paypal](https://github.com/josejuanqm/VersaPlayer/blob/master/RepoAssets/Artboard.png)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=KGX5UDWNHBRNY)\n\n## License\n\nVersaPlayer is available under the MIT license. See the LICENSE file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosejuanqm%2FVersaPlayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosejuanqm%2FVersaPlayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosejuanqm%2FVersaPlayer/lists"}