Без опису

Felix Paul Kühne 1efbeed00c libvlc: update tested hash and patches 5 роки тому
.circleci 3dd80ca65a CircleCi: bump Xcode and install python to fix the CI 6 роки тому
Examples 83b9f1cdc7 iOS sample code: update video cropping code to v4 API 6 роки тому
Headers 85d2f5b513 VLCMedia: remove statistics no longer provided by libvlc 5 роки тому
MobileVLCKit.xcodeproj 0b8c3730d8 Remove support for ARMv7s 5 роки тому
Packaging a246516cd5 Add new versions in MobileVLCKit.json 5 роки тому
Resources 9a5d53ecc5 libvlc: move patches to a different places as they are no longer specific to MVK 6 роки тому
Sources 85d2f5b513 VLCMedia: remove statistics no longer provided by libvlc 5 роки тому
Tests 216ca08409 DynamicMobileVLCKit: add missing headers and add to tests 6 роки тому
VLCKit.xcodeproj 010946baa9 Update and simplify compilation script 5 роки тому
doc 5102ce3e74 Documentation: update doxygen Documentation 6 роки тому
libvlc 1efbeed00c libvlc: update tested hash and patches 5 роки тому
.gitignore 14a6f2f7bc Update .gitignore 6 роки тому
.mailmap a7a358e6a1 Update mailmap 7 роки тому
CONTRIBUTING.md 5335668a8d Add contribution guide 9 роки тому
COPYING fafb6def60 VLCKit: add proper licensing file 12 роки тому
Gemfile 53dfdb4b4e Tests: Add code coverage 7 роки тому
Gemfile.lock 53dfdb4b4e Tests: Add code coverage 7 роки тому
Makefile dc8d8b6ee0 Add packaging script for VLCKit and MobileVLCKit (close #9099) 11 роки тому
NEWS a8688134c5 NEWS: merge news from 3.0 branch and add stub for 4.0 5 роки тому
README.md 5a3d1286e1 README: Update style 6 роки тому
Rakefile 3dd80ca65a CircleCi: bump Xcode and install python to fix the CI 6 роки тому
compileAndBuildVLCKit.sh 1efbeed00c libvlc: update tested hash and patches 5 роки тому
documentation.html 09dc80cf40 Add symlink to make documentation accessible 9 роки тому
doxygen.conf ceda117844 Add doxygen configuration 9 роки тому

README.md

VLCKit logo

#

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

Platform Master Cocoapods
VLCKit Platform CircleCI VLCKit is CocoaPods Compatible
MobileVLCKit Platform CircleCI MobileVLCKit is CocoaPods Compatible
TVVLCKit Platform CircleCI TVVLCKit is CocoaPods Compatible

Table of content

Features

  • Wrapper of 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 or later, available in source code and binary form from VideoLAN's website.
  • Easily integratable via CocoaPods.

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.4 + / macOS 10.9+ / tvOS 10.2+
  • Xcode 9.0+
  • Cocoapods 1.4+
  • Python 3.7 (compile time only)

Installation

Cocoapods

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 your Podfile:

source 'https://github.com/CocoaPods/Specs.git'

target '<macOS Target>' do
    platform :macos, '10.9'
    pod 'VLCKit', '3.3.0'
end

target '<iOS Target>' do
    platform :ios, '8.4'
    pod 'MobileVLCKit', '3.3.0'
end

target '<tvOS Target>' do
    platform :tvos, '10.2'
    pod 'TVVLCKit', '3.3.0'
end

Then, run the following command:

pod install

Carthage

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 your Cartfile. 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
  • libiconv.tbd
  • OpenGLES.framework
  • QuartzCore.framework
  • Security.framework
  • VideoToolbox.framework

On iOS and tvOS, you also need to link:

  • UIKit.framework

Build

Default

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

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 "PATH_TO_VLC"

  2. Apply VLC patches needed for VLCKit.

    cd vlc

    git am ../../Resources/MobileVLCKit/patches/*

  3. run compileAndBuildVLCKit.sh with the -n 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 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.

FAQ

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

The LGPLv2.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 forum 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 or on our bug tracker.

IRC

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

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

License

VLCKit is under the LGPLv2.1 license.

See COPYING for more license info.

Further reading

You can find more documentation on the VideoLAN wiki.