Repository files navigation

VLCKit is a generic multimedia library for any audio or video playback needs on macOS, iOS and tvOS.

	Platform	Cocoapods
VLCKit
MobileVLCKit
TVVLCKit

• Features
• Use-case
• Requirements
• Installation
  • Cocoapods
  • Carthage
• Documentation
• Build
  • Default
  • Build with your own VLC repository
• Contribute
  • Pull Request
  • GitLab Issues
  • Patches
• FAQ
• Communication
  • Forum
  • Issues
  • IRC
• License
• Further reading

• Wrapper oflibVLC, the engine of the popular media playerVLC.
• Supports playback, active streaming, and media to file conversations on the Mac.
• Open-source software licensed underLGPLv2.1 or later, available in source code and binary form fromVideoLAN's website.
• Easily integratable viaCocoaPods.

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!

• iOS 8.4 + / macOS 10.9+ / tvOS 10.2+
• Xcode 9.0+
• Cocoapods 1.4+
• Python 3.7 (compile time only)

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

gem install cocoapods

To integrate the latest VLCKit into your project, specify it in yourPodfile:

source'https://github.com/CocoaPods/Specs.git'target'<macOS Target>'doplatform:macos,'10.9'pod'VLCKit','~>3.3.0'endtarget'<iOS Target>'doplatform:ios,'8.4'pod'MobileVLCKit','~>3.3.0'endtarget'<tvOS Target>'doplatform:tvos,'10.2'pod'TVVLCKit','~>3.3.0'end

Then, run the following command:

pod install

Carthage is a way to add frameworks to your Cocoa application. You can install it with the following command:

brew install carthage

To integrate VLCKit into your project, specify it in yourCartfile. The URL depends on your target OS.

iOS:

binary "https://code.videolan.org/videolan/VLCKit/raw/master/Packaging/MobileVLCKit.json" ~> 3.3.0

macOS:

binary "https://code.videolan.org/videolan/VLCKit/raw/master/Packaging/VLCKit.json" ~> 3.3.0

tvOS:

binary "https://code.videolan.org/videolan/VLCKit/raw/master/Packaging/TVVLCKit.json" ~> 3.3.0

Then, run the following command:

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
• libc++.tbd
• libiconv.tbd
• libxml2.tbd
• OpenGLES.framework
• QuartzCore.framework
• Security.framework
• VideoToolbox.framework

On iOS and tvOS, you also need to link:

• UIKit.framework

API documentation of VLCKit is availableonline and within both the source code as well as binary downloads. Except as indicated, all the APIs are the same on macOS, iOS and tvOS.

Make sure that Python 3.7 is installed. Get the package fromhttps://www.python.org - do NOT use homebrew for installation as it will be ignored by VLC's build process.

RuncompileAndBuildVLCKit.sh with the-a ${ARCH} option to specify the target architecture.

More information can be found under./compileAndBuildVLCKit.sh -h.

1. Put a VLC repository insidelibvlc/vlc.

   mkdir libvlc && cd libvlc && ln -s "PATH_TO_VLC"

2. Apply VLC patches needed for VLCKit.

   cd vlc

   git am ../libvlc/patches/*

3. runcompileAndBuildVLCKit.sh with the-n option.

As VLCKit is an open-source project hosted by VideoLAN, we happily welcome all kinds of contributions.

Pull requests are more than welcome! If you do submit one, please make sure to use a descriptive title and description.

You can look through the currently openissues on GitLab and choose the one that interests you the most.

If you like the more classic approach, you can submit patches!

For detailed explanation on how to do so, please read our wiki page onhow to send patches.

Q. Since this isn't under the MIT license, is there something special I should know?

TheLGPLv2.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.

If you ever need help, feel free to reach out. Theforum is always there for you.

Did you find a bug and want to report it to us? You can create an issue onGitLab or on ourbug tracker.

Do you have a pressing question or just want to talk? Reach out to us via our IRC channel on thefreenode network's#videolan channel.

If you don't have an IRC client at hand, use thefreenode webchat.

For matters related to the VLCKit and LibVLC APIs, join our LibVLC bindings Community Discord Server!

VLCKit is under theLGPLv2.1 license.

SeeCOPYING for more license info.

You can find more documentation on theVideoLAN wiki.