From VideoLAN Wiki
Jump to navigation Jump to search

Development environment

To develop VLC for iOS, you need:

  • Mac OS X Lion (or later)
  • Latest XCode version (4.6.3 works so far)
  • A correct shell (we recommend iTerm2 and zsh)
  • CocoaPods (for dependency management)

Get the source

If you want to develop VLC for iOS, it is highly recommended that you use the git version:

git clone git://

Build it

Build it for the simulator.

sh -s

Wait, and grab a coffee.

Manually assign the code sign in Xcode, and build it for devices.


Grab a second coffee. :)

Better to have a look at the usage() function in, you might need -s to enable debug, -l or -n to save some time when you need to rebuild the project.


Open the project in Xcode and click on Run.

If you want to run in the simulator after running without the -s option, you need to run it again with the -s option, and vice versa.

Send patches

You can create patches and send them to our mailing list ios@v.o, or on our IRC.

Please see Git#Submitting_patches on how to send patches...


If everything goes well, congratulations to Lucky You! If not, please report any problem to our mailing list ios@v.o, or on our IRC.

This might help you more than Google, because any lately committing might cause compiling errors(at least these days), although the latest git is supposed to be an all time stable one.


The first version of this howto was written by jb on 18 July 2013.

Last edited by leoujzwiki on 12 Oct 2013.

Previous Version

The old version of the app can be compiled using this howto.