vlc-ios

VLC for iOS & tvOS

This repository has the source code of VLC for iOS and tvOS application.

It's currently written in Objective-C / Swift and uses VLCKit, a libvlc wrapper.

• Requirements
• Building
  • VLC-iOS
  • Custom VLCKit
• Contribute
• Communication
  • Forum
  • Issues
  • IRC
• Code of Conduct
• License
• More

Requirements

• Xcode 9.0+
• macOS 10.12+
• Cocoapods 1.4+

Building

VLC-iOS

1. Run pod install.
2. Open VLC.xcworkspace.
3. Hit "Build and Run".

Custom VLCkit

Mostly for debugging or advanced users, you might want to have a custom local VLCKit build.

1. Clone VLCKit:

   git clone https://code.videolan.org/videolan/VLCKit.git

2. Inside the VLCKit folder, run the following command:

   ./buildMobileVLCKit.sh -a ${MYARCH}

   MYARCH can be i386 x86_64 armv7 armv7s or aarch64.

   Add -d for a debug build (to have valid stack straces and asserts).

   Add -n if you want to use you own VLC repository for VLCKit (See VLCKit README.md).

3. Replace the MobileVLCKit.framework with the one you just build.

   Inside your vlc-ios folder, after a pod update, do:

   cd Pods/MobileVLCKit-unstable/MobileVLCKit-binary

   rm -rf MobileVLCKit.framework

   ln -s ${VLCKit}/build/MobileVLCKit.framework

4. Hit "Build and Run".

Contribute

Pull request

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

Gitlab issues

You can look through issues we currently have on the VideoLAN Gitlab.

A beginner friendly tag is available if you don't know where to start.

Communication

Forum

If you have any question or you're not sure it's an issue please visit our forum.

Issues

You have encountered an issue and wish to report it to the VLC dev team?

You can create an issue on our Gitlab or on our bug tracker.

Before creating an issue or ticket, please double check of duplicates!

IRC

Want to quickly get in touch with us for a question, or even just to talk?

You will always find someone of the VLC team on IRC, #videolan channel on the freenode network.

For VLC-iOS specific questions you can find us on #vlc-ios.

If you don't have an IRC client, you can always use the freenode webchat.

Code of Conduct

Please read and follow the VideoLAN CoC.

License

VLC-iOS is under the GPLv2 (or later) and the MPLv2 license.

See COPYING for more license info.

More

For everything else, check our wiki or our support page.

We're happy to help!