Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dklinzh/VLCKit
A powerful library of audio/video on iOS, macOS and tvOS. Fork from https://code.videolan.org/videolan/VLCKit. Official mirror https://github.com/videolan/vlckit.
https://github.com/dklinzh/VLCKit
audio ios macos media-player streaming tvos video vlc vlckit
Last synced: 28 days ago
JSON representation
A powerful library of audio/video on iOS, macOS and tvOS. Fork from https://code.videolan.org/videolan/VLCKit. Official mirror https://github.com/videolan/vlckit.
- Host: GitHub
- URL: https://github.com/dklinzh/VLCKit
- Owner: dklinzh
- License: lgpl-2.1
- Created: 2016-10-24T06:17:36.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-09-01T02:45:52.000Z (over 6 years ago)
- Last Synced: 2024-08-07T23:57:47.475Z (5 months ago)
- Topics: audio, ios, macos, media-player, streaming, tvos, video, vlc, vlckit
- Language: Objective-C
- Homepage:
- Size: 3.2 MB
- Stars: 11
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: COPYING
Awesome Lists containing this project
README
| | Platform | Master | Cocoapods |
| ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| VLCKit |  |  | [](https://cocoapods.org/pods/VLCKit) |
| MobileVLCKit |  |  | [](https://cocoapods.org/pods/MobileVLCKit) |
| TVVLCKit |  |  | [](https://cocoapods.org/pods/TVVLCKit) |
- [Features](#features)
- [Use-case](#use-case)
- [Requirements](#requirements)
- [Installation](#installation)
- [Cocoapods](#cocoapods)
- [Carthage](#carthage)
- [Build](#build)
- [Default](#default)
- [Build with your own VLC repository](#build-with-your-own-vlc-repository)
- [Contribute](#contribute)
- [Pull Request](#pull-request)
- [GitLab Issues](#gitlab-issues)
- [Patches](#patches)
- [FAQ](#faq)
- [Communication](#communication)
- [Forum](#forum)
- [Issues](#issues)
- [IRC](#irc)
- [License](#license)
- [Further reading](#further-reading)
**VLCKit** is a generic multimedia library for any audio or video playback needs on macOS, iOS and tvOS.
## Features
- Based on **libVLC**, the engine of the popular media player *VLC*
- Supports playback, active streaming, and media to file conversations on the Mac
- Open-source software licensed under [LGPLv2.1](http://opensource.org/licenses/LGPL-2.1/) or later, available in source code and binary form from [VideoLAN's website](http://www.videolan.org/).
- Easily integratable via [CocoaPods](http://cocoapods.org/)
## Use-case
When will you need VLCKit? Frankly, you will need it whenever you need to play media not supported by QuickTime / AVFoundation or if you require more flexibility.
Here are some other common use-cases
- Playing something else besides H264/AAC files or HLS streams
- Need subtitles beyond QuickTime’s basic support for Closed Captions
- Your media source is neither your mobile device nor a basic HTTP server, but a live stream hailing from some weird media server or even a raw DVB signal broadcasted on a local network
- and more!
## Requirements
- iOS 8.0 + / macOS 10.9+ / tvOS 10.2+
- Xcode 9.0+
- Cocoapods 1.4+
## Installation
### Cocoapods
[CocoaPods](http://cocoapods.org/) is a dependency manager for Cocoa projects. You can install it with the following command,
```bash
$ gem install cocoapods
```
To integrate VLCKit into your project, specify it in your `Podfile`,
```ruby
source 'https://github.com/CocoaPods/Specs.git'
target '' do
platform :macos, '10.9'
pod 'VLCKit', '3.1.2'
end
target '' do
platform :ios, '8.0'
pod 'MobileVLCKit', '3.1.2'
end
target '' do
platform :tvos, '9.0'
pod 'TVVLCKit', '3.1.2'
end
```
Then, run the following command,
```bash
$ pod install
```
### Carthage
[Carthage](https://github.com/Carthage/Carthage) is a way to add frameworks to your Cocoa application. You can install it with the following command,
```bash
brew install carthage
```
To integrate VLCKit into your project, specify it in your `Cartfile`. The URL depends on your target OS.
iOS:
```
binary "https://code.videolan.org/videolan/VLCKit/raw/master/Packaging/MobileVLCKit.json" ~> 3.1.4
```
macOS:
```
binary "https://code.videolan.org/videolan/VLCKit/raw/master/Packaging/VLCKit.json" ~> 3.1.4
```
tvOS:
```
binary "https://code.videolan.org/videolan/VLCKit/raw/master/Packaging/TVVLCKit.json" ~> 3.1.4
```
Then, run the following command,
```bash
carthage update
```
Note that the following system dependencies are required and need to be linked into the project:
* AudioToolbox.framework
* AVFoundation.framework
* CFNetwork.framework
* CoreFoundation.framework
* CoreGraphics.framework
* CoreMedia.framework
* CoreText.framework
* CoreVideo.framework
* Foundation.framework
* libbz2.tbd
* libiconv.tbd
* OpenGLES.framework
* QuartzCore.framework
* Security.framework
* VideoToolbox.framework
On iOS and tvOS, you also need to link:
* UIKit.framework
## Build
### Default
Run `compileAndBuildVLCKit.sh` with the `-a ${ARCH}` option to specify the target architecture.
More information can be found under `./compileAndBuildVLCKit.sh -h`
### Build with your own VLC repository
1. Put a vlc repository inside libvlc/vlc
`mkdir libvlc && cd libvlc && ln -s ${MYVLCGIT}`
2. Apply VLC patches needed for VLCKit
`cd vlc`
`git am ../../Resources/MobileVLCKit/patches/*`
3. run `compileAndBuildVLCKit.sh` with the `-n` and the `-a ${ARCH}` option
## Contribute
As VLCKit is an open-source project hosted by VideoLAN, we happily welcome all kinds of contributions.
### Pull Request
Pull requests are more than welcome! If you do submit one, please make sure to use a descriptive title and description.
### GitLab Issues
You can look through the currently open [issues on GitLab](https://code.videolan.org/videolan/vlckit/issues/) and choose the one that interests you the most.
### Patches
If you like the more classic apporach, you can submit patches!
For detailed explanation on how to do so, please read our wiki page on [how to send patches](https://wiki.videolan.org/Sending_Patches_VLC/).
## FAQ
> Q. Since this isn't under the MIT license, is there something special I should know?
The [LGPLv2.1](http://opensource.org/licenses/LGPL-2.1/) allows our software to be included in proprietary apps, *as long as you follow the license.* Here are some key points you should be aware of.
- Make sure to publish any potential changes you do to our software
- Make sure that the end-user is aware that VLCKit is embedded within your greater work
- Make sure that the end-user is aware of the gained rights and is granted access to our code as well as to your additions to our work
For further details, please read the license and consult your lawyer with any questions you might have.
## Communication
### Forum
If you ever need help, feel free to reach out. The [web forum](http://forum.videolan.org/) is always there for you.
### Issues
Did you find a bug and want to report it to us? You can create an issue on [GitLab](https://code.videolan.org/videolan/vlckit/issues/) or on our [bug tracker](https://trac.videolan.org/vlc/).
### IRC
Do you have a pressing question or just want to talk? Reach out to us via our IRC channel on the [freenode](http://www.freenode.net/) network's **#videolan** channel.
If you don't have an IRC client at hand, use the [freenode webchat](http://webchat.freenode.net/).
## License
VLCKit is under the [LGPLv2.1](http://opensource.org/licenses/LGPL-2.1/) license.
See [COPYING](./COPYING) for more license info.
## Further reading
You can find more documentation on the [VideoLAN wiki](https://wiki.videolan.org/VLCKit/).