VideoLAN Wiki - User contributions [en]

VLCKit

2009-12-20T18:05:23Z

Global667: /* Sample code */ correcting 2nd path, make more readable

=== Build the framework ===

* open <code>./vlc/projects/macosx/framework/VLCKit.xcodeproj</code>
* make sure the VLCKit target is selected
* rightclick on target and build

this should autatically build vlc itself at the same time in projects/macosx/framework/build/vlc_build_dir
== Basic usage in your application ==
The code should speak by itself
// Set up a videoView by hand. You can also do that in the nib file
videoView = [[VLCVideoView alloc] initWithFrame:[[window contentView] bounds]];
[[window contentView] addSubview:videoView];
[videoView setAutoresizingMask: NSViewHeightSizable|NSViewWidthSizable];

// Init the player object
player = [[VLCMediaPlayer alloc] initWithVideoView:videoView];

[player setMedia:[VLCMedia mediaWithPath:@"/to/my/movie"]];
[player play];

== Sample code ==
You should be able to find sample code in:
* <code> ./vlc/projects/macosx/framework/Examples </code>: This is the folder that contains the VLC.framework basics usage.

* <code> ./vlc/projects/macosx/vlc_app </code>: This is the VLC application that uses the framework intensivly, this is much more advanced.

VLCKit

2009-12-20T16:45:49Z

