Newer Older
1 2 3
Hacking vlc

4 5 6 7 8

 - Read this file

 - Read the information present on http://www.videolan.org/developers/
10 11


James Bond's avatar
James Bond committed
You will need the following tools if you plan to use the GIT version of vlc:

Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
17 18
 - Autoconf version 2.60 or later
 - Automake version 1.9 or later
 - gettext version 0.16.1 or later
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
 - pkg-config

James Bond's avatar
James Bond committed
After retrieving the GIT tree, you need to run the bootstrap script to
generate all the files needed to build vlc. You can then run configure.
Run ./configure --help for a description of the available options.
25 26 27

If you do not have the correct version of these tools, or if they are
simply not available for the operating system you plan to develop on,
James Bond's avatar
James Bond committed
you can check out a GIT tree on an OS that provides these tools (such
29 30 31
as a recent Linux distribution), run bootstrap, and then copy the whole
tree to your retarded OS.

32 33 34 35 36 37
There is a possibility that, at some point, automake might segfault. The
reason is unsufficient stack size, and can be easily fixed with the
`ulimit` command (or an equivalent) available in most shells. For instance
on bash 2.0, the following command solves the automake crash on Mac OS X :
ulimit -s 20000

38 39 40 41 42 43

The bootstrap sequence

The bootstrap script does the following actions:

Sam Hocevar's avatar
Sam Hocevar committed
44 45 46 47
 - parse configure.ac for all Makefiles in the modules/ directory that need
   to be generated, and look for available modules in the corresponding
   Modules.am file. A module "foo" exists if there is a Modules.am file in
   the modules/ directory which defines SOURCES_foo.

Sam Hocevar's avatar
Sam Hocevar committed
49 50 51 52
 - create an m4/private.m4 from configure.ac, generating m4 macros that will
   be needed by configure.ac.

 - create a Makefile.am file for each Modules.am file found in modules/ .

Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
54 55
 - run autopoint (previously gettextize) to provide build system support
   for internationalization.
56 57 58 59 60 61 62 63 64 65 66 67

 - run the usual aclocal, autoheader, automake and autoconf, which create
   the various Makefile.in files from the corresponding Makefile.am and the
   configure script from configure.ac.

 - fix a few files in the vlc repository that may have been altered.

How to add a module

To add a module to the repository, just add its sources to a Modules.am
68 69 70
file. If you add a new directory you will need to create a new Modules.am,
inside that directory. Do not forget to add a corresponding
Makefile line at the end of configure.ac for this new Modules.am file.

To have the module built, you need to add a call to VLC_ADD_PLUGIN or
Sam Hocevar's avatar
Sam Hocevar committed
VLC_ADD_BUILTINS to configure.ac with your new module name as argument.
74 75 76 77 78
Look at other modules for guidelines on how to add build and linkage options.

After changing configure.ac you will always need to rerun bootstrap and 

79 80 81
VLC keeps a cache of its modules (in ~/.cache/vlc/ on Linux), so you'll have to
delete it (or use vlc --reset-plugins-cache). Then use vlc -vvv --color --list
to check that your plugin is seen by VLC.