VideoLAN Wiki - User contributions [en]

SoC 2020

2020-02-24T09:32:40Z

Magsoft: /* GPU shader filters */

{{DISPLAYTITLE:Google Summer of Code 2020}}


https://developers.google.com/open-source/gsoc/images/gsoc2016-sun-373x373.png


This page summarizes the current list of ideas for VideoLAN project, for [https://summerofcode.withgoogle.com Google Summer Of Code 2020].

The list is not exhaustive, and is not limitative. Feel free to apply with '''your own idea!'''

== Introduction & Information ==
[[File:Asterix VLC.svg|frameless|right]]

This wiki page covers the attempt by the [[VideoLAN]] project to act as a mentoring organization for [http://code.google.com/soc/ Google Summer of Code], in order to improve [[VLC]], [[VLMC]] and [https://code.videolan.org/videolan/dav1d dav1d] (or the [[libVLC]] engine) and their dependencies.

We have projects in '''C''', '''C++''', '''ASM''', '''JS''', '''Go''', '''Obj-C''', '''GPU Shaders''', '''C#''', '''Java/Kotlin''' and '''Swift'''.

=== Summer of Code ===

Google Summer of Code is a way for '''university students''' to have a paid '''internship''' by '''Google''' to work on open source projects and become top developers!

[[VideoLAN]] was a ''Google Summer of Code'' mentoring organization in [[SoC 2007|2007]], [[SoC 2008|2008]], [[SoC 2009|2009]], [[SoC 2010|2010]], [[SoC 2011|2011]], [[SoC 2013|2013]], [[SoC 2016|2016]], [[SoC_2017|2017]], [[SoC_2018|2018]] and [[SoC_2019|2019]].

This page lists some ideas for Summer of Code projects on dav1d, VLMC, libVLC and {{VLC}}.

=== VLC & libVLC ===

{{VLC}} is a cross-platform multimedia player, encoder and streamer application. It is one of the most successful open-source projects without any professional structure underneath.

{{VLC}} is downloaded at an approximate monthly rate of 25 millions from the main website and that's not including third-party distributions (Linux)!

You can find more information on [http://en.wikipedia.org/wiki/VLC_media_player VLC on Wikipedia] or on this [[Main Page|wiki]].

The engine of VLC is '''libVLC''', and is used by '''VLMC'''.

=== dav1d ===

'''dav1d''' is the reference AV1 decoder that is shipped inside VLC, Chrome and Firefox.

It's a very low-level codec, mostly written in C and assembly.

=== VideoLAN Movie Creator ===
[[VLMC]] is a cross-platform non-linear video editing software based on libVLC technology. It was started as a final year student project at the French IT school [http://www.epitech.eu EPITECH].

[[VLMC]] currently awaits a transition to the current libvlc API and it's actual 1.0 release!

=== Summer of Code rules ===

If selected and developed, SoC projects for VLMC and VLC will be included in later releases.

All projects are covered by the GPL (v2+) or LGPL (v2.1+) licenses depending on the module.

== How to Start ==
=== Find an idea ===
First, you need to find an idea.

This current page gives you a list of ideas. Those ideas are '''NOT exhaustive''': you can bring your own idea! Some of the best ideas we've ever had were '''custom''' ideas!

=== Submit your idea ===
You need to submit your idea on the ''Google Summer of Code'' platform.

You should do so, very quickly, even before having finished compilation and the next steps, so that we can give you early feedback.

=== Compile libVLC or VLMC ===
This may sound trivial, but it's harder than many expect. See https://wiki.videolan.org/Category:Building/ for more informations.

You should come on [[IRC]] to get help to compile.

=== Provide a small patch ===
To demonstrate your skills, share a small patch with us. This will let you become familiar with [[Git]], in case you don't know it already and our process on [[Sending Patches VLC|merging patches]].

=== Let's get in touch ===

If you have a doubt, are not sure about anything or want clarification, please get in touch with us.

We have 3 major communication channels:
* Our [https://mailman.videolan.org/mailman/listinfo mailing-lists] to discuss patches and further development related topics;
* Furthermore, we have our [http://forum.videolan.org web forums] for VLC-related end-user support - a VLMC section will be created once the product is published.
* Finally, there is our IRC channel ''#videolan'' (for libVLC) and ''#vlmc'' on the ''Freenode'' network. It's open to any kind of discussion. Usage issues, questions how to compile VLC/VLMC, getting to know the fellow developers, etc.

= Ideas for VLC & libVLC =
== Advanced Audio Filters ==

'''Project Description''':
We are looking for a skilled audiophile that knows a lot about audio theory and practice to work on new audio filters for VLC.

'''Tasks to do''':
* SRS WoW like or other 3D effects;
* channels mixing, notably upmixing, like Prologic-II;
* tracks mixing, and transitions;
* scriptable new audio filters in lua and enable users to create whatever audio filtering function they want in a Lua script;
* LADSPA or other libraries integration.

'''Requirements''':
This project needs some good audio knowledge and good C experience.

'''Qualification task:'''
Port any audio filter from MPlayer

''Proposed mentor: unidan ''

== VLC Qt interface work ==
'''Project Description''':
The VLC interface is quite outdated on Linux and Windows. It has a lot of features, but some are not properly exposed.

We are currently reworking the interface, but we need help.

'''Scope of the tasks to do''':

The idea is to get closer to what the WinRT/UWP interface looks like ''(search on google image to get an idea)''.

The WinRT interface is simpler, more user friendly, and has a better "media center" feel into it.

It would require integration with the media library and with the current interface.

Qml is the preferred way of improving the current UI.

'''Requirements''':
This project requires '''Qt/C++''' knowledge, and qml would be a nice plus.

''Proposed mentor: Pierre''

== VLC.js ==
'''Project Description''':
We're currently porting VLC to the web, using WebAssembly. This is a current work in progress, so we need a lot of help to improve it

This requires working close to the toolchain, compilation and the web browsers.

'''Scope of the tasks to do''':

There are lots of things to do (not all of them need to be done by the same person:
* Improving compilation of the VLC core to Wasm,
* Improving compilation of VLC 3rd party libraries,
* Fixing the VLC core to support the Web platform,
* Implement WebCodec inside VLC,
* Improve audio pipeline inside VLC,
* Improve emscripten :)

'''Requirements''':
This project requires '''C''' knowledge, and compilation.

''Proposed mentor: JB''

== VLC macOS interface redesign ==
'''Project Description''':
The VLC interface is quite outdated on macOS and we are currently in the process of re-writing it to give it a modern feel, but also to integrate recent additions to libvlc regarding playback control and library management.

This project for the summer is to rework heavily this interface to make it beautiful and useful again.

'''Scope of the tasks to do''':

There is a full design already done and tested. The major hurdle is to actually implement it the way we want it to be. The iOS/tvTV interface is simpler, more user friendly, and has a better "media center" feel into it, which influenced what we want to achieve on the Mac. Note that the objective is to use AppKit. UIKit (aka "Marzipan") will not be part of this project.

Iterating from the current UI and closely collaborating with the team currently working on it is a requirement.

'''Requirements''':
This project requires '''Obj-C''' knowledge, a thorough understanding of OOP and proven previous Mac development experience. You cannot use swift for this project.

''Proposed mentor: David Fuhrmann, Felix Paul Kühne''

== GPU shader filters ==
'''Project Description''':
VLC is using OpenGL and Direct3D11 on modern machines. It is now possible to do all kinds of video processing that was done in the CPU directly in the GPU.

This project for the summer is to port some of the existing CPU filters to the GPU using shaders.

'''Scope of the tasks to do''':

The first task will be to identify all the video filters in VLC and identify the ones that could be done as shaders. Then implement them. Either in OpenGL shaders, Direct3D11 shaders, both and maybe Vulkan.

'''Requirements''':
This project requires '''OpenGL''' or '''Direct3D11''' shaders knowledge as well as knowledge on video filters in general.

''Proposed mentor: Steve Lhomme, unidan''

== VLC iOS new UI ==
'''Project Description''':
We're currently in the process of rewriting and updating the entire UI for VLC iOS

There is a lot of components that need refactoring and need to get an updated UI. Like for example the network navigation section.

Further more tests should be written for these components to ensure that we don't break features on old or new devices.

The project for this summer is to write these components in Swift with updated UI and make sure the app becomes and stays stable.

'''Tasks to do''':

*Get an overview of the current App and components that need an update
*Refactor and give the appropriate components a new look
*Writing tests for these components to ensure that functionality works on all supported devices
*Rewriting the first start screens

'''Requirements''':
This project requires '''Obj-C''' and '''Swift''' knowledge and ideally knowledge of writing tests for iOS but this can be learned.

''Proposed mentor: Soomin Lee, Felix Paul Kühne ''

== Open Source Fuzzing platform ==

The idea of this project is to develop a new web platform to support fuzzing or code analysis, like oss_fuzz, but open source. 
That would allow to see the defects, to be able to act on them.

It should be adaptable for clang-analyser or other similar tools.

It can be based on gitlab, if needed, but should be developed in Go.

'''Requirements''':
This project requires '''Go''' knowledge and ideally knowledge of '''JS'''

''Proposed mentor: Hugo Beauzée-Luyssen''

== Interactive movie support ==

The idea is to add support for interactive movies inside VLC using the matroska.org mkv format. An interactive movie is like a gamebook but for movies.

'''Tasks to do''':
* Extend the MKV spec to add support for titles, menus, that will be used by interactive movies
* Improve a MKV muxing tool (ffmpeg, mkvtoolnix) to support the extended spec
* Add interactive movies support inside VLC's MKV module

Those will be done in '''C''' and '''C++'''

''Proposed mentor: Thomas Guillem, Steve Lhomme''

== Develop a MPD server inside VLC ==

The idea is to add support for VLC to act as a MPD server.

'''Tasks to do''':
* study the MPD protocol
* code a MPD server as a control module
* connect to the medialibrary
* implement advanced MPD features

Those will be done in '''C''' and '''C++''', and it requires familiarity with an MPD client

''Proposed mentor: Thomas Guillem''

== Improve the web interface of VLC in Vue.js ==

The idea is to improve the new web interface of VLC, that is currently in '''Vue.JS'''. It requires significant improvements

* Review the current code
* Clean and improve the modularity
* Adapt to the new playlist code
* Connect to the new medialibrary
* Improve the look

Those will be done in '''C''' and '''C++''', and it requires familiarity with an MPD client

''Proposed mentor: David''

== Improve VLCKit Objective-C - Swift interoperability ==

'''Project description''':

Currently VLCKit is not very '''Swift''' friendly.
Indeed, it will be beneficial for VLCKit to have a better '''Swift''' interoperability interface than one generated by default.

'''Tasks to do''':

* Study exposed VLCKit methods
* Improve Objective-C - Swift interop
* Make a test Swift project to test the interoperability

'''Requirements''': This project requires '''Objective-C''' and '''Swift''' knowledge.

'''Proposed mentor''': Felix Paul Kühne, Soomin Lee

== Other ideas for VLC & libVLC ==

Those ideas are not detailed, but they are ideas that we could help to spring new ideas.
We can help work with you to make those more detailed.

* Integrate '''Rust''' inside VLC, as a demuxer or a parser
* Improve Vulkan output for VLC, including HDR support
* Improve id3 tag and metadata handling in VLC
* Support NVDec decoding inside VLC
* Work on emscripten version of VLC, aka VLC.js
* Bridge module for GMI'C or other video filters
* Automated Testing Environment like ffmpeg Fate (port ?) for demuxing, non-hw decoding
* Integrate libavfilter in VLC
* Improve the libVLCSharp bindings for VLC in '''C#'''
* Provide setups for popular streaming services / sout templates (ui ?)

= Ideas for VLMC =

== Port to Android ==

'''Project Description''':
VLMC is now working on the desktop. It would be nice to port it also to the mobile world, starting by Android.

This project would require to adapt to smaller screens, and simplify the UI to fit the Android workflow.

'''Tasks to do''':
# Fix the VLMC build for Android. As libVLC works fine on Android, this is more focused on compiling the Qt part for Android.
# Split more parts of the UI in components that are reusable on mobile.
# Change the components to fit the small resolutions of the Android devices.
# Rewrite some UI components in QML.
# Write a simpler timeline widget for Mobile workflows.

'''Requirements''': This project requires '''C++/Qt/qml''' knowledge, and access to Android devices.

''Proposed mentors: Geoffrey/Hugo''

== Port to iOS ==

'''Project Description''':
VLMC is now working on the desktop. It would be nice to port it also to the mobile world, also on iOS.

This project would require to adapt to smaller screens, and simplify the UI to fit the iOS workflow.

'''Tasks to do''':
# Fix the VLMC build for iOS. As libVLC works fine on iOS, this is more focused on compiling the Qt part for iOS.
# Split more parts of the UI in components that are reusable on mobile.
# Change the components to fit the small resolutions of the iOS devices.
# Rewrite some UI components in QML.
# Write a simpler timeline widget for Mobile workflows.

'''Requirements''': This project requires '''C++/Qt/qml''' knowledge, and access to iOS devices. Previous iOS development experience is preferred.

''Proposed mentors: Felix/Hugo''

== Media Workflow rework ==

'''Project Description''':
VLMC is now working on the desktop, but the media workflow is quite slow and is missing some common use cases.

This should be fixed in [https://github.com/mltframework/mlt MLT] framework backend for libVLC and is the continuation from the work from the previous Summer of Code.

'''Tasks to do''':
# Understand the MLT libVLC backend codebase,
# Clean the backend and port it to a cleaner code state in C++,
# Benchmark the code and make it more efficient,
# Work to merge this backend upstream,
# Implement all the missing features in libVLC.

'''Requirements''': This project requires '''C/C++''' knowledge, and understanding of multimedia concepts is a good positive point.

''Proposed mentors: Hugo''

== Workflow audio filters ==

'''Project Description''':
VLMC is now working on the desktop, but we need to have a good setup of audio filters to make it usable for most people.

'''Tasks to do''':
# Understand the VLMC and MLT codebase interactions,
# Add audio filters on the MLT framework backend using the [https://en.wikipedia.org/wiki/LADSPA LADSPA]/[http://lv2plug.in/ LV2] library or a similar open source library,
# Code the interface corresponding to those filters, and their options,
# Prepare visualizations, and notably for soundwave filters,
# Integrate those inside the timeline UI,
# Optimize.

'''Requirements''': This project requires '''C++/Qt/qml''' knowledge, and enough understanding of audio.

''Proposed mentors: J-B''

== Workflow video filters ==

'''Project Description''':
VLMC is now working on the desktop, but we need to have a good setup of video filters to make it usable for most people.

'''Tasks to do''':
# Understand the VLMC and MLT codebase interactions,
# Add video filters on the MLT framework backend using the [https://git.sesse.net/?p=movit;a=summary movit] library or a similar open source library,
# Code the interface corresponding to those filters, and their options,
# Add transitions between clips
# Code the interface to manage those transitions,
# Optimize the code.

'''Requirements''': This project requires '''C/C++''' knowledge.

''Proposed mentors: Felix''

== Improve multiplatform support ==
VLMC is aiming at being fully cross platform, but drifted a bit from that goal. While most VLMC's code is cross platform, and can be easily built targeting platforms, some dependencies might prove more difficult to build or compose with VLMC.

'''Tasks to do''':
# Fix MLT cross compilation for Windows (This will most likely require patching directly inside MLT, all contributions must be sent upstream).
# Fix medialibrary code & build process on macOS (and potentially iOS). The medialibrary misses some platform specific code to be able to list all connected drives (hard drives & USB removable storage, mostly) along with filesystem browsing
# Update the documentation along the way
# Create jenkins build configuration to have nightly builds on jenkins.videolan.org & nightlies.videolan.org for all supported platforms

'''Requirements''': This project requires buildsystems/toolchains knowledge, basic system programming on macOS & Windows

''Proposed mentors: Hugo''

== Remote UI ==

We would like to have a way to use VLMC from a web browser. You can easily imagine having a nice, shiny & simple UI for minimal movie edition, which would go hand in hand with the cloud storage feature.

'''Tasks to do''':
This task aims toward the uncoupling of the rendering backend & UI, as the renderer will run server side, while the UI runs on the client side.

The idea is to be able to have a UI interacting with the renderer without having to be in the same process, or even machine.

'''Requirements''': This project requires '''C++''' and '''JS''' knowledge.

''Proposed mentor'': jb, chouquette, fkuehne

= Ideas for dav1d =

== dav1d ARM NEON optimization ==

Improving the performance of the AV1 decoder is very important for VLC and the whole ecosystem.

It requires to:
* Profiling to identify hotspots of the new libdav1d video decoder on arm64 across common test files
* Analysis of potential benefits of NEON SIMD for these hotspots
* Write arm64 NEON optimization using directly written assembly code

'''Requirements''': This project requires '''C''' and '''ASM''' knowledge, as well as system programming skills

Contact 'j-b'

== dav1d GPU Compute Shaders ==

Improving the performance of the AV1 decoder is very important for VLC and the whole ecosystem.

This project requires to port one of the filter, like SGR or Wiener to one of the Shader languages. iPhones or Xbox One would be a good target.

This is a tricky project, but is doable during the summer

'''Requirements''': This project requires '''C''' and '''GPU Shaders''' knowledge, as well as system programming skills

Contact 'j-b'

== dav1d statistics extractions ==

The [https://code.videolan.org/videolan/dav1d dav1d] AV1 decoder is a new high performance AV1 decoder by
VideoLAN.

Current open source tools for AV1 analysis use instrumentation in the reference decoder [https://aomedia.googlesource.com/aom libaom] to extract decode-time metadata for display and reporting, but support for sophisticated analysis is lacking.

To speed development of AV1 tools like the rav1e, it would be helpful to add similar decoder metadata extraction APIs to the dav1d decoder so that rapid testing of encoder algorithms is easier. This includes the ability to quickly produce statistics, visualizations and other
reporting that can be used for tuning encoder parameters or guiding development. Advanced ideas include adding similar encoder metadata API to rav1e that add encode-time visualizations.

'''Requirements''': This project requires '''C''' knowledge.

Contact 'unlord'

= Ideas for VLC dependencies =

== libmicrodns refactoring ==

Our current mDNS discoverer is working, but is not so respectful of the RFC.
Possible improvements include:
* Device TTL support
* Device removal detection
* Better request pacing
* Delegate socket interactions to the caller
* Unit testing
* Fuzzing

'''Requirements''': This project require '''C''' knowledge, as well as system programming skills

''Proposed mentor'': chouquette, tguillem

== rav1e, the AV1 encoder in Rust ==

The [https://github.com/xiph/rav1e rav1e] project aims to create a new AV1 encoder implementation in
Rust.

To support this we need better AV1 analysis tools that give detailed information about AV1 streams including:

* bit rate across the frame
* frame allocation within a scene
* display of frame data (block partitioning, mode decisions, motion vectors, etc)
* objective quality over time
* average rate (for streaming)

'''Requirements''': This project requires '''Rust''' knowledge.

Contact 'unlord'

{{GSoC}}
[[Category:SoC]]

VDD19/Sponsor Policy

2019-10-13T19:19:44Z

Magsoft: /* Who can be sponsored? */

{{VDD}}
= VDD 2019 Travel Sponsor Policy =

Since [[VDD19]] is in Tokyo, it will cost a lot more money for [[VideoLAN]]. Remember that the non-profit is paying all this from donations.

Therefore, there are a few rules for sponsorship, that will be enforced.

= Who can be sponsored? =

People who are part of the development communities, that are not paid by a corporation to work on multimedia, can be sponsored.

This includes all the development communities around VLC or FFmpeg or Kodi.

If you were sponsored in the past, you should be able to be sponsored this year.

If you are a member of the VideoLAN non-profit organization, you should be sponsored.

If you are not part of a development community, but you really want to come, talk to us.

However, if you are an unactive developer, this might be a bit more tricky.

= Cost =

* Please try to keep your cost of flights to a minimum.
* Don't make it insane, like 15hours stop or 3 stops to come to Tokyo.
* If you find something under 750€ from Europe, or 900€ from the US, take it directly.
* Else, you can ask on IRC ''(or mail)'' to jb or TypX.
* If you find an expensive flight that you really want, we might be able to cover part of it only. Talk to us for more information.

If you need help with airfares, you can solicit advice on the Freenode IRC #libav-travel channel.

VDD19/Sponsor Policy

2019-10-13T19:19:20Z

Magsoft: /* Who can be sponsored? */

{{VDD}}
= VDD 2019 Travel Sponsor Policy =

Since [[VDD19]] is in Tokyo, it will cost a lot more money for [[VideoLAN]]. Remember that the non-profit is paying all this from donations.

Therefore, there are a few rules for sponsorship, that will be enforced.

= Who can be sponsored? =

People who are part of the development communities, that are not paid by a corporation to work on multimedia, can be sponsored.

This includes all the development communities around VLC or FFmpeg or Kodi.

If you were sponsored in the past, you should be able to be sponsored this year.

If you are part of the VideoLAN non-profit organization, you should be sponsored.

If you are not part of a development community, but you really want to come, talk to us.

However, if you are an unactive developer, this might be a bit more tricky.

= Cost =

* Please try to keep your cost of flights to a minimum.
* Don't make it insane, like 15hours stop or 3 stops to come to Tokyo.
* If you find something under 750€ from Europe, or 900€ from the US, take it directly.
* Else, you can ask on IRC ''(or mail)'' to jb or TypX.
* If you find an expensive flight that you really want, we might be able to cover part of it only. Talk to us for more information.

If you need help with airfares, you can solicit advice on the Freenode IRC #libav-travel channel.

VDD19/Sponsor Policy

2019-10-13T19:19:07Z

Magsoft:

{{VDD}}
= VDD 2019 Travel Sponsor Policy =

Since [[VDD19]] is in Tokyo, it will cost a lot more money for [[VideoLAN]]. Remember that the non-profit is paying all this from donations.

Therefore, there are a few rules for sponsorship, that will be enforced.

= Who can be sponsored? =

People who are part of the development communities, that are not paid by a corporation to work on multimedia, can be sponsored.

This includes all the development communities around VLC or FFmpeg or Kodi.

If you were sponsored in the past, you should be able to be sponsored this year.

If you are part of the VideoLAN non-profit orgaization, you should be sponsored.

If you are not part of a development community, but you really want to come, talk to us.

However, if you are an unactive developer, this might be a bit more tricky.

= Cost =

* Please try to keep your cost of flights to a minimum.
* Don't make it insane, like 15hours stop or 3 stops to come to Tokyo.
* If you find something under 750€ from Europe, or 900€ from the US, take it directly.
* Else, you can ask on IRC ''(or mail)'' to jb or TypX.
* If you find an expensive flight that you really want, we might be able to cover part of it only. Talk to us for more information.

If you need help with airfares, you can solicit advice on the Freenode IRC #libav-travel channel.

Contact VideoLAN

2017-07-12T08:02:31Z

Magsoft: /* E-mail */

There are several ways to contact [[VideoLAN]].

== Before contacting VideoLAN ==
Are you sure you can't answer the question yourself?
Please check:
* [[Documentation:Documentation | Documentation]]
* The [[Common Problems]] checklist
* [http://www.videolan.org/support/ Support]
* Ask on the mailing lists for problem using the software [http://www.videolan.org/support/lists.html Lists]
* Search on the [http://forum.videolan.org forum]
* Search this [[Special:Search|wiki]].

== E-mail ==
To contact us by e-mail, please use [mailto:videolan@REMOVETHIS@videolan.org videolan@REMOVETHIS@videolan.org] and write in French, German or English.

== IRC ==
The IRC channel is also a good way to contact and speak to the team.

Using an IRC client, connect to [irc://irc.videolan.org irc.videolan.org] or [irc://irc.freenode.net irc.freenode.net] and go on the '''#videolan''' channel.

If you are in a location without direct IRC access, please try the [http://webchat.freenode.net/?channels=videolan Freenode Webchat].

== Mail ==
If, for some reason, you really need to send postal mail, please mail to
<pre><nowiki>
VideoLAN
18, rue Charcot
75013 Paris
France
</nowiki></pre>

[[Category:About VideoLAN]]

Contact VideoLAN

2017-07-12T08:01:42Z

Magsoft: /* E-mail */

There are several ways to contact [[VideoLAN]].

== Before contacting VideoLAN ==
Are you sure you can't answer the question yourself?
Please check:
* [[Documentation:Documentation | Documentation]]
* The [[Common Problems]] checklist
* [http://www.videolan.org/support/ Support]
* Ask on the mailing lists for problem using the software [http://www.videolan.org/support/lists.html Lists]
* Search on the [http://forum.videolan.org forum]
* Search this [[Special:Search|wiki]].

== E-mail ==
To contact us by e-mail, please use [mailto:videolan@REMOVETHIS@videolan.org] and write in French, German or English.

== IRC ==
The IRC channel is also a good way to contact and speak to the team.

Using an IRC client, connect to [irc://irc.videolan.org irc.videolan.org] or [irc://irc.freenode.net irc.freenode.net] and go on the '''#videolan''' channel.

If you are in a location without direct IRC access, please try the [http://webchat.freenode.net/?channels=videolan Freenode Webchat].

== Mail ==
If, for some reason, you really need to send postal mail, please mail to
<pre><nowiki>
VideoLAN
18, rue Charcot
75013 Paris
France
</nowiki></pre>

[[Category:About VideoLAN]]

Win32Compile

2017-05-15T13:15:42Z

Magsoft:

This page will help you to compile {{VLC}} for [[Windows]].

== Building Methods ==

If you want to build VLC from source, you have several choices:

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''MinGW on Linux'''
| [[Win32Compile#Obtaining_the_toolchain|Obtaining the toolchain]]
| '''Preferred''' method involving cross-compilation from Linux. On computers running Microsoft Windows, a virtual machine is necessary to run Linux.
|-
| '''[http://www.mingw.org MSYS+MinGW]''' on Windows
| [[Win32CompileMSYS|Compile with MSys]]
| '''Native''' compilation method. MSYS is a minimal build environment to compile Unix-style projects directly on Microsoft Windows. This is '''not officially supported''' by VideoLAN. Best of luck.
|-
| '''Cygwin''' on Windows
| [[Win32CompileCygwinNew|Compile with Cygwin]]
| Cygwin method. Cygwin emulates a POSIX environment to compile on Microsoft Windows. This is '''error'''-prone and '''slow''' and therefore not recommended.
|}

== Obtaining the cross-compilation toolchain ==
All this howto is focused on '''Debian/Ubuntu'''. For other distribution, please find the related package names, but they should be very similar.

'''Ubuntu 14.04''' is too old to compile VLC.

=== Host triplet ===
A number of commands below include the toolchain identifier, called the ''host triplet''.

This value is '''essential''': it instructs the build system to use the correct toolchain and compile the program for Windows.
Without the value, the build system will perform a native compilation for Linux (or whatever your computer runs). With an incorrect value, the build will fail.

The exact value depends on your installation of the toolchain.

Notably on Debian/Ubuntu, these values must be used:
* ''i686-w64-mingw32'' for Windows 32-bits, using the Mingw-w64 toolchain
* ''x86_64-w64-mingw32'' for Windows 64-bits, using the Mingw-w64 toolchain

Please make sure that you replace the keywords ''HOST-TRIPLET'' with either ''i686-w64-mingw32'' or ''x86_64-w64-mingw32'' adapted to your target Windows version (32-bit or 64-bit, respectively)

=== Compiler and binary toolchain ===

==== Mingw-w64 ====
To compile VLC for Windows (32-bits or 64-bits), the Mingw-w64 toolchain is required:

For the 32-bit version, run this:
# apt-get install gcc-mingw-w64-i686 g++-mingw-w64-i686 mingw-w64-tools

For the 64-bit version, this becomes:
# apt-get install gcc-mingw-w64-x86-64 g++-mingw-w64-x86-64 mingw-w64-tools

'''NB:''' you need mingw-w64 version 5.0.1 to compile it.

=== Development tools ===
You will also need:
* lua (5.2)
* all autotools: libtool, automake, autoconf, autopoint, make, gettext, pkg-config
* qt4-dev-tools, qt5-default (or qt4-default if qt plugin build fails)
* git, subversion cmake, cvs if you want to rebuild contribs
* wine-dev for creating Win32 packages
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer], bzip2 [for 'make prebuild]

'''Run:'''
# apt-get install lua5.2 libtool automake autoconf autopoint make gettext pkg-config
# apt-get install qt4-dev-tools qt5-default git subversion cmake cvs
# apt-get install wine64-development-tools libwine-dev zip p7zip nsis bzip2
# apt-get install yasm ragel ant default-jdk protobuf-compiler dos2unix

== Get the source code ==
$ git clone http://git.videolan.org/git/vlc.git vlc

See [[Git]] for more information.

== Go into the VLC directory ==
$ cd vlc

== Prepare [[Contrib Status|3rd party libraries]] ==

VLC depends on a sizable number of third party libraries. Before compiling VLC, you need to obtain compiled versions of those. There are two ways to achieve that:
* The ''prebuilt'' approach is much faster and easier, but only works with a narrow set of VLC versions.
* The ''manual build'' approach takes a lot of time and disk space, and somewhat error-prone.

Please note that the prebuilt library versions are intended for the latest current ''stable release'' of VLC. It is not compatible with old VLC versions, nor with newer or future versions.

At the time of writing (late 2016), the prebuilt libraries work with VLC 2.2.x '''only'''. To compile the VLC 3.0.x development branch, '''DO NOT USE''' the prebuilt libraries.

=== Prebuilt (fast) ===
$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=HOST-TRIPLET
$ make prebuilt

=== Manually built (slow) ===
Or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn:
# apt-get install subversion yasm cvs cmake ragel autopoint

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=HOST-TRIPLET
$ make fetch
$ make

=== Linux 64-bit ===

If you are on Linux '''64-bit''', you '''SHOULD''' remove some files, or install the lib32 packages (ia32-libs, multilibs, etc...)

$ rm -f ../i686-w64-mingw32/bin/moc ../i686-w64-mingw32/bin/uic ../i686-w64-mingw32/bin/rcc

=== Fix your contrib path ===

If your host triplet is not '''i686-w64-mingw32''' (you are ''not'' compiling for Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ''''HOST-TRIPLET'''' ../i686-w64-mingw32
Notice that there is no <code>../</code> before the host triplet. This is intentional, and if done properly, you should see a functioning symbolic link created in the parent directory (try <code>ls -l ..</code> and you should see <code>i686-w64-mingw32 -> x86_64-w64-mingw32/</code>).

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Set your PKG_CONFIG_LIBDIR (Adapt the path to reflect your local setup)
$ export PKG_CONFIG_LIBDIR=$HOME/vlc/contrib/HOST-TRIPLET/lib/pkgconfig
$ export PKG_CONFIG_PATH_CUSTOM=$PKG_CONFIG_LIBDIR (for Archlinux only)

Execute the build configuration script:
$ ../extras/package/win32/configure.sh --host=HOST-TRIPLET --build=x86_64-pc-linux-gnu

'''N.B.''':
Use the host and build tuples respectively corresponding to '''your''' cross-compilation toolchain and build system respectively. The example above assumes you are compiling for ''Windows'' OS and ''Intel 686'' architecture, and the build system is ''GNU/Linux'' OS and ''x86 64-bits'' architecture. See [[#Host_triplet|above]] for list of common values.

Also, if you have a problem here (such as an error about Library dvdread), see the [[Talk:Win32Compile|Talk]] page.

Alternatively, you can run configure manually:
$ ../configure --host=HOST-TRIPLET --build=x86_64-pc-linux-gnu
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages with the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

== Extra information ==

=== Static compilation of plugins ===
You might want to use the following script to enforce static compilation.
Run as root, and use at your own risk.

#!/bin/sh

# This script enforces statically linking of libgcc, libstdc++-6, and libpthread,
# without needing to rebuild gcc and mingw-w64 from scratch.
# -static-libgcc -static-libstdc++ flags can not be used in a libtool build system,
# as libtool removes flags that it doesn't understand.

move() {
[ -f $1 ] || return 1
mkdir -p old/
mv -v $* old/
return 0
}

for x in i686 x86_64
do
library_path_list=`$x-w64-mingw32-gcc -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|sort|uniq`
IFS=':'
for i in $library_path_list
do
cd $i
move libstdc++-6.dll libstdc++.dll.a libgcc_s.a libgcc_s_sjlj-1.dll && ln -s libgcc_eh.a libgcc_s.a
move libpthread.dll.a libwinpthread.dll.a
move libwinpthread-1.dll
[ -d ../bin ] && cd ../bin && move libwinpthread-1.dll
done
done

exit 0

=== Mingw32 ===
Up to versions 2.0.x, VLC was compiled with the older mingw32 toolchain, which only supports 32-bits Windows. If you have problems with mingw-w64, you can try mingw32 instead:

* '''Debian/Ubuntu''': run <code>apt-get install gcc-mingw32 mingw32-binutils</code>. Note that at least version 3.17 of Mingw32 is required, which Debian does not provide. You may obtain mingw32-runtime-3.17 [http://people.videolan.org/~jb/debian/mingw32-runtime_3.17.0-0videolan_all.deb here].
* '''Gentoo''' users can <code>emerge crossdev && crossdev mingw32</code>
* '''ArchLinux''' users can <code>pacman -S mingw32-gcc</code>
* '''Fedora''' users should read [[Win32Compile Under Fedora]]
* Other '''Linux''' systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW

[[Category:Building]]

AndroidCompile

2017-01-10T14:11:17Z

Magsoft: /* Setup Gradle build system */

This page is an introduction to the compilation of '''VLC for Android''' on Linux.

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

You can have [http://developer.android.com/sdk/installing.html more details], if needed.

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r13''' for Linux.
# Decompress it to install

== Environment setup ==
Set '''$ANDROID_SDK''' to point to your Android SDK directory

export ANDROID_SDK=/path/to/android-sdk

Set '''$ANDROID_NDK''' to point to your Android NDK directory

export ANDROID_NDK=/path/to/android-ndk

Add some useful binaries to your '''$PATH'''

export PATH=$PATH:$ANDROID_SDK/platform-tools:$ANDROID_SDK/tools

== Building ==
=== Get VLC Source ===
Clone the source from the VLC git!

In your ''android'' source folder, run:

git clone https://code.videolan.org/videolan/vlc-android.git

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Once this first compilation has succeeded, you can build from Android Studio with the '''Run''' command.

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release) package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

=== Run ===
Run it and enjoy!

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

===Outdated autotools-dev===
If you get the following error message you may have have an outdated version of autotools-dev:
Invalid configuration `arm-linux-androideabi': system `androideabi' not recognized
You may first want to check if your distribution has any available updates for this package. Alternatively, you can manually update your config.guess and config.sub files from here: [http://git.savannah.gnu.org/gitweb/?p=config.git;a=tree]. These files are typically located in /usr/share/misc on Debian based distributions.

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-01-10T14:09:43Z

Magsoft: /* Setup Gradle build system */

This page is an introduction to the compilation of '''VLC for Android''' on Linux.

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

You can have [http://developer.android.com/sdk/installing.html more details], if needed.

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r13''' for Linux.
# Decompress it to install

== Environment setup ==
Set '''$ANDROID_SDK''' to point to your Android SDK directory

export ANDROID_SDK=/path/to/android-sdk

Set '''$ANDROID_NDK''' to point to your Android NDK directory

export ANDROID_NDK=/path/to/android-ndk

Add some useful binaries to your '''$PATH'''

export PATH=$PATH:$ANDROID_SDK/platform-tools:$ANDROID_SDK/tools

== Building ==
=== Get VLC Source ===
Clone the source from the VLC git!

In your ''android'' source folder, run:

git clone https://code.videolan.org/videolan/vlc-android.git

==== Setup Gradle build system ====

Before using Android studio to compile the app, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Now you can build from Android Studio with the '''Run''' command

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release) package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

=== Run ===
Run it and enjoy!

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

===Outdated autotools-dev===
If you get the following error message you may have have an outdated version of autotools-dev:
Invalid configuration `arm-linux-androideabi': system `androideabi' not recognized
You may first want to check if your distribution has any available updates for this package. Alternatively, you can manually update your config.guess and config.sub files from here: [http://git.savannah.gnu.org/gitweb/?p=config.git;a=tree]. These files are typically located in /usr/share/misc on Debian based distributions.

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

AndroidCompile

2017-01-10T14:09:20Z

Magsoft: /* Setup Gradle build system */

This page is an introduction to the compilation of '''VLC for Android''' on Linux.

==Android Studio, SDK and NDK installation==

=== Requirements ===
* You '''MUST''' build on Linux (or OSX if you know what you are doing).
* The following packages '''MUST''' must be installed:
** the GNU autotools: ''autoconf'', ''libtool'', ''automake'' and ''make'' (a.k.a. ''gmake'')
** ...and their dependencies: ''m4'' and ''gawk'', ''mawk'' or ''nawk'',
** the GNU C and C++ compilers a.k.a. ''gcc'' and ''g++'',
** some GNU build utilities: ''pkg-config'' and ''patch'',
** the following other build utilities: ''Apache Ant'' (or ''Ant''), ''cmake'', ''protobuf'', ''ragel'',
** the Subversion and Git version control systems
** ''unzip'' and either ''curl'' or ''wget'' for retreiving sources.
* Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
* If any of the above is missing, expect the build to fail at some point.
* If targeting an Android-x86 device, ''yasm'' must be installed too.

'''64-bit users''': You must install these 32-bit libs as specified here: [[AndroidCompile#Can.27t_run_aapt_or_adb_on_Linux_64-bit]]

==== Example on Ubuntu ====
Install the packages as follow:
sudo apt-get install automake ant autopoint cmake build-essential libtool \
patch pkg-config protobuf-compiler ragel subversion unzip git

=== SDK & Android Studio ===
# Go to [http://developer.android.com/sdk/index.html Android SDK page].
# Follow instructions to install latest version of Android SDK.
# Android Studio is recommended, but not mandatory!

You can have [http://developer.android.com/sdk/installing.html more details], if needed.

===Android NDK===
# Check that the SDK installation is correct.
# Go to the [http://developer.android.com/sdk/ndk/index.html Android NDK page] and download the '''NDK r13''' for Linux.
# Decompress it to install

== Environment setup ==
Set '''$ANDROID_SDK''' to point to your Android SDK directory

export ANDROID_SDK=/path/to/android-sdk

Set '''$ANDROID_NDK''' to point to your Android NDK directory

export ANDROID_NDK=/path/to/android-ndk

Add some useful binaries to your '''$PATH'''

export PATH=$PATH:$ANDROID_SDK/platform-tools:$ANDROID_SDK/tools

== Building ==
=== Get VLC Source ===
Clone the source from the VLC git!

In your ''android'' source folder, run:

git clone https://code.videolan.org/videolan/vlc-android.git

==== Setup Gradle build system ====

Before use Android studio to compile it, you must run '''compile.sh''' once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

''local.properties''

sdk.dir=<SDK path from $ANDROID_SDK>
ndk.dir=<NDK path from $ANDROID_NDK>

''gradle.properties''

keyStoreFile=/home/''user''/.android/debug.keystore
storealias=androiddebugkey
storepwd=android

This sets up gradle to build with correct SDK/NDK and sign builds with your personal debug key.

Now you can build from Android Studio with the '''Run''' command

=== Devices ===

Find the ABI for the target device.

* For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)
<code>armeabi-v7a</code>
* For a Tegra2 device (no [[wikipedia:ARM_architecture#Advanced_SIMD_.28NEON.29|NEON]])
<code>armeabi-v7a</code>
* For an ARMv6 device
<code>armeabi</code>
* For an ARMv6 device that does not support FPU
<code>armeabi-nofpu</code>
* For an ARMv5 device or the Android Emulator
<code>armeabi-v5</code>
* For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)
<code>x86</code>
* For a MIPS device (i.e. Ainol Novo tablets):
<code>mips</code>

This value must be passed to the compile.sh script

==== Compile ====

'''Read''' compile.sh first, as it contains some very useful and important information. Then run it:
sh compile.sh -a <ABI>

'''Note:''' At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release) package:
sh compile.sh release

'''Note:''' At this point, you will get an release APK in the same folder.

=== Run ===
Run it and enjoy!

=== Troubleshooting ===
==== Compilation error on Dependencies ====
Sometimes, especially when gradle dependencies have been upgraded, the ''compile.sh'' will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

== Debugging ==
Here are some helpful links if you wish to debug VLC on Android:
* [http://developer.android.com/guide/developing/debugging/ddms.html DDMS]
* [http://developer.android.com/guide/developing/tools/logcat.html Logcat]

===Native debugging===
If you run VLC Android and you get a crash that looks something like this:
<pre>
I/DEBUG ( 958): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
I/DEBUG ( 958): Build fingerprint: 'MOTO/MBTCA/sesame/XT300:2.1-update1/SESLA_U3_01.71.0/110110:user/release-keys'
I/DEBUG ( 958): pid: 1733, tid: 1733 >>> org.videolan.vlc <<<
I/DEBUG ( 958): signal 11 (SIGSEGV), fault addr 4237be3c
I/DEBUG ( 958): r0 423640a0 r1 7ece77ac r2 42bccdac r3 4237be38
I/DEBUG ( 958): r4 00000000 r5 42bccdac r6 002ed088 r7 002ed018
I/DEBUG ( 958): r8 7ece78e8 r9 2bafa844 10 0000000e fp 7ece794c
I/DEBUG ( 958): ip 00002ba0 sp 7ece7784 lr 423652e4 pc 4237be3c cpsr 60000010
I/DEBUG ( 958): #00 pc 0037be3c /data/data/org.videolan.vlc/lib/libvlcjni.so
I/DEBUG ( 958): #01 lr 423652e4 /data/data/org.videolan.vlc/lib/libvlcjni.so
</pre>

You have a '''native crash'''. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the '''backtrace''' as follows:

# Make sure you are in the directory that you checked out VLC-Android in.
# Migrate the libvlc folders. (Do this every time the code is recompiled)
## cp -r libvlc/jni vlc-android
## cp -r libvlc/libs vlc-android
## cp -r libvlc/obj vlc-android
## (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
# cd vlc-android
# $ANDROID_NDK/ndk-gdb --verbose --force --start
At this point, lots of stuff will appear:
<pre>
Android NDK installation path: /opt/android-ndk-r8c
Using default adb command: /opt/android-sdk-linux_x86/platform-tools/adb
ADB version found: Android Debug Bridge version 1.0.29
Using ADB flags:
Using auto-detected project path: .
Found package name: org.videolan.vlc
...bunch of stuff skipped...
GNU gdb (GDB) 7.3.1-gg2
Copyright (C) 2011 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
This GDB was configured as "--host=x86_64-linux-gnu --target=arm-linux-android".
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
Remote debugging from host 0.0.0.0
...bunch of stuff skipped...
libthread_db:td_ta_new: Victory: We can debug theads!
warning: Breakpoint address adjusted from 0x400deaa5 to 0x400deaa4.
0x40107a40 in epoll_wait () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
(gdb)
</pre>
<ol start="4">
<li>At this point, type in "continue" and press Enter.</li>
<li>Perform the actions you did to make it crash. It will spit out something like this:</li>
</ol>
<pre>
Program received signal SIGSEGV, Segmentation fault.
0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
</pre>
<ol start="6">
<li>Now, just type in "'''bt full'''" (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a [http://paste.kde.org/ pastebin], too).</li>
</ol>
<pre>
(gdb) bt full
#0 0x401120ae in ?? () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#1 0x40107bd8 in abort () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#2 0x40118e6a in __assert2 () from /media/data/vlc_android/vlc-android/obj/local/armeabi/libc.so
No symbol table info available.
#3 0x5e0cdfdc in var_SetChecked (p_this=0x40134b94, psz_name=0x5ea2fcb8 "rate", expected_type=80, val=...) at ../../src/misc/variables.c:711
i_ret = 0
p_var = <optimized out>
oldval = {i_int = 4742037487051810480, b_bool = 176, f_float = 2.27765068e+14, psz_string = 0x574f26b0 "X\270|B\001\001", p_address = 0x574f26b0,
p_object = 0x574f26b0, p_list = 0x574f26b0, i_time = 4742037487051810480, coords = {x = 1464805040, y = 1104091640}}
__func__ = "var_SetChecked"
p_priv = <optimized out>
#4 0x5e06dd9c in var_SetFloat (f=1.41421354, psz_name=0x5ea2fcb8 "rate____sample_backtrace", p_obj=0x0) at ../../include/vlc_variables.h:262
val = <optimized out>
#5 libvlc_media_player_set_rate (p_mi=0x0, rate=1.41421354) at ../../lib/media_player.c:1252
p_input_thread = <optimized out>
#6 0x5de7bd18 in Java_org_videolan_vlc_LibVLC_setRate (env=0x41cf0470, thiz=0x8ab00021, rate=1.41421354) at jni/libvlcjni.c:678
mp = 0x0
#7 0x4076de34 in ?? ()
No symbol table info available.
#8 0x4076de34 in ?? ()
No symbol table info available.
Backtrace stopped: previous frame identical to this frame (corrupt stack?)
</pre>

== Troubleshooting ==
=== Outdated Awk ===
If you receive the error message while building:

Android NDK: Host 'awk' tool is outdated. Please define HOST_AWK to point to Gawk or Nawk !

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

mv $ANDROID_NDK/prebuilt/linux-x86/bin/awk $ANDROID_NDK/prebuilt/linux-x86/bin/awk.old

=== Can't find Ant ===
If you're new to Ant, please be aware that some Linux distributions don't install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

===Outdated autotools-dev===
If you get the following error message you may have have an outdated version of autotools-dev:
Invalid configuration `arm-linux-androideabi': system `androideabi' not recognized
You may first want to check if your distribution has any available updates for this package. Alternatively, you can manually update your config.guess and config.sub files from here: [http://git.savannah.gnu.org/gitweb/?p=config.git;a=tree]. These files are typically located in /usr/share/misc on Debian based distributions.

===autoreconf: automake failed with exit status: 1===
automake: warnings are treated as errors
configure.ac:41: warning: The 'AM_PROG_MKDIR_P' macro is deprecated, and will soon be removed.
configure.ac:41: You should use the Autoconf-provided 'AC_PROG_MKDIR_P' macro instead,
configure.ac:41: and use '$(MKDIR_P)' instead of '$(mkdir_p)'in your Makefile.am files.

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [http://forum.videolan.org/viewtopic.php?f=35&t=108927])

===autoreconf: automake failed with exit status: 1 ===
make: *** [dvdnav] Error 1
...
... error: possibly undefined macro: AM_PROG_LIBTOOL

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn't meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [http://git.videolan.org/?p=vlc-ports/android.git;a=summary] lacks patch 5199 [https://patches.videolan.org/patch/5199/]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

===Can't run aapt or adb on Linux 64-bit===
You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: ''libc6'', ''libstdc++6'', and ''zlib''.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install zlib1g:i386 libstdc++6:i386 libc6:i386

If you are under ''old versions'' of Ubuntu, install ia32-libs can help you solve this issue.
sudo apt-get install ia32-libs

==See also==
* [[Android Report bugs]] - Bug reporting guide for VLC-Android.

[[Category:Building]] [[Category:Android]]

Win32Compile

2014-08-13T08:22:09Z

Magsoft: /* Configure */

This page will help you to compile {{VLC}} for [[Windows]].

== Building Methods ==

If you want to build VLC from source, you have several choices:

{| class="wikitable"
|-
! Method
! Documentation
! Notes
|-
| '''MinGW on Linux'''
| [[Win32Compile#Obtaining_the_toolchain|Obtaining the toolchain]]
| '''Preferred''' method (uses cross compilation). On Windows, you should do it in a virtual machine.
|-
| '''[http://www.mingw.org MSYS+MinGW]''' on Windows
| [[Win32CompileMSYS|Compile with MSys]]
| '''Native''' compilation method. Note: This is not supported. MSYS is a minimal build environment to compile Unixish projects under Microsoft Windows. Good luck.
|-
| '''Cygwin''' on Windows
| [[Win32CompileCygwinNew|Compile with Cygwin]]
| Build using cygwin as your compile environment. '''Error''' prone, and '''slow'''.
|}

== Obtaining the cross-compilation toolchain ==

=== Compiler and binary toolchain ===

==== Mingw-w64 ====
To compile VLC for Windows (32-bits or 64-bits), the Mingw-w64 toolchain is required:

* '''Debian/Ubuntu''': run <code>apt-get install gcc-mingw-w64-i686 g++-mingw-w64-i686 mingw-w64-tools</code>
(on Debian you must be on wheezy or above to find this package)

You might want to use the following script to enforce static compilation.
Run as root, and use at your own risk.

#!/bin/sh

# This script enforces statically linking of libgcc, libstdc++-6, and libpthread,
# without needing to rebuild gcc and mingw-w64 from scratch.
# -static-libgcc -static-libstdc++ flags can not be used in a libtool build system,
# as libtool removes flags that it doesn't understand.

move() {
[ -f $1 ] || return 1
mkdir -p old/
mv -v $* old/
return 0
}

for x in i686 x86_64
do
library_path_list=`$x-w64-mingw32-gcc -v /dev/null 2>&1 | grep ^LIBRARY_PATH|cut -d= -f2|sort|uniq`
IFS=':'
for i in $library_path_list
do
cd $i
move libstdc++-6.dll libstdc++.dll.a libgcc_s.a libgcc_s_sjlj-1.dll && ln -s libgcc_eh.a libgcc_s.a
move libpthread.dll.a libwinpthread.dll.a
move libwinpthread-1.dll
[ -d ../bin ] && cd ../bin && move libwinpthread-1.dll
done
done

exit 0

==== Mingw32 ====
Up to versions 2.0.x, VLC was compiled with the older mingw32 toolchain, which only supports 32-bits Windows. If you have problems with mingw-w64, you can try mingw32 instead:

* '''Debian/Ubuntu''': run <code>apt-get install gcc-mingw32 mingw32-binutils</code>. Note that at least version 3.17 of Mingw32 is required, which Debian does not provide. You may obtain mingw32-runtime-3.17 [http://people.videolan.org/~jb/debian/mingw32-runtime_3.17.0-0videolan_all.deb here].
* '''Gentoo''' users can <code>emerge crossdev && crossdev mingw32</code>
* '''ArchLinux''' users can <code>pacman -S mingw32-gcc</code>
* '''Fedora''' users should read [[Win32Compile Under Fedora]]
* Other '''Linux''' systems may attempt http://www.mingw.org/wiki/LinuxCrossMinGW

=== Development tools ===
You will also need:
* lua (5.1 or 5.2)
* all autotools: libtool, automake, autoconf, autopoint, make, gettext
* pkg-config
* qt4-dev-tools
* git
* subversion
* cmake, cvs if you want to rebuild contribs
* wine-dev for creating Win32 packages
* zip [for creating .zip package], p7zip [for .7z package], nsis [for .exe auto-installer], bzip2 [for 'make prebuild]

=== Host triplet ===
A number of example commands below include the identifier of the toolchain. This value is '''essential''': it instructs the build system to use the correct toolchain and compile the program for Windows. Without the value, the build system will perform a native compilation for Linux (or whatever your computer runs). With an incorrect value, the build will fail.

This is known as the ''host triplet'', although it's more of a pair than a triplet in the case of Mingw. The exact value depends on your installation of the toolchain. Notably on Debian/Ubuntu, these values must be used:

* ''i686-w64-mingw32'' for Windows 32-bits, using the Mingw-w64 toolchain
* ''x86_64-w64-mingw32'' for Windows 64-bits, using the Mingw-w64 toolchain
* ''i586-mingw32msvc'' for Windows 32-bits, using the Mingw32 toolchain

Again, you '''MUST''' substitute the value in the following command snippets.

== Get the source code ==
$ git clone git://git.videolan.org/vlc.git vlc

See [[Git]] for more information.

== Go into the VLC directory ==
$ cd vlc

== Prepare [[Contrib Status|3rd party libraries]] ==

Before compiling VLC, you need lots of other libraries. Here is how to get them:

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i686-w64-mingw32
$ make prebuilt

or, if you want to compile the contribs yourself and are feeling adventurous and have lots of time to burn,
# apt-get install subversion yasm cvs cmake

$ mkdir -p contrib/win32
$ cd contrib/win32
$ ../bootstrap --host=i686-w64-mingw32
$ make fetch
$ make

=== Linux 64-bit ===

If you are on Linux '''64-bit''', you '''SHOULD''' remove some files, or install the lib32 packages (ia32-libs, multilibs, etc...)

$ rm -f ../i686-w64-mingw32/bin/moc ../i686-w64-mingw32/bin/uic ../i686-w64-mingw32/bin/rcc

=== Fix your contrib path ===

If your Mingw prefix is not ''i686-w64-mingw32'' (you are NOT on Debian or Ubuntu), create a symlink to contribs:
$ ln -sf ../i686-w64-mingw32 ../i486-mingw32

=== Go Back ===

Go back to the VLC source directory:

$ cd -

== Configuring the build ==

=== Bootstrap ===
First, prepare the tree:
$ ./bootstrap

=== Configure ===
Then you can to configure the build with the <code>./configure</code> script.

Create a subfolder:
$ mkdir win32 && cd win32

Set your PKG_CONFIG_LIBDIR
$ export PKG_CONFIG_LIBDIR={your_root_path}/vlc/contrib/i686-w64-mingw32/lib/pkgconfig

Use the standard configuration:
$ ../extras/package/win32/configure.sh --host=i686-w64-mingw32
'''NB''': use '''YOUR''' Xcompiling prefix here, like ''i486-mingw32''

Alternatively, you can run configure manually:
$ ../configure --host=i686-w64-mingw32
See <code>'../configure --help'</code> for more information.

== Building VLC ==

Once configured, to build VLC, just run:
$ make

== Packaging VLC ==
Once the compilation is done, you can build self-contained VLC packages with the following <code>make</code> rules:

{| class="wikitable"
|-
! Command
! Description
|-
| <code>make package-win-common</code>
| Creates a subdirectory named <code>vlc-x.x.x</code> with all the binaries. You can run VLC directly from this directory.
|-
| <code>make package-win-strip</code>
| Same as above but will create 'stripped' binaries (that is, smallest size, unusable with a debugger).
|-
| <code>make package-win32-7zip</code>
| Same as above but will package the directory in a 7z file.
|-
| <code>make package-win32-zip</code>
| Same as above but will package the directory in a zip file.
|-
| <code>make package-win32</code>
| Same as above but will also create an auto-installer package. You must have NSIS installed in its default location for this to work.
|}

'''''Well done—you're ready to use VLC!'''''

[[Category:Building]]

Documentation:Android

2014-03-31T12:03:16Z

Magsoft:

[[Category:Mobile Device]]

Here is the documentation of the Android port of VLC media player.

SoC 2011

2011-04-12T11:38:42Z

Magsoft: /* VLC Android Port */

'''Google Summer of Code 2011.'''

This wiki page covers the work of the [[VideoLAN]] project as a mentoring organization for [http://code.google.com/soc/ Google Summer of Code], in order to improve {{VLC}}, [[X264]], the H.264 video encoder, and VLMC.

 

== Introduction & Information ==

This wiki page covers the attempt by the [[VideoLAN]] project to act as a mentoring organization for [http://code.google.com/soc/ Google Summer of Code], in order to improve {{VLC}} and [[X264]], the H.264 video encoder.

[[VideoLAN]] was a mentoring organization in [[SoC 2007|2007]], [[SoC 2008|2008]], [[SoC 2009|2009]] and [[SoC 2010|2010]].

*This page list the ideas for VLC and VLMC
*There is also a separate page for project ideas for [[X264]]: '''[[SoC x264 2011]]'''.

If you are a '''student''', please read [[SoC 2011 Rules|the rules and advice]].

=== VLC media player ===

{{VLC}} is a cross-platform multimedia player, encoder and streamer application. It is one of the most successful open-source projects without any professional structure underneath.

{{VLC}} is downloaded at an approximate monthly rate of 5 millions from the main website and that's not including third-party distributions (Linux)!

You can find more information on [http://en.wikipedia.org/wiki/VLC_media_player VLC on Wikipedia] or on this [[Main Page|wiki]].

=== x264 ===

{{x264}} is probably the most popular open source video compression software, used worldwide for applications such as web video, television broadcast, and Blu-ray authoring. It outclasses practically all commercial implementations both speed and compression-wise. While not actually part of VLC or ffmpeg, it is a major library used by both, licensed under the GPL. Due to its popularity in the commercial world (for example, Youtube and Facebook rely on it), many companies have offered bounties in the past for features and improvements that they found useful.

=== Summer of Code ===

If selected and developed, SoC projects for VLC will be included in later releases; SoC projects for x264 will be included in the main tree of the project.

All projects are covered by the GPL licence. (v2+)

== Ideas ==
=== VLC and VLMC ===

'''''Read this'''''

This page is split in three lists of ideas:

#The ''main ideas'' are what seem to be ''key projects'' for VLC and should be more ''thrilling'' than the other ones; we have assigned a potential mentor to each of these.
#The other ideas are less detailed but could be good ideas too.
#VLMC ideas
#[[Mini Projects]] are short-span projects which can be given as Qualification tasks or extended to be Full Summer of Code project.

*'''Original good ideas will be valued'''. Last year, half of the ideas were given by students. We don't want to impose anything. This is free and Open Source software.

If you don't want to apply for SoC but want other ideas to develop on, check the [[Mini Projects]] page!

And on the IRC channel, you can have even more ideas.

=== Ideas for x264 ===

For x264 ideas, please see [[SoC x264 2011]].

== Key ideas for VLC ==

=== New Audio Filters ===

We are looking for a skilled '''audiophile''' that knows a lot about audio theory and practice:

*to create or implement new algorithms, like SRS WoW or other 3D effects
*to work on channels mixing,
*to work on tracks mixing,
*to create scriptable new audio filters in lua and enable users to create whatever audio filtering function they want in a Lua script.
*LADSPA or other libraries integration will be interesting.

This project needs some good audio knowledge and good C experience.

''Qualification task'': port any audio filter from MPlayer

''Proposed mentor: [[User:Geal|geal]]''

=== Porting Audio Filters ===

We are looking for a skilled '''audiophile''' that knows a lot about audio theory and practice:
* to port open source algorithm for audio filters to VLC.

This project needs some good audio knowledge and good C experience.

''Proposed mentor: [[User:Geal|geal]]''

=== UPNP DLNA Server and Client ===

Test and fix service discovery module for UPNP/DLNA shares done by software (mediatomb, xbmc, etc) and hardware implementations.

Provide DLNA plugin for DLNA server compliant with opensource (xbmc, djmount, etc) and proprietary (PS3, xbox360, etc) DLNA clients. Some of the work is already done by previous SoC students.

The plugin must be smart enough to provide "presets" for known DLNA media clients with limited features (PS3 or XBOX360 for starters) which require additional quirks or hacks or items to be transcoded or streamed.

Requires some VLC knowledge as the project will involve using Media Library (arriving in vlc 1.2) and transcoding with VLC API.

''Proposed mentor: thresh''

=== Assembly optimizations in VLC ===

If you are fond of writing ASM and you are fluent in MMX/SSE2/SSE4, there are many interesting things in VLC to speed up.

* Profiling VLC.
* memcpy implementations in SSE* and MMX (see modules/misc/memcpy/fastmemcpy.h)
* video filters ASM speedups (see modules/video_filter/blend.c)
* audio filters ASM speedups (see modules/audio_filter/equalizer.c)
* Porting other ASM video filters to VLC.

This project needs some good ASM knowledge and good C experience.

*Stuff to read: http://www.agner.org/optimize/

''Proposed mentor: [[User:J-b|jb]]''

=== VLC Android Port ===

Improve current VLC [http://git.videolan.org/?p=vlc/vlc-android.git;a=summary android port], improve/add native/java interfaces and design and implement a GUI.
The project can be broken into:

* Build libvlc jni, understand LibVlc.
* Design and implement a cool GUI with gestures and using LibVlc implement callbacks, map user events etc.

''Proposed mentors: ivoire''

=== VLC Test Suite ===

This project aims at making automatic tests to improve VLC quality.

*Write a series of tests for vlc-internal
*Integrate a framework for automated plugins testing with the automake build system
*Automate the different codec playback/mux/etc tests
*Automate the subtitles tests
*Write tests for the different bindings: Mac OS X Framework/Python Bindings... etc.

This project is a code project, require good knowledge of C

''Proposed mentor: Rémi''

=== VLC Personnal Cloud Project 2.0 ===

The personal cloud project is a simple project to allow people to play their media files anywhere in the world.

Through the http interface of VLC, a user can:

*list the medias from the Media Library,
*play those medias,
*those medias get transcoded and streamed in:
**Flash
**Silverlight
**iPhone format
**Android format
**html5
**A VLC webplugin

A good example of the aim is http://www.vodobox.c.la/

This project has to work on the configuration and NAT traversal.

This projects needs knowledge in HTML and JS; it might require C coding.

''Proposed mentor: jb''

=== VLC for Anime ===

We are looking for a skilled '''anime fan''' that knows a lot about anime theory and practice to work on the optimisation of VLC for anime.
Ideas include:

* Improvement of MKV demuxer for special anime needs
* Subtitles display improvements
* video filters that make sense for anime
* metadata and extensions.

''Proposed mentor: jb''

=== SVCD/VCD improvements ===

Menus and such needs to be improvements and fixed.

Proposed mentor: "fenrir"

=== Automatic LibVLC bindings generation ===

libVLC can be used from several programming languages like Java or python to embbed VLC feature inside another application. Anyway, maintaining these binding is power consuming.
VLC needs a way to automatically generate theses binding for a large set of programming languages and keep them up-to-date easily.
We advice to use Swig (from http://www.swig.org/) but any other tool is accepted too.

''Proposed mentor: ivoire''

=== OMA/Atrac improvements ===

We need to improve the oma demuxer to support more features and work on the ATRAC3+ decoder in libavcodec, so people can play their files from MiniDiscs.

''Proposed mentors: Adrian, Michael or other people from linux-minidisc''

=== Playlist improvements ===

We need to reinforce the media library capabilities and its integration with external metadata sources, notably for TV shows.

''Proposed mentor: jetru''

=== AirTune streaming ===

We need to be able to stream everything to your iPhone.

'''Proposed mentor'''

=== BD-J / BD-Live ===

This is a project to go on the work of last year on Blu-Ray Menus

This project requires Java knowledge

''Proposed mentor: jb'''

=== Http interface improvements ===

This is a project to fix and extend the http inteface (also called oldhttp)

The http interface is used by many remote control apps on various platforms. This project would improve the capability of the interface - and thus enable more features in the various remotes that use it.

* get the album art working
**the interface is supposed to return the current album art at /art (assuming 'export album art' is enabled)
**at the moment, this simply doesn't work.
*enable playlist re-ordering
**at the moment, there is no way in the http interface for the playlist order to be changed
*enable access to the graphical equaliser
**should provide a list of presets available
**should provide info on each slider
**should allow user to select a preset
**should allow user to adjust a slider
*speed control
**allow speed to be set in the form host:8080/requests/status.xml?command=speed&val=<someVal>
**show current speed as part of the status.xml response
*subtitle delay control
**(similar to speed control)
*audio delay control
**(similar to speed control)
*enable selection of a subtitle file (by path)

*and lots more...

''Proposed mentor: confusedVorlon''

== Other Ideas for VLC ==

=== WTV support ===
Wtv format support
''Proposed mentor: Laurent''

=== DVD audio support ===
Very difficult project for Audio fans
''Proposed mentor: jb''

=== Device synchronisation===
Sync your mp3 player with the media library
''Proposed mentor: jetru''

=== HD DVD support ===
Very difficult project for someone having the right hardware
''Proposed mentor: jb''

=== Multi-Angle DVD support ===
We need multi-angle DVD support
''Proposed mentor: Meuuh''

== VLC Student Proposals ==

=== Mobile Remote Control ===

(proposed by akashm1990) 

The aim is to make a mobile remote control application for VLC running on the PC. This would be a native application. 

The application will run on a mobile phone connected to the local network over WiFi.(probably using the http interface) 

In addition to the usual remote control functionalities such as play,pause, open new file,volume control,etc. the application aims to implement 2 specific functionalities: 

*On receiving an incoming call, if a video is playing on the PC, it will pause, or if music is playing, the volume may reduce. (user configurable) 
*On receiving an incoming text message, the video playing on screen is paused and the text is displayed onscreen. After a predetermined period of time, the video starts playing again. 

Target Platforms: Android(primary), Symbian-QT (If time permits) 

A video showing the auto pause functionality using Android emulators and the VLC Python API is shown here: 

http://www.youtube.com/watch?v=ou5prh-EoBs

== VLMC ==

VLMC is a non-linear cross-platform video editor based on VLC. We're looking for student(s) with good C++ skills and some experience with Qt with lots of passion of hacking.

Hang with us at #vlmc or #videolan on irc.freenode.net and talk to the developers directly!

To get selected:

1. [http://wiki.videolan.org/Building_VLMC Download and build] VLMC and start playing with it.

2. Implement some feature(s) or fix some bug(s), search VLMC's [http://trac.videolan.org/vlmc/report bug tracker].

3. Send your patch to vlmc-devel@videolan.org for evaluation and work on your GSoC proposal.

4. Get selected and work on your project!

 You'll be greatly appreciated if you complete any of the proposed qualification tasks: (in increasing level of difficulty)

1. [http://trac.videolan.org/vlmc/ticket/134 Bug 134]: Update labels and strings when locale is changed.

2. [http://trac.videolan.org/vlmc/ticket/61 Bug 61]: Improve project timeline widget to have clip thumbnail.

3. [http://trac.videolan.org/vlmc/ticket/145 Bug 145]: Project preview has no sound on Windows.

4. [http://trac.videolan.org/vlmc/ticket/196 Bug 196]: Fix distorted audio playback in project preview.

5. [http://trac.videolan.org/vlmc/ticket/144 Bug 144]: On some platforms, rendered video file has no sound. Identify the problem and fix it.

=== GUI Improvements ===

Difficulty: Medium

Proposed mentor: etix

VLMC needs a GUI make over, using Qt APIs such as graphics view, animation, states etc. Correcting those widgets such as the import window, provide alternative widget so VLMC better fits with the video editing needs.

Many widgets can be rewritten : Import, Library, Clip property... be creative !

=== Quality Improvements: Writing Tests and fixing LibVLC APIs ===

Difficulty: Hard

Proposed mentor: ? (needs a VLC developer to mentor this one)

While rendering preview and project, VLMC may sometimes crash due to bugs in the libVLC. The project will consist of; writing (unit) tests/test-cases for VLMC/libVLC APIs, and identify what's causing the crashes and fixing the bugs. The major area is rendering. Testing should be verified on at least two of the OSs: Linux, Windows and Mac. This project can help VLMC have stable releases and better quality control.

=== Plugin Architecture for VLMC ===

Difficulty: Hard

Proposed mentor: ?

VLMC uses frei0r plugins to add special effects. The project consists of designing and implementing a plugin architecture that can take in lua/python/compiled-plugins(.so) plugins.

Win32CompileMSYSNew

2010-03-15T21:27:48Z

Magsoft:

== Introduction ==

MSYS is a helper environment for MinGW, the compiler chain for Windows based on GCC. It is the fastest way to build VLC natively on Windows.

This howto was re-created by [[User:J-b|Jean-Baptiste Kempf]] and updated in June 2009.

== Install MinGW ==

Use the main installer 5.1.4 found at
http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/MinGW%205.1.4/MinGW-5.1.4.exe/download

Go through the wizard, selecting "Downloading and Install" and using the candidate release. Select gcc, g++ and MinGW make. It should download automatically:
*mingwrt-3.15
*w32api-3.12
*binutils-2.18
*gcc-core-3.4.5
*gcc-g++-3.4.5
*mingw32-make-3.81

== Notes from December 2009 ==

Currently the MinGW installer adds mingwrt-3.17 which is not compatible with the precompiled contribs mentioned below. You should manually download and install 3.15 found at
http://sourceforge.net/projects/mingw/files/MinGW%20Runtime/mingwrt-3.15.2/mingwrt-3.15.2-mingw32-dev.tar.gz/download

The precompiled contribs also require gcc 4.2.1 found at
http://sourceforge.net/projects/mingw/files/GCC%20Version%204/Previous%20Testing_%20gcc-4.2.1-sjlj%20-2/gcc-core-4.2.1-sjlj-2.tar.gz/download
http://sourceforge.net/projects/mingw/files/GCC%20Version%204/Previous%20Testing_%20gcc-4.2.1-sjlj%20-2/gcc-g%2B%2B-4.2.1-sjlj-2.tar.gz/download

After downloading and unpacking those two files you can switch MinGW to use the new version with
mv /mingw/bin/c++.exe /mingw/bin/c++.345.exe
mv /mingw/bin/g++.exe /mingw/bin/g++.345.exe
mv /mingw/bin/gcc.exe /mingw/bin/gcc.345.exe
mv /mingw/bin/g++-sjlj.exe /mingw/bin/g++.exe
mv /mingw/bin/c++-sjlj.exe /mingw/bin/c++.exe
mv /mingw/bin/gcc-sjlj.exe /mingw/bin/gcc.exe

It also needs
http://sourceforge.net/projects/mingw/files/GCC%20Version%204/Current%20Release_%20gcc-4.4.0/gcc-core-4.4.0-mingw32-dll.tar.gz/download
to be installed otherwise there are warnings about a libgcc_s_dw2-1.dll missing when it comes to compiling the qt4 interface.

== Notes from January 2010 ==

Now You can build VLC using GCC 4.4.2 and mingw runtime 3.17 using minor patches:
* Before installing of MSys (after installing of latest mingw) rename MinGW/bin/mingw32-make.exe to mingw/bin/make.exe. It will be renamed back by post install script.
* Install full GCC 4.4.2, and change MinGW\lib\gcc\mingw32\4.4.2\libstdc++.la (<code><nowiki>library_names=''</nowiki></code>) due to bug in latest MinGW.

== Install MSYS ==

* Install 7-zip and Mozilla Firefox
* Install MSys 1.0.11-rc1 with the exe: http://sourceforge.net/project/downloading.php?group_id=2435&filename=MSYS-1.0.11.exe
Accept Post Install: [y]
MinGW Installed? : [y]
path to MinGW: [c:/MinGW]
* Install MSys Developer Tooltkit: http://downloads.sourceforge.net/mingw/msysDTK-1.0.1.exe

=== AutoTools ===

Update your autoconf, automake and libtool by downloading and installing them, keeping in mind that you need to extract the content of the usr folder in C:\Msys
* http://sourceforge.net/projects/mingw/files/MSYS%20autoconf/autoconf-2.63-1/autoconf-2.63-1-msys-1.0.11-bin.tar.lzma/download
* http://sourceforge.net/projects/mingw/files/MSYS%20automake/automake-1.11-1/automake-1.11-1-msys-1.0.11-bin.tar.lzma/download
* http://sourceforge.net/projects/mingw/files/MSYS%20libtool/libtool-2.2.7a-1/libtool-2.2.7a-1-msys-1.0.11-bin.tar.lzma/download

You can also compile them according to:
* http://wiki.enlightenment.org/index.php/EFL_Windows_XP
* http://www.mingw.org/wiki/msys

== Install other tools ==

http://prdownloads.sourceforge.net/mingw/libcrypt-1.1_1-2-msys-1.0.11-dll-0.tar.lzma

Installing mingw-utils is recommended: http://prdownloads.sourceforge.net/mingw/mingw-utils-0.3.tar.gz, extract it to mingw/bin.

Installation of wget too: http://prdownloads.sourceforge.net/mingw/wget-1.9.1-mingwPORT.tar.bz2

Although this is a mingwPORT package it already has a precompiled wget on board.
Extract the .tar.bz2 file. It contains wget.exe in the bin subfolder, extract it to mingw/bin.

=== Install Git and checkout VLC ===

See [[Git_Windows]].

You can also retrieve the source code from [http://www.videolan.org/vlc/download-sources.html VideoLAN Project: VLC media player source code]

=== PKG-CONFIG ===

pkg-config is a mess, this is not NEWS... And you cannot compile it from Windows because of a few bugs...

Get Glib from GNOME: http://ftp.gnome.org/pub/GNOME/binaries/win32/glib/2.18/glib_2.18.2-1_win32.zip
Unzip it to C:\Msys.

Get PKG-CONFIG from GNOME: ftp://ftp.gnome.org/pub/gnome/binaries/win32/dependencies/pkg-config_0.23-3_win32.zip
and ftp://ftp.gnome.org/pub/gnome/binaries/win32/dependencies/pkg-config-dev_0.23-3_win32.zip
Unzip them to C:\Msys.

== Contribs ==

Take the precompiled contribs from:
http://people.videolan.org/~jb/Contribs/

Copy them in your ~
tar xvjf contrib-20090813-win32-bin-gcc-4.2.1-sjlj-runtime-3.15.2-only.tar.bz2 -C /
rm -v /usr/win32/bin/moc /usr/win32/bin/uic /usr/win32/bin/rcc

== Bootstrap VLC ==

cd vlc
cp -v /usr/win32/share/aclocal/* m4/
cp -v /usr/share/aclocal/* m4/
PATH=/usr/win32/bin:$PATH ./bootstrap
It should warn about gettext... Just ignore.

== Configure ==

sh extras/package/win32/configure-msys.sh
* If you downloaded a VLC source code tarball, retrieve ''configure-msys.sh'' and ''configure-common.sh'' from [[http://git.videolan.org/?p=vlc.git;a=summary vlc.git]] / extras / package / win32 /
* If Your user name starts from "u" or "x" characters, change config.h (double all backslashes in COMPILED_BY constant to avoid compilation errors) after configuring.

== Compile ==

PATH=/usr/win32/bin:$PATH make
If you have Cygwin and others tools installed, try using a shorter PATH inside MSYS shell i.e.
$ echo $PATH
.:/usr/local/bin:/mingw/bin:/bin

==Creating self-contained packages==

Once the compilation is done, build self-contained VLC packages with the following "make" commands:

make package-win32-base

(This will create a subdirectory named vlc-x.x.x with all the binaries "stripped" without any debugging symbols).

make package-win32-zip

(Same as above but will package the directory in a zip file).

make package-win32

(Same as above but will also create an auto-installer package. You will need to have NSIS installed in its default location for this to work).

* If you have permissions problems running make package-*, chmod 777 -R the vlc folder.
* If you have permissions problems running vlc.exe after packaging, rename or delete vlc.exe.manifest

== Random bootstrap, configure, and make errors ==

There have been reports of random msys errors during bootstrap, configure, and make. They usually don't repeat themselves between runs. Rule out that your mingw-msys installation is at fault by building in windows safe mode. Even if this works, it may then be more practical to try a cross-compilation build.

Win32CompileCygwinNew

2008-03-07T16:51:04Z

Magsoft:

This is a new version of the Win32CompileCygwin written by Jean-Baptiste Kempf

'''This version ONLY works for 0.9.x.'''

=Introduction=

This is a guide for Windows users with a step-by-step instruction to download, install, configure and build your VLC.

This guide uses [http://www.cygwin.com '''Cygwin'''] a Linux-like environment for Windows used for compilation of the VLC source code.

Start off by creating a VLC and a download folder on your hard drive where you can put all the installation files:

C:\VLC\
C:\VLC\Downloads

For further reference, the assumption is made that the local user will be 'Administrator'.

=Cygwin=

Download the latest [http://www.cygwin.com/cygwin/setup.exe Cygwin setup] and save it in your download location:

C:\VLC\Downloads\

More info about Cygwin can be found at http://www.cygwin.com or http://sourceware.org/cygwin

==Selecting Cygwin packages to install==

Run the setup program with the following options:

Installation type : Install from Internet (default)

Root directory : C:\cygwin (default)

Local Package directory : C:\VLC\Downloads\cygwin (your download location)

Internet Connection : Direct Connection (preferred, if it fails try another)

Download Site : Choose a download site closest to you (FTP preferred)

At the "Select Packages" section of the installation process you can select packages by clicking the button with the rotating 2 arrows. (This is under the "New" section). It shows "Skip" next to the button if the package isn't selected yet.

Clicking the button a few times will rotate through the possible package versions including "Skip" (meaning do not install or remove if installed) and "Keep" (meaning keep using the current installed version). If a package was already installed it will also show the "Current" version just to the left of it.

Select the following packages (some others will automatically be selected as well):

Archive
unzip
zip

Devel
autoconf
automake
binutils
cvs
expat
gcc
gcc-core
gcc-g++
gcc-mingw
gcc-mingw-core
gcc-mingw-g++
gdb
gettext
gettext-devel
git
libtool1.5
make
mingw-runtime
nasm
patchutils
pkg-config
subversion

Editor
vim

Lib
libgcrypt

Web
curl (optional: for building extras/contrib)
wget (optional: for building extras/contrib)

==Cygwin environment==

Start Cygwin from the icon on your desktop. If it runs for the first time it will automatically create a home\"username" folder in the Cygwin environment; user being the currently logged on Windows user. Assuming this is the 'Administrator' user it will create the following folder:

C:\cygwin\home\Administrator (example)

NOTE: On your desktop, you can rightclick the Cygwin icon and (in the Options field of the Cygwin Properties) set the Command history Buffer size to as large as possible: 999. This setting will make it possible to scroll back further in the Cygwin environment.

=VLC source code=

== Git ==
The very latest VLC source code can be obtained through a tool called Git. The Cygwin package we're about to install comes with an internal git component.

cd /cygdrive/c/VLC/

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

== Snapshots ==

You can do the same by using the snapshots in the nightly builds site.

=Bootstrap=

Open the configure.ac file, and modify the requirement for gettext 0.16.1 to 0.15.

cd vlc-trunk
./bootstrap

= External libraries to the source code=

VLC depends on other libraries (code) to provide some features like AC3 audio or MPEG-4 video encoding/decoding etc.

Depending on your needs you will have to install and compile some or all of these external libraries.

== Win32 "contrib" package ==

A package with most of these libraries already compiled so it's actually really easy to compile a full-featured version of vlc can be found here:

http://download.videolan.org/pub/testing/win32/

Download the latest version of a "contrib" package for win32:

contrib-20060730-win32-bin-gcc-3.4.5-only.tar.bz2 (example)

Those days, you should use
http://people.videolan.org/~jb/Contribs/contrib-20080215-win32-bin-gcc-4.2.1-sjlj-runtime-3.13-only.tar.bz2

It's a good idea to check the INSTALL.Win32 file in the VLC source directory for the appropriate contrib download file.

Save it into your download location:

C:\VLC\Downloads\

==Installing the Win32 "contrib" package in Cygwin==

Start Cygwin and enter the following command in your shell:

cd /cygdrive/c/VLC/Downloads
tar xf contrib-20080215-win32-bin-gcc-4.2.1-sjlj-runtime-3.13-only.tar.bz2 -C /

Replace with your version of the "contrib" file and DON'T FORGET THE / (slash)
at the end.

This will extract the contents of the file into usr/win32 folder within your Cygwin environment.

NOTE: Make sure to DELETE your old version instead of extracting a new version on top of it.

==Keeping the Win32 "contrib" package up-to-date==

For maintenance purposes periodically check:

http://download.videolan.org/pub/testing/win32/

to see if a newer "contrib" is available. If that is the case you should DELETE the existing directory structure which is for the precompiled "contrib" package:

C:\cygwin\usr\win32 (example)

Download the newer file and follow the installation instructions the same as before so you will end up with the most up-to-date version.

NOTE: Make sure to DELETE your old version instead of extracting a new version on top of it.

=Configure=

In order to make our lives just a bit easier the following section describes what commandline options should be used for compiling and those commands will then be put into a "script" that can be executed (rather than having to copy and paste all the time).

==Configure script for compiling VLC==

Create a new text document with the following lines:

PATH=/usr/win32/bin:$PATH \
PKG_CONFIG_PATH=/usr/win32/lib/pkgconfig \
CPPFLAGS="-I/usr/win32/include -I/usr/win32/include/ebml" \
LDFLAGS=-L/usr/win32/lib \
CC="gcc -mno-cygwin" CXX="g++ -mno-cygwin" \
./configure \
--host=i686-pc-mingw32 \
--disable-gtk \
--enable-nls --enable-sdl --with-sdl-config-path=/usr/win32/bin \
--enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
--with-ffmpeg-zlib --enable-faad --enable-flac --enable-theora \
--with-wx-config-path=/usr/win32/bin \
--with-freetype-config-path=/usr/win32/bin \
--with-fribidi-config-path=/usr/win32/bin \
--enable-live555 --with-live555-tree=/usr/win32/live.com \
--enable-caca --with-caca-config-path=/usr/win32/bin \
--with-xml2-config-path=/usr/win32/bin \
--with-dvdnav-config-path=/usr/win32/bin \
--disable-cddax --disable-vcdx --enable-goom \
--enable-twolame --enable-dvdread \
--enable-debug --enable-dca

NOTE: The following options are added for debug purposes and makes the final package a bit larger but the advantage is it's easier to debug in case of crash reports:

--disable-optimizations
--enable-debug

If you want to report a crash bug to the VLC team, it is necessary that you provide a stack backtrace. Unfortunately, Windows automatic crash reporter cannot generate such a backtrace as debug symbols used by GCC compiler aren't understood by Windows, therefore we suggest that you install Dr. MinGW (http://jrfonseca.dyndns.org/projects/gnu-win32/software/drmingw/) which will extend Windows Just-In-Time Debugger and provide the necessary debug information.

NOTE: The following options is needed for Qt4 support:

--enable-qt4

As of version 0.9.0 VLC will include the Qt interface. More information can be found about QT here: http://www.trolltech.com

The "Win32 contrib package" at present includes the linux and Windows equivalents of uic, moc and roc executables which are required for building this interface.

The linues executables have to be '''deleted''' from the contrib folder:

C:\cygwin\usr\win32\bin\moc (example)
C:\cygwin\usr\win32\bin\rcc (example)
C:\cygwin\usr\win32\bin\uic (example)

Save as filename in your "scripts" folder at your download/install location:

configure-vlc.sh

NOTE: Save using "All files" and not "Text files" otherwise Windows might append the extension .txt

Copy the file into your home directory:

C:\cygwin\home\Administrator

Start Cygwin and enter the following command in your shell:

dos2unix configure-vlc.sh

===POSIX emulation layer===

VLC can be built with or without the so called POSIX emulation layer. Without is the default and is usually better (and with hasn't been tested for quite some time). If you do want to use the emulation layer, then just leave out the line with the following options:

CC="gcc -mno-cygwin" CXX="g++ -mno-cygwin"

=Compiling source code=

It's time to start Cygwin again...

==Compiling VLC==

Enter the following commands in your Cygwin shell:

cd vlc-trunk

(you can check with the pwd command to see in which folder you are and with just the cd
command without any additional parameters you can change back to your home directory).

NOTE: The following line is optional, only use that if you have problems compiling.

./toolbox --distclean

(This will have removed everything except code related stuff).

../configure-vlc.sh

make

Cross your fingers...

NOTE: ./ means you run an application/script from the "current folder" (which is vlc-trunk) and ../ points to "one directory up" (which is where configure-vlc.sh is).

==Creating self contained packages==

Once the compilation is done, you can either run VLC directly from the source tree or you can build self-contained VLC packages with the following "make" commands:

make package-win32-base

(This will create a subdirectory named vlc-x.x.x with all the binaries "stripped" without any debugging symbols).

make package-win32-zip

(Same as above but will package the directory in a zip file).

make package-win32

(Same as above but will also create an auto-installer package. You will need to have NSIS installed in its default location for this to work).

=Advanced usage=

==Updating Cygwin package versions==

If you need to update or install additional packages you can just run the Cygwin setup.exe from your download location:

C:\Downloads\cygwin\setup.exe (example)

==GDB (Gnu Debugger)==

This section requires that you installed the gdb (Gnu Debugger) in Cygwin.

This is a typical example of creating a crashlog:

cd vlc-trunk

gdb --args vlc.exe --fast-mutex --reset-config --reset-plugins-cache

NOTE: vlc-0.9.0 uses libtool for building sources, if you want to debug from the source tree, you should type the following command instead:

libtool -mode=execute gdb --args vlc --reset-config --reset-plugins-cache

In the debugger mode run the program and make sure you reset the preferences!

(gdb) run

NOTE: the (gdb) is just a prompt which means you are in the debugger mode, please note that ''--fast-mutex'' option is no longer supported in vlc-0.9.0

It will now take a lot longer than usual for VLC to start :)

Now operate VLC as you would normally do. As soon as a crash issue occurs
you'll notice a line like this:

Program received signal SIGSEGV, Segmentation fault.
0x0041394c in playlist_ItemGetById (p_playlist=0x19ec4f8, i_id=29)
at src/playlist/item-ext.c:459
---Type <return> to continue, or q <return> to quit---
459 i = i_bottom + ( i_top - i_bottom ) / 2;

Now you can do a "backtrace" by using the bt command:

(gdb) bt

And output similar to this will be created:

#0 0x0041394c in playlist_ItemGetById (p_playlist=0x19ec4f8, i_id=29)
at src/playlist/item-ext.c:459
#1 0x0b26bbf7 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
{m_pItem = 0x29fef8}) at playlist.cpp:695
#2 0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
{m_pItem = 0x29e8b0}) at playlist.cpp:689
#3 0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
{m_pItem = 0x29a818}) at playlist.cpp:689
#4 0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
{m_pItem = 0x299718}) at playlist.cpp:689
#5 0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
{m_pItem = 0xffff0000}) at playlist.cpp:689
#6 0x0b26bf49 in wxvlc::Playlist::AppendItem (this=0x1822e288,
event=@0x1827afd0) at playlist.cpp:564
#7 0x0b2757fc in wxvlc::Playlist::OnPlaylistEvent (this=0x1822e288,
event=@0x1827afd0) at playlist.cpp:1438
#8 0x0b3771b8 in wxEvtHandler::ProcessEventIfMatches ()
at /usr/win32/include/wx-2.6/wx/event.h:2183
#9 0x0b376a1c in wxEventHashTable::HandleEvent ()
at /usr/win32/include/wx-2.6/wx/event.h:2183
#10 0x0b37730d in wxEvtHandler::ProcessEvent ()
at /usr/win32/include/wx-2.6/wx/event.h:2183
#11 0x0b37711b in wxEvtHandler::ProcessPendingEvents ()
at /usr/win32/include/wx-2.6/wx/event.h:2183
---Type <return> to continue, or q <return> to quit---
#12 0x0b376017 in wxAppConsole::ProcessPendingEvents ()
at /usr/win32/include/wx-2.6/wx/event.h:2183
#13 0x0b3ec75a in wxIdleWakeUpModule::MsgHookProc ()
at /usr/win32/include/wx-2.6/wx/bmpbuttn.h:81
#14 0x773aca2d in USER32!GetScrollRange ()
from /cygdrive/c/WINDOWS/system32/user32.dll
#15 0x00000000 in ?? () from
(gdb)

To backtrace all the running threads use:

(gdb) thread apply all bt

These are the log outputs that are more usefull to developers than just mentioning "it crashes"!

NOTE: In GDB mode there are sometimes situations where GDB initially "crashes" on certain network activity (opening network shares, network traffic) which in normal operation does not occur. Just select c for continue until "normal" operation continues.

== Common errors ==
===vlc.exe: Permission denied===

A make finished successfully and produced vlc.exe, but running the executable returns the following:

bash: ./vlc.exe: Permission denied

The permissions on both vlc.exe & vlc.exe.manifest must be set to executable.

FIX: Type the following:

chmod 755 vlc.exe vlc.exe.manifest

===error: parse error before '(' token===

A make (compile) of FFmpeg results in the following error:

/usr/include/sys/unistd.h:203: error: parse error before '(' token
make[1]: *** [ffm.o] Error 1

It's very likely you are usix the POSIX emulater which you shouldn't...

FIX: compile with the option

-mno-cygwin

==error: expected primary-expression before '<<' token==

In file included from /usr/lib/gcc/i686-pc-mingw32/3.4.4/../../../../include/w32
api/windows.h:52,
from ../../../include/vlc_common.h:459,
from ../../../include/vlc/vlc.h:153,
from dshow.cpp:31:
/usr/lib/gcc/i686-pc-mingw32/3.4.4/../../../../include/w32api/wingdi.h:3:1: warn
ing: this is the location of the previous definition
In file included from /usr/win32/include/dshow.h:35,
from common.h:45,
from dshow.cpp:35:
/usr/win32/include/ddraw.h:14: warning: ignoring #pragma warning
In file included from /usr/win32/include/dshow.h:35,
from common.h:45,
from dshow.cpp:35:
/usr/win32/include/ddraw.h:5552: warning: ignoring #pragma warning
In file included from /usr/win32/include/dshow.h:45,
from common.h:45,
from dshow.cpp:35:
/usr/win32/include/strmif.h:2: warning: ignoring #pragma warning
In file included from /usr/win32/include/dsound.h:13,
from /usr/win32/include/amaudio.h:18,
from /usr/win32/include/dshow.h:47,
from common.h:45,
from dshow.cpp:35:
/usr/win32/include/d3dtypes.h:22: warning: ignoring #pragma warning
/usr/win32/include/d3dtypes.h:1813: warning: ignoring #pragma warning
In file included from /usr/win32/include/dshow.h:48,
from common.h:45,
from dshow.cpp:35:
/usr/win32/include/control.h:2: warning: ignoring #pragma warning
dshow.cpp: In function `int CommonOpen(vlc_object_t*, access_sys_t*, vlc_bool_t)
':
dshow.cpp:456: error: expected primary-expression before '<<' token
dshow.cpp:456: error: expected primary-expression before '<<' token
dshow.cpp:456: error: expected primary-expression before '<<' token
dshow.cpp:456: error: expected primary-expression before '<' token
dshow.cpp:456: error: expected primary-expression before '.' token
dshow.cpp:470: error: expected primary-expression before '==' token
dshow.cpp:470: error: expected primary-expression before '==' token
dshow.cpp:470: error: expected primary-expression before '==' token
dshow.cpp:470: error: expected primary-expression before '=' token
dshow.cpp:484: error: expected primary-expression before '>>' token
dshow.cpp:484: error: expected primary-expression before '>>' token
dshow.cpp:484: error: expected primary-expression before '>>' token
dshow.cpp:484: error: expected primary-expression before '>' token
dshow.cpp:484: error: expected primary-expression before '.' token
dshow.cpp:485: error: expected `;' before "IAMCrossbar"
dshow.cpp:491: error: `pXbar' undeclared (first use this function)
dshow.cpp:491: error: (Each undeclared identifier is reported only once for each
function it appears in.)
make[6]: *** [libdshow_plugin_a-dshow.o] Error 1
make[6]: Leaving directory `/home/Administrator/vlc-trunk/modules/access/dshow'
make[5]: *** [all-modules] Error 1
make[5]: Leaving directory `/home/Administrator/vlc-trunk/modules/access/dshow'
make[4]: *** [all-recursive] Error 1
make[4]: Leaving directory `/home/Administrator/vlc-trunk/modules/access'
make[3]: *** [all] Error 2

Basically in case of conflict svn adds "<<< mine" and "=======" and ">>>> r1242" which makes gcc complain.

FIX: revert the offending file

==Objective C source seen but `OBJC' is undefined==

The configure process stops halfway.

+ aclocal-1.9 -I m4
+ autoconf
+ autoheader
+ automake-1.9 --add-missing --copy -Wall
configure.ac: installing `autotools/install-sh'
configure.ac: installing `autotools/missing'
activex/Makefile.am:143: shell $(VLC_CONFIG: non-POSIX variable name
activex/Makefile.am:143: (probably a GNU make extension)
activex/Makefile.am: installing `autotools/compile'
activex/Makefile.am: installing `autotools/depcomp'
modules/gui/macosx/Makefile.am: Objective C source seen but `OBJC' is undefined
modules/misc/testsuite/Makefile.am: Objective C source seen but `OBJC' is undefi
ned
src/Makefile.am: Objective C source seen but `OBJC' is undefined
Makefile.am:282: user target `vlc$(EXEEXT)' defined here...
/usr/share/automake-1.9/am/program.am: ... overrides Automake target `vlc$(EXEEX
T)' defined here
Makefile.am:230: while processing program `vlc'
make: *** No targets specified and no makefile found. Stop.

This problem is related to a warning earlier on and only occured in a few revisions where a built-in workaround wasn't working properly:

+ echo 'Enabling provisional autoconf 2.59 work-around. Update autoconf ASAP.'
Enabling provisional autoconf 2.59 work-around. Update autoconf ASAP.

FIX: update autoconf to 2.60 or newer. If Cygwin doesn't provide this version yet then build it yourself from extras/contrib.

Enter the following commands in your Cygwin shell:

cd vlc-trunk/extras/contrib

./bootstrap

cd src

make .autoconf

There should now be compiled autoconf version (probably 2.60 or newer) in extras/contrib that the bootstrap process will use.

Now start the whole "Compile VLC" process from the start again.

==Error: cannot create temporary file for diversion: Permission denied==

If the above error appears, it might mean you don't have the TMPDIR defined in cygwin. You will need to define it and have its value point to your temporary directory.

=Version=

20050627 Initial version

20050628 Updated some more exceptions

20050628 Some info added about FFmpeg compiling with AMR

20050629 Finalized FFmpeg compiling

20050630 Cross-compiling

20050724 Some extra compile explanations

20050726 Removed cross-compiling (was for linux -> win32) Patching source code with .diff files

20050823 Added zlib error

20050923 --enable-sdl --with-sdl-config-path=/usr/win32/bin added to configure. Added debug section

20051102 Changed FFmpeg lib names

20051128 Detailed Cygwin upgrade/downgrade for gcc 3.3. Renamed some update scripts. Added FFmpeg CVS update. --disable-gnomevfs added to configure (only used on linux)

20060121 PKG_CONFIG_PATH=/usr/win32/lib/pkgconfig added to configure

20060128 Added curl and libtool to Cygwin for those that want to be able to build extras/contrib themselves

20060217 Added make install-libs install-headers to FFmpeg compile

20060222 Remark about missing "gettext" libs for Cygwin during install

20060225 ./bootstrap: you need libtool

20060618 Updated GCC to 3.4 version and added FFmpeg SVN and DTS support

20060805 Added note about using older binutils and gdb for Cygwin!

20060915 Added note about updating autoconf from extras/contrib for an OBJC problem during configure

20061108 Added note this document is no longer usable since Cygwin has been unusable probably related to some bash/dos2unix change

20070612 Added note about --enable-dca

20080228 New version

20080307 Added --host=i686-pc-mingw32 option to the configure script

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