Global667: /* Build the framework */ debug :(

== How to build the framework ==

Follow the quicksteps for your system on the [[OSXCompile | Building on Mac OS X]] page to build VLC.

If the second make fails, giving you an error like:

ld warning: in ///Users/username/dev/vlc/extras/contrib/lib/libx264.a, file is not of required architecture
Undefined symbols:
"_x264_encoder_close", referenced from:
_Close in libx264_plugin_la-x264.o
etc...

then download and build x264. Then copy libx264.a into vlc/extras/contrib/lib/

=== To build on Snow Leopard with 32-bit ===
On 10.6 64-bit compiling is default and also recommended (see [[OSXCompile | Building on Mac OS X]]). To build with 32-bit you need to set the environment as followed and use the 10.5 Quicksteps instead of the 10.6 one:

$ [...]
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386 -m32"
$ export CXXFLAGS="-arch i386 -m32"
$ export OBJCFLAGS="-arch i386 -m32"
$ export LDFLAGS="-arch i386"
$ [...]

=== Build the framework ===

* open <code>./vlc/projects/macosx/framework/VLCKit.xcodeproj</code>
* make sure the VLCKit target is selected
* rightclick on target and build

== Basic usage in your application ==
The code should speak by itself
// Set up a videoView by hand. You can also do that in the nib file
videoView = [[VLCVideoView alloc] initWithFrame:[[window contentView] bounds]];
[[window contentView] addSubview:videoView];
[videoView setAutoresizingMask: NSViewHeightSizable|NSViewWidthSizable];

// Init the player object
player = [[VLCMediaPlayer alloc] initWithVideoView:videoView];

[player setMedia:[VLCMedia mediaWithPath:@"/to/my/movie"]];
[player play];

== Sample code ==
You should be able to find sample code in:
* Framework/Examples: This is the folder that contains the VLC.framework basics usage.

* vlc-trunk/extras/MacOSX/VLC_app: This is the VLC application that uses the framework intensivly, this is much more advanced.

VLCKit

2009-12-20T16:35:08Z

Global667: /* To build on Snow Leopard with 32-bit */ addition to snow leo

== How to build the framework ==

Follow the quicksteps for your system on the [[OSXCompile | Building on Mac OS X]] page to build VLC.

If the second make fails, giving you an error like:

ld warning: in ///Users/username/dev/vlc/extras/contrib/lib/libx264.a, file is not of required architecture
Undefined symbols:
"_x264_encoder_close", referenced from:
_Close in libx264_plugin_la-x264.o
etc...

then download and build x264. Then copy libx264.a into vlc/extras/contrib/lib/

=== To build on Snow Leopard with 32-bit ===
On 10.6 64-bit compiling is default and also recommended (see [[OSXCompile | Building on Mac OS X]]). To build with 32-bit you need to set the environment as followed and use the 10.5 Quicksteps instead of the 10.6 one:

$ [...]
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386 -m32"
$ export CXXFLAGS="-arch i386 -m32"
$ export OBJCFLAGS="-arch i386 -m32"
$ export LDFLAGS="-arch i386"
$ [...]

=== Build the framework ===

* open <code>./vlc/extras/package/macosx/VLCKit.xcodeproj</code>
* make sure the VLCKit target is selected
* rightclick on target and build

== Basic usage in your application ==
The code should speak by itself
// Set up a videoView by hand. You can also do that in the nib file
videoView = [[VLCVideoView alloc] initWithFrame:[[window contentView] bounds]];
[[window contentView] addSubview:videoView];
[videoView setAutoresizingMask: NSViewHeightSizable|NSViewWidthSizable];

// Init the player object
player = [[VLCMediaPlayer alloc] initWithVideoView:videoView];

[player setMedia:[VLCMedia mediaWithPath:@"/to/my/movie"]];
[player play];

== Sample code ==
You should be able to find sample code in:
* Framework/Examples: This is the folder that contains the VLC.framework basics usage.

* vlc-trunk/extras/MacOSX/VLC_app: This is the VLC application that uses the framework intensivly, this is much more advanced.

Talk:VLCKit

2009-12-20T16:30:42Z

Global667: Created page with '== Sync with OSXCompile == OSXCompile and Mac_OS_X_Framework are redundant in some aspects. For better care I linked it together (only one build howto is to care off) a...'

== Sync with OSXCompile ==

[[OSXCompile]] and [[Mac_OS_X_Framework]] are redundant in some aspects. For better care I linked it together (only one build howto is to care off) and added some news.

--[[User:Global667|Global667]] 16:30, 20 December 2009 (UTC)

VLCKit

2009-12-20T16:26:36Z

Global667: /* How to build the framework */ See discussion

== How to build the framework ==

Follow the quicksteps for your system on the [[OSXCompile | Building on Mac OS X]] page to build VLC.

If the second make fails, giving you an error like:

ld warning: in ///Users/username/dev/vlc/extras/contrib/lib/libx264.a, file is not of required architecture
Undefined symbols:
"_x264_encoder_close", referenced from:
_Close in libx264_plugin_la-x264.o
etc...

then download and build x264. Then copy libx264.a into vlc/extras/contrib/lib/

=== To build on Snow Leopard with 32-bit ===
On 10.6 64-bit compiling is default and also recommended (see [[OSXCompile | Building on Mac OS X]]). To build with 32-bit you need to set the environment as followed:

$ [...]
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386 -m32"
$ export CXXFLAGS="-arch i386 -m32"
$ export OBJCFLAGS="-arch i386 -m32"
$ export LDFLAGS="-arch i386"
$ [...]

=== Build the framework ===

* open <code>./vlc/extras/package/macosx/VLCKit.xcodeproj</code>
* make sure the VLCKit target is selected
* rightclick on target and build

== Basic usage in your application ==
The code should speak by itself
// Set up a videoView by hand. You can also do that in the nib file
videoView = [[VLCVideoView alloc] initWithFrame:[[window contentView] bounds]];
[[window contentView] addSubview:videoView];
[videoView setAutoresizingMask: NSViewHeightSizable|NSViewWidthSizable];

// Init the player object
player = [[VLCMediaPlayer alloc] initWithVideoView:videoView];

[player setMedia:[VLCMedia mediaWithPath:@"/to/my/movie"]];
[player play];

== Sample code ==
You should be able to find sample code in:
* Framework/Examples: This is the folder that contains the VLC.framework basics usage.

* vlc-trunk/extras/MacOSX/VLC_app: This is the VLC application that uses the framework intensivly, this is much more advanced.

Talk:MacOSCompile

2009-12-20T13:32:33Z

Global667: /* Proper way to initialize the environment */ new section

(comments withdrawn)

: First of all, this wiki isn't the correct place to discuss this kind of questions. vlc-devel at videolan is a far better place. Anyway, it's correct that you can use the 10.4u SDK as well. In fact, VLC obviously automatically does so on Intel-based Macs. Concerning your 2nd comment: no further tool beside the default installation to /usr/local is required to build VLC (excepting svn/subversion in rare cases). Any other 3rd party library, which would usually end up in that directory is built and installed inside VLC's code base, in extras/contrib to be precise. That's clearly stated on this HOWTO page. Please mail the mailing list mentioned above for further feedback. Additionally, when complaining about VLC in general or particularly documentation, keep in mind that we're doing this in our spare time and that we aren't required to answer your requests, especially when strangers to this project get demanding and impolite. [[User:Fkuehne|feepk]] 01:27, 1 February 2007 (CET)

== Change how the build intruction are shown --[[User:Pdherbemont|Pdherbemont]] 20:34, 31 May 2007 (CEST) ==
I would suggest we put the build command in some form easier to read, like :

* Build the third party libraries
cd vlc/extras/contrib
./bootstrap
make
* Now build vlc
./bootstrap
./configure
make

(By the way, the current instruction to use make src doesn't work. make alone is sufficient and necessary. --[[User:Chjones|Chjones]] 00:59, 18 June 2008 (CEST))

== Please don't link to subversion --[[User:Pdherbemont|Pdherbemont]] 12:15, 2 May 2008 (CEST) ==

= Compiling VLC on Mac OS X (draft) =
Compiling {{VLC}} on Mac OS X is different from normal compilation on Linux and Mac OS X. We do not use Xcode, nor a simple <code>./configure</code> and <code>make</code>. Below you will find instructions for how to compile VLC on Mac OS X - remember to check the prerequisites before taking the plunge.

If you wish to develop or test please join the vlc-devel mailinglist.

Please do not publish any of the non-released test binaries or svn-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.

== Prerequisites ==
* Mac OS X 10.4.x (Tiger) or 10.5.x (Leopard)
* Xcode 2.4.x or Xcode 2.5

Optional:
* Subversion

Mac OS X 10.4 (Universal) SDK (a part of Xcode) is required to build the external libraries of VLC.

Your GCC version should be set to 4 (the default setting).

Xcode can be found online or on the Developer Tools disc, which accompanied Mac OS X.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

''If building {{VLC}} on Mac OS X 10.5 Leopard, be sure to read the paragraph on this specific version below, before proceeding.''

=== Mac OS X 10.5 Leopard ===
Note, that only VLC's current development trunk can be compiled on Mac OS X 10.5 Leopard. While the 0.8.6 series, when compiled on Tiger, works on Leopard (as expected), no current stable branch compiles on Mac OS X 10.5 Leopard.

As widely published, this version of Mac OS X includes a new release of Xcode, called Xcode 3, which includes many cool new features, but unfortunately, it is incompatible with VLC. You need Xcode 2.5 to compile VLC on Leopard, which can easily be installed in addition to your Xcode 3 tools. However, you need to edit your PATH variable before doing anything with VLC's source. In case that you installed to to the default location (<code>/Xcode2.5</code>) and you are using the default shell (<code>bash</code>), this is pretty simple:

<code>export PATH=/Xcode2.5/bin:/Xcode2.5/sbin:/Xcode2.5/usr/bin:/Xcode2.5/usr/sbin:$PATH</code>

Note that you need to repeat this PATH edit every time you relaunch the shell. You can avoid this by editing your bashrc file. Once Apple releases a fixed linker for Mac OS X Leopard, this work-around will not be necessary anymore and you can use Xcode 3 as expected.

Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

=== Regarding Fink ===
If you have Fink installed, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

== Steps ==

Please follow these steps for compiling:

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] using [[subversion]] (as described on the [[GetTheSource| "Get the source"]] page) or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

These instructions below are always for the currently unstable, non-released code.

If you compile from [[Subversion]] then please remember that this code can often be in an unstable state.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* cd to the extras/contrib subdir of VLC and execute <code>./bootstrap</code>
* Now execute <code>make src</code>. This will download and compile all the required external libraries and programs. You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)
''If bootstrap exits with an error message on Mac OS X Leopard, check the paragraph on this version above.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory. If you use Subversion (which you really should), then run <code>./bootstrap</code>.

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Configure the VLC build ===

The next step is to configure, in the top level VLC source directory.

In current trunk revisions, you can simply run <code>./configure --enable-debug --with-macosx-sdk</code> to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run <code>make VLC-release.app</code> afterwards. Use the resulting ''VLC-release.app'' for these purposes.

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and Derk-Jan Hartman, for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]]. Edited by Jesper Stemann Andersen.

[[Category:Building]]
[[Category:Coding]]

== regarding "How to disable Fink" ==

On 10.5.6 with current fink I found the fink initialization in .profile as
<code>test -r /sw/bin/init.sh && . /sw/bin/init.sh</code>

Suggested new wording:

''To disable Fink comment the line: ''<code>#source /sw/bin/init.csh</code>'' in your .cshrc file or ''<code> . /sw/bin/init.csh</code>'' in your .bashrc file or ''<code> test -r /sw/bin/init.sh && . /sw/bin/init.sh</code>'' in your .profile file in your home-directory.''

== Proper way to initialize the environment ==

On my point of view its not a good idea to skip

<code>
export CFLAGS="-arch *"

export CXXFLAGS="-arch *"

export LDFLAGS="-arch *"

export OBJCFLAGS="-arch *"
</code>

Without, my system will get confused and secondary its the most proper way to initialize the environment.

Greets

MacOSCompile

2009-12-20T13:03:52Z

Global667: /* Prepare Mac OS X for build VLC */

== Prepare Mac OS X for build VLC ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code. If you compile from [[Git]] then please remember that this code can often be in an unstable state so ''don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.''

* If you wish to develop or test please join the [http://www.videolan.org/developers/lists.html vlc-devel mailinglist ].
* If you doesn't have installed '''Developer Tools from Apple''' do this now: http://developer.apple.com/technology/xcode.html 
* If you doesn't have installed '''Git''' do this now: http://git-scm.com/

== Quick Steps on Mac OS X.5 ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386"
$ export CXXFLAGS="-arch i386"
$ export LDFLAGS="-arch i386"
$ export OBJCFLAGS="-arch i386"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap
$ make

Build VLC:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug
$ make

Add needed libs to VLC.app:

$ make VLC-release.app

== Quick Steps on Mac OS X.6 ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch x86_64"
$ export CXXFLAGS="-arch x86_64"
$ export LDFLAGS="-arch x86_64"
$ export OBJCFLAGS="-arch x86_64"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap x86_64-apple-darwin10
$ make -j2

Build VLC:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug --host=x86_64-apple-darwin10
$ make -j2

Add needed libs to VLC.app:

$ make VLC-release.app

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]

MacOSCompile

2009-12-20T12:28:07Z

Global667: Add 10.6 support

== Prepare Mac OS X for build VLC ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code. If you compile from [[Git]] then please remember that this code can often be in an unstable state so ''don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.''

* If you wish to develop or test please join the [http://www.videolan.org/developers/lists.html vlc-devel mailinglist ].
* If you doesn't have installed '''Developer Tools from Apple''' do this now: http://developer.apple.com/technology/xcode.html 
* If you doesn't have installed '''Git''' do this now: http://git-scm.com/
* Be sure to read the paragraph on Mac OS X Leopard before starting the compilation.

== Quick Steps on Mac OS X.5 ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386"
$ export CXXFLAGS="-arch i386"
$ export LDFLAGS="-arch i386"
$ export OBJCFLAGS="-arch i386"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap
$ make

Build VLC:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug
$ make

Add needed libs to VLC.app:

$ make VLC-release.app

== Quick Steps on Mac OS X.6 ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch x86_64"
$ export CXXFLAGS="-arch x86_64"
$ export LDFLAGS="-arch x86_64"
$ export OBJCFLAGS="-arch x86_64"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap x86_64-apple-darwin10
$ make -j2

Build VLC:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug --host=x86_64-apple-darwin10
$ make -j2

Add needed libs to VLC.app:

$ make VLC-release.app

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]

MacOSCompile

2009-12-20T12:25:50Z

Global667: /* Quick Steps */

== Prepare Mac OS X for build VLC ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code. If you compile from [[Git]] then please remember that this code can often be in an unstable state so ''don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.''

* If you wish to develop or test please join the [http://www.videolan.org/developers/lists.html vlc-devel mailinglist ].
* If you doesn't have installed '''Developer Tools from Apple''' do this now: http://developer.apple.com/technology/xcode.html 
* If you doesn't have installed '''Git''' do this now: http://git-scm.com/
* Be sure to read the paragraph on Mac OS X Leopard before starting the compilation.

== Quick Steps on Mac OS X.5 ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386"
$ export CXXFLAGS="-arch i386"
$ export LDFLAGS="-arch i386"
$ export OBJCFLAGS="-arch i386"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap
$ make

Build VLC:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug
$ make

Add needed libs to VLC.app:

$ make VLC-release.app

Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]

MacOSCompile

2009-12-20T10:57:14Z

Global667: /* Quick Steps */

== Prepare Mac OS X for build VLC ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code. If you compile from [[Git]] then please remember that this code can often be in an unstable state so ''don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.''

* If you wish to develop or test please join the [http://www.videolan.org/developers/lists.html vlc-devel mailinglist ].
* If you doesn't have installed '''Developer Tools from Apple''' do this now: http://developer.apple.com/technology/xcode.html 
* If you doesn't have installed '''Git''' do this now: http://git-scm.com/
* Be sure to read the paragraph on Mac OS X Leopard before starting the compilation.

== Quick Steps ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386"
$ export CXXFLAGS="-arch i386"
$ export LDFLAGS="-arch i386"
$ export OBJCFLAGS="-arch i386"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap
$ make

Build VLC:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug
$ make

Add needed libs to VLC.app:

$ make VLC-release.app

Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]

MacOSCompile

2009-12-20T10:42:14Z

Global667: Clearing the preparation issues

== Prepare Mac OS X for build VLC ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code. If you compile from [[Git]] then please remember that this code can often be in an unstable state so ''don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.''

* If you wish to develop or test please join the [http://www.videolan.org/developers/lists.html vlc-devel mailinglist ].
* If you doesn't have installed '''Developer Tools from Apple''' do this now: http://developer.apple.com/technology/xcode.html 
* If you doesn't have installed '''Git''' do this now: http://git-scm.com/
* Be sure to read the paragraph on Mac OS X Leopard before starting the compilation.

== Quick Steps ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386"
$ export CXXFLAGS="-arch i386"
$ export LDFLAGS="-arch i386"
$ export OBJCFLAGS="-arch i386"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap
$ make

Build vlc:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug
$ make

Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]

MacOSCompile

2009-12-20T10:20:28Z

Global667: /* Compile VLC on Mac OS X */ link added

== Compile VLC on Mac OS X ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code.

If you compile from [[Git]] then please remember that this code can often be in an unstable state. If you wish to develop or test please join the [http://www.videolan.org/developers/lists.html vlc-devel mailinglist ].

Don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.

''Be sure to read the paragraph on Mac OS X Leopard before starting the compilation.''

== Quick Steps ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386"
$ export CXXFLAGS="-arch i386"
$ export LDFLAGS="-arch i386"
$ export OBJCFLAGS="-arch i386"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap
$ make

Build vlc:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug
$ make

Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]

MacOSCompile

2009-12-20T10:15:30Z

Global667: /* Quick Steps */ Yet a better Quicksteps tut

== Compile VLC on Mac OS X ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code.

If you compile from [[Git]] then please remember that this code can often be in an unstable state. If you wish to develop or test please join the vlc-devel mailinglist.

Don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.

''Be sure to read the paragraph on Mac OS X Leopard before starting the compilation.''

== Quick Steps ==
Configure the environment:

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ export CFLAGS="-arch i386"
$ export CXXFLAGS="-arch i386"
$ export LDFLAGS="-arch i386"
$ export OBJCFLAGS="-arch i386"

Download the sources from repository:

$ git clone git://git.videolan.org/vlc.git

Build needed additional libs:

$ cd vlc/extras/contrib
$ ./bootstrap
$ make

Build vlc:

$ cd ../..
$ ./bootstrap
$ ./configure --enable-debug
$ make

Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]

MacOSCompile

2009-12-20T10:06:51Z

Global667: /* Quick Steps */ Prober...

== Compile VLC on Mac OS X ==

Compiling {{VLC}} on Mac OS X is different from normal linux compiling and OS X compiling. We do not use Xcode, but a simple <code>./configure</code> and then <code>make</code> isn't enough either. The instructions below are always for the currently unstable, non-released code.

If you compile from [[Git]] then please remember that this code can often be in an unstable state. If you wish to develop or test please join the vlc-devel mailinglist.

Don't put any of the non-released test binaries or git-compiles on software sites or on user-forums. We have had bad experiences with this before and we do not appreciate it.

''Be sure to read the paragraph on Mac OS X Leopard before starting the compilation.''

== Quick Steps ==
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

$ git clone git://git.videolan.org/vlc.git
$ cd vlc/extras/contrib
$ ./bootstrap
$ make

$ cd ../..
$ ./bootstrap

$ ./configure --enable-debug

$ make
Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

Install the Mac OS X Developer Tools from the Developer Tools CD, or get them online.

You need at least Mac OS X 10.5 and Xcode 3.1.2 for compilation. Mac OS X 10.6 and its Xcode releases are also supported. Make sure that the LLVM GCC 4.2 compiler is installed.

Compiling with earlier releases of Mac OS X and/or Xcode will not work.

Additionally, you may need to install Subversion (SVN) and more importantly Git on your Mac.

=== Get the source ===
Download the {{VLC}} [[GetTheSource|source code]] (using [[Git]]) as described on the [[GetTheSource| "Get the source"]] page or get a recent source tarball. Note that the 3rd party libraries will probably break a few months after the release's publication.

=== Build external libs ===

We now need to build the [[Contrib_Status| 3rd party libs]]. For that, you will need to:
* cd to the source directory with your Terminal application.
* If you have fink, then you will need to disable it. {{VLC}} has it's own form of Fink (in the extras/contrib subdir) and it can conflict with Fink. We use this system to generate a reliable, consistent and known amount of packages that {{VLC}} requires.

''To disable Fink comment the line: #source /sw/bin/init.csh in your .cshrc file or . /sw/bin/init.csh in your .bashrc file in your home-directory.''

* First fetch the contribs. Those are external libraries needed by VLC.
$ cd extras/contrib
$ ./bootstrap
$ make

The last command will download '''prebuilt''' binary contrib you can happily use to build VLC wth -- only if you're using git master branch or the bugfix branch for 0.9 / 1.0.
You will only have to do this once. (You can do it again if required libraries are added or updated by the team.)

If you're trying to debug these libraries or want to create a new package, you need to execute <code>make src</code>

''Note that the 10.5 SDK is used by default. If you encounter problems, make sure that the script correctly used Apple's llvm-gcc-4.2 compiler and your Xcode installation is up-to-date.''

=== Prepare the VLC build ===
Now we return to VLC itself. Go back to the top level VLC source directory.
$ cd ../..
$ ./bootstrap

This will create configure and Makefiles for {{VLC}} (snapshots and releases already include this).

=== Setup the correct compiler ===
Current revisions of VLC need to be compiled using Apple's llvm-gcc-4.2 compiler in its latest version. In case of failures, make sure that the latest version of Xcode is installed.
To use this compiler, you need to export the respective variables. In a Bourne Shell, type this (if Xcode is installed to its default location; bash is the default shell on OS X):

$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2

If you are using a C-Shell, you need to use the ''setenv'' command of course.

=== Configure the VLC build ===
The next step is to configure, in the top level VLC source directory.

In current revisions, you can simply run
$ ./configure --enable-debug
to get VLC in its default configuration. If do not want to use VLC's default configuration for Mac, be sure to add <code>--disable-macosx-defaults</code> to your custom set. Using <code>--disable-nls</code> will save you a lot of time, if you don't care about localised interfaces.

When compiling earlier revisions or the 0.8.6 branch, you need to give a wide variety of configure flags to achieve a useful build. We used to use this set:
<code> ./configure --enable-debug --disable-x11 --disable-xvideo --disable-glx --enable-sdl --enable-mad --enable-libdvbpsi --enable-a52 --disable-dvdplay --enable-dvdnav --enable-dvdread --enable-ffmpeg --enable-faad --enable-flac --enable-vorbis --enable-speex --enable-theora --enable-ogg --enable-shout --enable-cddb --disable-cddax --enable-vcdx --disable-skins --disable-skins2 --disable-wxwidgets --enable-freetype --enable-fribidi --enable-caca --enable-live555 --enable-dca --enable-goom --enable-modplug --enable-gnutls --enable-daap --enable-ncurses --enable-libtwolame --enable-x264 --enable-png --enable-realrtsp --enable-lua --disable-libtool</code>
Have a look at configure.ac for our current default configuration.

You can add <code>--with-mozilla-sdk-path=./extras/contrib/gecko-sdk --enable-mozilla</code> to the configure-line to enable the compilation of VLC's Safari/Firefox plugin.

=== Build VLC ===
After configure is finished, we can finally build {{VLC}}. A simple <code>make</code> will do the trick. If you want to use the resulting application package on a different Mac or a different account on the same Mac, run
$ make
$ make VLC-release.app
afterwards. Use the resulting ''VLC-release.app'' for these purposes.

If you want a disk-image, type
$ make package-macosx
(respectively <code>make package-macosx-plugin</code> for the Safari/Mozilla plugin).

=== What's wrong, if I don't succeed? ===
Starting with Leopard, Xcode may be installed to a custom location on the administrator's choice. While this is non-problematic for ordinary Xcode projects, VLC needs a little help. You have to place extra symbolic links in /Developer pointing to your custom location for these folders:

<code>usr, Headers, Private, SDKs, Tools, Makefiles</code>

You can easily create these links by executing the following command for each folder (whereas theFolder is one of these six):

<code>ln -s /full/path/to/Developer/theFolder /Developer/theFolder</code>

'''Additionally, make always sure that you are using the latest version of Xcode. Otherwise, VLC's compilation or behaviour at runtime won't be the way you want it to be.'''

== What about 64-bit? ==
Both the 1.0-bugfix branch and the master branch can be compiled in 64-bit mode on OS X, but it is considered experimental. This is only tested for x86_64, but PPC64 should also work. Precompiled contribs are usually available for x86_64. To see how to compile VLC this way, check the documentation of your GCC vendor, as there are known differences within the supported versions of Mac OS X, but you may try:

'''After running bootstrap in extras/contrib''': Replace the first line of config.mak to <code>ARCH=x86_64</code> from <code>ARCH=i386</code>. Running <code>make</code> after only this change should cause the precompiled x86_64 contrib to be downloaded and extracted. (If you're compiling your own contrib, you should edit <code>CFLAGS_TUNING</code> and <code>EXTRA_LDFLAGS</code> to use x86_64, and you may also want to change <code>CC</code> and <code>CXX</code> to use llvm versions.)

'''Running configure''': Do something like <code>./configure CFLAGS="-arch x86_64" CXXFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" OBJCFLAGS="-arch x86_64" --build=x86_64-apple-darwin9.7.0</code> instead. Not all these flags may be necessary.

== Snow Leopard ==
A series of problem affect the build under Mac OS X 10.6 (Snow Leopard / darwin 10), these include:

=== 32-bit builds ===
The compiler now tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

=== Missing libiconv.la ===
The <code>/usr/lib/libiconv.la</code> file has been removed, but the other .la files in contrib still reference it; the quickest way to fix this is <code>rm extras/contrib/lib/*.la</code> (this should lead no negative consequences because OSX's dylib already provide dependency tracking).

== History ==
Written by Jean-Alexis Montignies, [[User:Fkuehne|Felix Paul Kühne]] and [[User:The DJ|Derk-Jan Hartman]], for the VideoLAN Team.
Adapted to the Wiki by [[User:j-b|Jean-Baptiste Kempf]].

[[Category:Building]]
[[Category:Coding]]