VideoLAN Wiki - User contributions [en]

VDD15

2015-09-17T15:41:51Z

Flameeyes: Move the group hoto to Saturday.

= Welcome to VideoLAN Dev Days 2015 =

'''The Open Multimedia Conference that frees the cone in you!'''

This is a technical un-conference; please bring laptops, power cords, power extensions, RJ45 cables and a '''good mood''' with you.

= Schedule =
== Thursday, September 17th 2015 ==

Nothing is prepared for that day, but for people early at the hotel, we will get drinks at the hotel, at around 21:00.

Find Felix :D

== Friday, September 18th 2015 ==

=== Community day ===
If you subscribed for the community day, you should have received instructions by e-mail.

Meeting point is '''at''' EuroDisney at '''9:45'''. The theme park opens at '''10:00''' and closes at '''21:00'''.

==== How to get there ====
The best option is to take the Metro/RER. This takes approximately 1 hour and 5 minutes:
* take metro ''Line 13'' from the hotel to '''St Lazare''', then
* take metro ''Line 3'' from '''St Lazare''' to '''Havre-Caumartin''' (1 stop only),
* take the express train ''RER A'' to '''Marne La Vallée-Chessy'''
** check on the platform display before boarding: not all trains go to Marne La Vallée-Chessy!

'''N.B.:''' You should buy a ticket to Marne La Vallée at the metro station. The ticket is valid for the entire journey.

=== Evening drinks ===
We will meet at a local bar, for drinks (soft and beers), at around '''20:30'''.

The name will be announced later, when confirmed, but should not be too far from the hotel.

== Saturday, September 19th 2015 ==

=== Morning ===

{| class="wikitable" style="width: 100%;"
|-
!style="width: 10%;"| Time || Description
|-
| '''8:45 - 9:30''' || Registration and Breakfast
|-
| '''9:30 - 9:45''' || '''Opening remarks''' by Jean-Baptiste Kempf ''(VideoLAN)''
|-
| '''9:45 - 10:20''' || '''Daala''' by Timothy Terriberry ''(Mozilla)''
|-
| '''10:20 - 10:55''' || '''A new AAC free and open-source encoder''' by Rostislav Pehlivanov ''(FFmpeg)''
|-
| '''10:55 - 11:05''' || ''Coffee break''
|-
| '''11:05 - 11:40''' || '''New video compression techniques under consideration for VP10''' by Alex Converse ''(Google)''
|-
| '''11:40 - 12:10''' || '''An update to x265''' by Deepthi Nandakumar ''(MCW)''
|-
| '''12:10 - 12:40''' || '''VLC 3.0''' by Jean-Baptiste Kempf ''(VideoLAN)''
|-
| '''12:40 - 12:45''' || '''Spice''' by Lord Julien Navas ''(Vodkaster)''
|}

'''GROUP PHOTO''' after lunch, before the afternoon sessions!

=== Afternoon ===

{| class="wikitable" style="width: 100%;"
|-
!style="width: 10%;"| Time !! Description
|-
| '''14:00 - 14:40''' || '''The Thor Codec''' by Thomas Davies ''(Cisco)''
|-
| '''14:40 - 15:00''' || '''How to optimize press coverage for FLOSS projects''' by Sebastian Grüner ''(golem.de)''
|-
| '''15:00 - 15:20''' || '''VP9 encoding/decoding performance vs. H.264/HEVC''' by Ronald Bultje ''(FFmpeg)''
|-
| '''15:30 - 18:00''' || ''Break-out sessions''
|}

==== Break-out sessions, Saturday ====
{| class="wikitable" style="width: 100%; text-align: center"
|-
! style="width: 10%;"| Time
! style="width: 18%;"| Auditorium
! style="width: 18%;"| Room 1
! style="width: 18%;"| Room 2
! style="width: 18%;"| Room 3
! style="width: 18%;"| Room 4
|-
! 15:30 - 16:45
|
| '''VLC technical discussion'''
|
|
|
|-
! 16:45 - 17:00
| colspan="5" | ''Coffee Break''
|-
! 17:00 - 18:00
|
| VLC Mobile Ports discussion
|
|
|
|-
! 18:00 - 19:30
|
| '''VideoLAN annual meeting''' Assemblée Générale Ordinaire, Assemblée Générale Extraordinaire && Réunion 
This is for '''VideoLAN non-profit''' members.
|
|
|
|}

=== Dinner ===
Dinner is at '''20:00''' next to the place, at The Royal Trinité.

59 Rue de Châteaudun, 75009 Paris, France

[https://goo.gl/maps/30dCb Royal Trinité]

You '''must''' choose your food before, by [http://goo.gl/forms/4yZx5l8bZg selecting here].

== Sunday, September 20th 2015 ==

{| class="wikitable" style="width: 100%; text-align: center"
|-
! style="width: 10%;"| Time
! style="width: 18%;"| Auditorium
! style="width: 18%;"| Room 1
! style="width: 18%;"| Room 2
! style="width: 18%;"| Room 3
! style="width: 18%;"| Room 4
|-
! 9:30 - 10:00
| colspan="5" | ''Breakfast''
|-
! 10:00 - 10:45
|
| VLC/iOS meetup
|
|
|
|-
! 10:45 - 11:30
|
| VLC/Android meetup
|
|
|
|-
! 11:30 - 11:45
| colspan="5" | ''Coffee break''
|-
! 11:45 - 12:45
|
|
|
|
|
|-
! 12:45 - 14:00
| colspan="5" | ''Lunch break''
|-
! 14:00 - 14:45
|
|
|
|
|
|-
! 14:45 - 15:30
|
|
|
|
|
|-
! 15:30 - 15:45
| '''Closing Remarks''' by Jean-Baptiste Kempf ''(VideoLAN)''
| —
| —
| —
| —
|-
! 15:45 - 17:00
|
|
|
|
|
|-
! 17:00 - 18:00
|
|
|
| VideoLAN '''roots''' meeting
|
|}

= Practical information =

== Emergency situation ==
In case of emergency, call the European emergency number '''112'''.

== Location / main venue ==
The venue is in Paris (France), 9th district, near St Lazare:

Criteo 
32 rue Blanche 
75009 Paris, France

[https://www.google.fr/maps/place/Criteo/@48.878914,2.3315591,17z/data=!4m6!1m3!3m2!1s0x47e66e04d509ec8f:0xbf35e94464e752f7!2sCriteo!3m1!1s0x47e66e04d509ec8f:0xbf35e94464e752f7 Google Maps]

== Accomodation / Hotel ==
For sponsored participants, the hotel is:

Timhotel Berthier Paris 17 
4 Boulevard Berthier 
75017 Paris, France

http://www.timhotel-berthier-paris-17.com/ 
[https://www.google.fi/maps/place/Timhotel+Berthier+Paris+17/@48.894398,2.312611,17z/data=!3m1!4b1!4m2!3m1!1s0x47e66f9878ba126d:0x24a180f7131eebe5 Google Maps]

== Payment ==
The local currency is the Euro. Merchants are forbidden from accepting other currencies (except exchange).

Most venues will accept EMV credit and debit cards (i.e. Chip & PIN), at least VISA and MasterCard. Swipe-only cards can be more tricky (it has been illegal for banks to issue them for years in France, so only foreign visitors use them). American Express is widely but not universally accepted. Diners/Discovery, UnionPay, JCB, etc. are mostly only accepted in shops catering to tourists.

Best change rates are close to the Hotel, Metro Bourse, Vivienne Street.

== Transportation ==

* Public transport: [http://www.ratp.fr/itineraires/en/ratp/recherche-avancee RATP]
* Attendees arrival & departure list: [[VDD15/Attendees]]

'''NOTE''': VideoLAN does not refund taxi expenses nor car rentals.

=== Paris-CDG / Roissy airport ===

'''Important note:''' there are works on the RER B line at night until Friday, included. The RER B service is interrupted between the airport and the Aulnay-sous-Bois station at 11pm. There is a replacement bus available but this incurs a much higher trip time. More information: http://www.transilien.com/contents/fr/Docs---PDF/Travaux/20150720-B-Roissy-2007au3010bis.pdf

* Upon landing, follow the signs for local trains. There is one station for T1/T3 and one for T2 (A-G).
* At the station, look for '''blue/green''' ticket vending machines.
** Do not use the yellow/grey machines (at terminal 2), those are for long distance trains only.
* Buy a ticket for zones 1-5 (to Paris). The cost is 10€ one way. Credit cards are accepted.
** If you only have cash, you have to queue at the staffed ticketing booth ("''Billeterie''" in French)
* Take the regional express(RER) line B (blue). You can use any train toward Paris.
* Alight at ''Gare du Nord''.
* See below from Gare du Nord.

* 2€ Alternative From/To ''Palais Royal /Louvre'': http://www.easybus.com/fr/paris-cdg (online booking), takes 50min

=== Orly (ORY) airport ===
* Upon landing, follow the signs for Orlyval.
* At the station, buy the ticket from the vending machines, before boarding.
* Buy a ticket for Paris. The cost is 12€ one way. Credit cards are accepted.
** If you only have cash, you have to queue at the staffed ticketing booth ("''Billeterie''" in French)
* Take the Orlyval to Antony. Then take the regional express(RER) line B (blue) to Paris (Direction Charles de Gaulle Airport).
* Alight at ''Gare du Nord''.
* See below from Gare du Nord.

=== Beauvais (BVA) airport ===
We feel sorry for you. Take the bus.

=== Gare du Nord (North railway station) ===

If you arrive at Gare du Nord or Gare de l'Est, you need to buy a zone 1 / Paris ticket. It is valid on the subway, the tramway, busses and, '''within the Paris city limits''', on the regional express trains (RER).

==== To the conference venue ====
* Transfer to regional express train (RER) line E (magenta) toward ''Haussmann St Lazare''.
* Alight at the final stop, ''Haussman St Lazare''.

Walking route:
[https://www.google.fr/maps/dir/32+Rue+Blanche,+75009+Paris,+France/Haussmann+-+Saint-Lazare,+France/@48.8767778,2.3281097,17z/data=!3m1!4b1!4m14!4m13!1m5!1m1!1s0x47e66e49a8a4ba55:0x95f959c0c70dfded!2m2!1d2.3316096!2d48.8788866!1m5!1m1!1s0x47e66e35df16346b:0x5b4b229d8b94e143!2m2!1d2.329037!2d48.875188!3e2 Google Maps]

==== To the sponsored hotel ====
* Continue from ''Haussman Saint Lazare'' (2 stops) above
* Transfer to subway(M) '''line 13''' toward ''Asnières'' or ''Gennevilliers''.
* Get off at '''Porte de Clichy''' (6 stops)

The hotel is just around the corner.

=== Gare de l'Est (East railway station) ===
Routes are essentially the same as from Gare du Nord. The Magenta express train station is located between Gare du Nord and Gare de l'Est. See above.

=== Gare de Lyon (South/East railway station) ===
If you arrive at Gare de Lyon, you need to buy a zone 1 / Paris ticket. It is valid on the subway, the tramway, busses and, '''within the Paris city limits''', on the regional express trains (RER).

==== To the conference venue ====

* Take subway(M) '''line 14''' toward ''Saint Lazare''
* Alight at the final stop '''Saint Lazare''' (5 stops)

Walking route:
[https://www.google.fr/maps/dir/32+Rue+Blanche,+75009+Paris,+France/Haussmann+-+Saint-Lazare,+France/@48.8767778,2.3281097,17z/data=!3m1!4b1!4m14!4m13!1m5!1m1!1s0x47e66e49a8a4ba55:0x95f959c0c70dfded!2m2!1d2.3316096!2d48.8788866!1m5!1m1!1s0x47e66e35df16346b:0x5b4b229d8b94e143!2m2!1d2.329037!2d48.875188!3e2 Google Maps]

==== To the sponsored hotel ====
* Continue from ''Haussman Saint Lazare'' (2 stops) above
* Transfer to subway(M) '''line 13''' toward ''Asnières'' or ''Gennevilliers''.
* Get off at '''Porte de Clichy''' (6 stops)

The hotel is just around the corner.

=== Other? ===

== From the hotel to the conference ==
* Take subway(M) line 13 toward ''Chatillon-Montrouge''
* Get off at ''Liège'' and walk

Feel free to ask for advice on the mailing list if your station is missing.

== Connectivity ==

=== Power supply ===

The AC power sockets are "French" '''IEC type E'''. Connectors from "German" '''IEC type F''' countries should fit safely, as they are usually bi-standards. There should have a hole for the French-style ground pin.

The electrical system is '''220V / 50Hz'''. If you come from outside Europe, please make sure your devices are compatible beforehand.

=== Internet ===
Hopefully, there will be Wi-Fi.

== Weather forecast ==

:Fri Sep 18 Occasional rain 20°C Low 12°C
:Sat Sep 19 Occasional rain 19°C Low 10°C
:Sun Sep 20 Fog 20°C Low 12°C
:Mon Sep 21 Mostly cloudy 18°C Low 12°C

In Fahrenheit, this is a high of 64°F-66°F and a low of 50°F.

[[Category:About VideoLAN]]

VDD15/Attendees

2015-09-10T08:31:39Z

Flameeyes:

= Arrivals =
Please order chronologically by time of arrival.

{| border="1" class="sortable"
! Name
! IRC
! Time
! Port
! Vessel
! Notes
|-
| Arwa Arif
| arwa
| 2015-09-17 08:20
| CDG airport
| 9W 126
| from BOM
|-
| Tim Miller
| drasticactions
| 2015-09-17 08:35
| CDG airport
| DL 243 (AF 3655)
| from BOS
|-
| Rostislav Pehlivanov
| atomnuker
| 2015-09-17 10:17
| Gare du Nord
| TGV TMST
| from London
|-
| Alex Converse
| peloverde
| 2015-09-17 10:45
| CDG airport
| UA 990
| from SFO
|-
| Manfred Georg
|
| 2015-09-17 11:35
| CDG airport
| AF 83 (DL 8599)
| from SFO
|-
| Thomas B. Rücker
| tbr
| 2015-09-17 14:20
| CDG airport T2D
| AY 875
| from HEL(l)
|-
| Kieran Kunhya
| kierank
| 2015-09-17 16:47
| Gare du Nord
| Eurostar
| from London
|-
| Henrik Gramner
| Gramner
| 2015-09-17 17:25
| CDG airport
| SK559
| from Copenhagen/CPH
|-
| Ludmila Glinskih
| lglinskih
| 2015-09-17 17:35
| CDG airport
| AF 1465
| from LED
|-
| Derek Buitenhuis
| Daemon404
| 2015-09-17 20:00
| CDG airport
| 4U 8404
| from Berlin
|-
| David Fuhrmann
| d-fu
| 2015-09-17 20:54
| Gare de Est
| TGV 9552
|
|-
| Francois Cartegnie
|
| 2015-09-17 21:16
| Gare de Lyon
| TGV 6198
|
|-
| Konstantin Pavlov
| thresh
| 2015-09-17 22:30
| CDG airport T2C
| SU 2460
| from Moscow/SVO
|-
| Tristan Matthews
| tmatth
| 2015-09-18 07:35
| CDG airport
| AC 884
| from Montreal/YUL
|-
| Julian Scheel
| _julian
| 2015-09-18 07:55
| CDG airport
| AF1611
| from Hamburg/HAM
|-
| Ronald S. Bultje
| BBB
| 2015-09-18 09:20
| CDG airport
| DL 400 (AF 3577)
| from NY/JFK
|-
| Tim Walker
| Rodeo
| 2015-09-18 10:20
| LFPG (CDG airport)
| AF 1543
| from LSGG (GVA)
|-
| Thierry Foucu
| lotharkript
| 2015-09-18 10:45
| CDG airport
| UA 990
| from SFO
|-
| Federico Hlawaczek
|
| 2015-09-18 10:45
| CDG airport
| UA 990
| from SFO
|-
| Ilkka Ollakka
| ILEoo
| 2015-09-18 14:20
| CDG airport T2
| AY 875
| from HEL
|-
| Thomas Goyne
| plorkyeran
| 2015-09-18 17:40
| CDG airport
| AF 1851
| from CPH
|-
| Dave Rice
| dericed
| 2015-09-18 20:50
| CDG airport
| LX 646
| from ZRH
|-
| Rémi Denis-Courmont
| courmisch
| 2015-09-18 21:35
| CDG airport T2D
| AY 877
|
|-
| Bruno Siqueira
|
| 2015-09-18 21:55
| Orly
| TP 0448
| from LIS
|-
| Janne Grunau
| jannau
| 2015-09-18 22:35
| Gare de l'Est
| TGV 9570
| from Karlsruhe
|-
| Diego Elio Pettenò
| flameeyes
| 2015-09-16 17:35
| CDG airport T2E
| AF1817
| from DUB
|-
|}

= Departures =
Please order chronologically by time of departure.

{| border="1" class="sortable"
! Name
! IRC
! Time
! Port
! Vessel
! Notes
|-
| Mc Fly Marty
| mcfly
| 1985-10-26 01:22
| Hill Valley, California
| DeLorean OUTATIME
| to Hill Valley
|-
| Dave Rice
| dericed
| 2015-09-20 07:00
| CDG airport
| LX 647
| to ZRH (then NYC)
|-
| Tim Miller
| drasticactions
| 2015-09-20 16:45
| CDG airport
| AF 338
| to BOS
|-
| Janne Grunau
| jannau
| 2015-09-20 17:25
| Gare de l'Est
| TGV 9577
| to Karlsruhe
|-
| David Fuhrmann
| d-fu
| 2015-09-20 17:25
| Match found
| -- same train --
|
|-
| Francois Cartegnie
|
| 2015-09-20 17:49
| Gare de Lyon
| TGV 6949
|
|-
| Rémi Denis-Courmont
| courmisch
| 2015-09-20 19:00
| CDG airport T2D
| AY 874
|
|-
| Ilkka Ollakka
| ILEoo
| 2015-09-20 19:00
| CDG airport T2
| AY 874
| to HEL
|-
| Alex Converse
| peloverde
| 2015-09-20 19:13
| Gare Du Nord
|
| to London
|-
| Julian Scheel
| _julian
| 2015-09-20 21:05
| CDG airport
| AF1610
| to Hamburg/HAM
|-
| Bruno Siqueira
|
| 2015-09-21 06:30
| Orly
| TP0447
| to LIS
|-
| Derek Buitenhuis
| Daemon404
| 2015-09-21 09:00
| CDG airport
| 4U 8407
|
|-
| Ludmila Glinskih
| lglinskih
| 2015-09-21 09:55
| CDG airport
| AF 1464
| to LED
|-
| Federico Hlawaczek
|
| 2015-09-21 10:05
| CDG airport
| UA 991
| to SFO
|-
| Rostislav Pehlivanov
| atomnuker
| 2015-09-21 10:13
| Gare du Nord
| TGV TMST
| to London
|-
| Konstantin Pavlov
| thresh
| 2015-09-21 10:40
| CDG airport T2E
| AF 84
| to SFO
|-
| Thomas Goyne
| plorkyeran
| 2015-09-21 10:40
| CDG airport T2E
| AF 84
| to SFO
|-
| Arwa Arif
| arwa
| 2015-09-21 10:50
| CDG airport
| EY 32
| to HYD
|-
| Ben littler
|
| 2015-09-21 13:30
| CDG airport
| AF 378
| to DTW
|-
| Henrik Gramner
| Gramner
| 2015-09-21 14:00
| CDG airport
| SK2572
| to Stockholm/ARN
|-
| Ronald S. Bultje
| BBB
| 2015-09-21 14:00
| CDG airport
| AF 6
| to NY/JFK
|-
| Tim Walker
| Rodeo
| 2015-09-21 18:30
| LFPG (CDG airport)
| AF1042
| to LSGG (GVA)
|-
| Thomas B. Rücker
| tbr
| 2015-09-21 19:00
| CDG airport T2D
| AY 874
| to HEL(l)
|-
| Thierry Foucu
| lotharkript
| 2015-09-22 10:05
| CDG airport
| UA 991
| to SFO
|-
| Manfred Georg
|
| 2015-09-27 14:00
| CDG airport
| AF 6 (DL 1020)
| to SFO
|-
| Diego Elio Pettenò
| flameeyes
| 2015-09-21 10:15
| CDG airport T2E
| AF1716
| to DUB
|-
|}

= Locals =
People who do not need to travel:

VDD14

2014-07-31T08:47:18Z

Flameeyes: /* Power supply */

= VideoLAN Dev Days 2014 =

__NOTOC__

''The Multimedia Conference that frees the cone in you!'''

This is a technical un-conference, please bring laptops, cords, RJ45 cables and good mood with you.

== Note well ==
* If you expect [[VideoLAN]] to refund your travel, please bring a printed copy of your tickets including total cost. If you are not already in our reimbursement database, bring a printed IBAN too.

= Practical infos =

The meeting is held in [http://en.wikivoyage.org/wiki/Dublin Dublin], [http://en.wikivoyage.org/wiki/Ireland Ireland].

Feel free to use Flameeyes as local point of contact before, during and after the event.

Most venues will accept credit and debit cards as long as they are Chip & PIN; American swipe cards can be slightly more tricky but not exceedingly. American Express is barely accepted.

== Airport transfer ==

There are two main options to get from Dublin Airport to Dublin city centre: [http://www.dublinairport.com/gns/to-from-the-airport/by-bus-or-coach.aspx bus/coach] or cabs.

The AirLink costs around 6 euros per person, while a trip to the city centre by cab takes around 26 euros (a 10%-to-20% tip is usually welcome but not necessary). Most cabs fits three people comfortably (one in front, two in the back) or four squeezing, and cabs for five or more people are well available (even at the airport), so if you can sync up in groups you can get to the city centre pretty quickly (around 20 minutes).

If the driver asks you whether to take the tunnel, it's a 3 euro charge, but it might save you money if there's lots of traffic.

If you plan on visiting outside Dublin you may consider renting a car, but it might be easier to do so from the city centre rather than from the airport, as there's very little parking available (and you don't need a car in the centre).

== Hotel ==

T.B.D.

== Main venue ==

[https://www.google.ie/maps/place/Google+Docks/@53.339791,-6.236544,17z/data=!3m1!4b1!4m2!3m1!1s0x48670eeb13a9dd27:0x8c0b7757e533c712 Google Docks], in Barrow Street.

== Connectivity ==

=== Power supply ===

The electrical sockets are "British" '''IEC type G''' with three prongs a.k.a. [http://www.bs1363.org.uk/ BS 1363].

The electrical system is '''220V / 50Hz'''. If you come from the Americas, please make sure your devices are compatible beforehand.

Hotel bathrooms are often an exception, providing 110/220V split sockets, accepting US and Europlug connectors (not grounded). They are marked as "shavers only".

=== Internet ===

At the venue, '''GoogleGuest''' open WiFi is available at all time.

Most hotels and coffee shops will have available WiFi, but some might require registration.

Airport has a free WiFi network with captive portals.

SIM cards can be freely bought with nothing more than an ID and a card/money.

== Emergency situation ==

In case of emergency, call the European emergency number '''112'''. The UK number '''999''' also works.

= Schedule =

== Friday, September 19th 2014 ==

== Saturday, September 20th 2014 ==

=== Morning ===

=== Lunch ===

=== Afternoon ===

=== Evening ===

== Sunday, September 21st 2014 ==

=== Morning ===

=== Lunch ===

=== Afternoon ===

[[Category:About VideoLAN]]

VDD14

2014-07-30T14:36:12Z

Flameeyes: Add a bunch of random notes about the event that I know of.

= VideoLAN Dev Days 2014 =

__NOTOC__

''The Multimedia Conference that frees the cone in you!'''

This is a technical un-conference, please bring laptops, cords, RJ45 cables and good mood with you.

== Note well ==
* If you expect [[VideoLAN]] to refund your travel, please bring a printed copy of your tickets including total cost. If you are not already in our reimbursement database, bring a printed IBAN too.

= Practical infos =

The meeting is held in [http://en.wikivoyage.org/wiki/Dublin Dublin], [http://en.wikivoyage.org/wiki/Ireland Ireland].

Feel free to use Flameeyes as local point of contact before, during and after the event.

Most venues will accept credit and debit cards as long as they are Chip & PIN; American swipe cards can be slightly more tricky but not exceedingly. American Express is barely accepted.

== Airport transfer ==

There are two main options to get from Dublin Airport to Dublin city centre: [http://www.dublinairport.com/gns/to-from-the-airport/by-bus-or-coach.aspx bus/coach] or cabs.

The AirLink costs around 6 euros per person, while a trip to the city centre by cab takes around 26 euros (a 10%-to-20% tip is usually welcome but not necessary). Most cabs fits three people comfortably (one in front, two in the back) or four squeezing, and cabs for five or more people are well available (even at the airport), so if you can sync up in groups you can get to the city centre pretty quickly (around 20 minutes).

If the driver asks you whether to take the tunnel, it's a 3 euro charge, but it might save you money if there's lots of traffic.

If you plan on visiting outside Dublin you may consider renting a car, but it might be easier to do so from the city centre rather than from the airport, as there's very little parking available (and you don't need a car in the centre).

== Hotel ==

T.B.D.

== Main venue ==

[https://www.google.ie/maps/place/Google+Docks/@53.339791,-6.236544,17z/data=!3m1!4b1!4m2!3m1!1s0x48670eeb13a9dd27:0x8c0b7757e533c712 Google Docks], in Barrow Street.

== Connectivity ==

At the venue, GoogleGuest open WiFi is available at all time.

Most hotels and coffee shops will have available WiFi, but some might require registration.

Airport has a free WiFi network with captive portals.

SIM cards can be freely bought with nothing more than an ID and a card/money.

== Emergency situation ==

In case of emergency, call the European emergency number '''112'''. The UK number '''999''' also works.

= Schedule =

== Friday, September 19th 2014 ==

== Saturday, September 20th 2014 ==

=== Morning ===

=== Lunch ===

=== Afternoon ===

=== Evening ===

== Sunday, September 21st 2014 ==

=== Morning ===

=== Lunch ===

=== Afternoon ===

[[Category:About VideoLAN]]

Git

2014-05-08T12:46:52Z

Flameeyes: /* Mail Setup */ Note that the certificate needs to be in PEM format.

[http://git-scm.com/ Git] is a free and open source [[wikipedia:Revision_control|version control system]]. It is used by programmers to keep track of the different versions of the files composing a software.

= Basic Git usage =

If you are using '''Windows''', please read the [[Git_Windows]] page.

== Getting VLC or x264 source code via Git ==

$ git clone git://git.videolan.org/vlc.git
Voilà! The full VLC history should be on your hard disk in vlc/.

$ git clone git://git.videolan.org/x264.git
Voilà! The full x264 history should be on your hard disk in x264/.

If you want only the last 3 VLC revisions:
$ git clone git://git.videolan.org/vlc.git --depth 3

Clones without the full revision set (--depth) can't be used for backporting (or to make sure that you're including at least commits up to the common fork point).

You can also have the VLC stable branch, here:
$ git clone git://git.videolan.org/vlc/vlc-2.0.git
Voilà! You got the stable branch repository.

Or via http protocol from the main site:
$ git clone http://git.videolan.org/git/vlc.git
See http://git.videolan.org/?p=vlc.git;a=summary

Or via http protocol from github (github can sometimes be a bit behind as a mirror):
https://github.com/videolan/vlc.git
See https://github.com/videolan/vlc

You can also clone using http via our repo.or.cz mirror.
$ git clone http://repo.or.cz/r/vlc.git
See http://repo.or.cz/w/vlc.git (a mirror).

=== After cloning ===

$ git log
to see the full log of the trunk.
$ gitk
to see the log graphically.

You can also browse the sources via [http://git.videolan.org/ gitweb].

== Configure your global git config ==
May need to use
$ git repo-config {various options}
1.4.4.2 Requires the repo-config command rather than just config

=== Personal Information ===
Tell git your name. (use mostly by git-commit)
$ git config --global user.name "Your Name"
$ git config --global user.email "me@example.com"

=== Mail Setup ===
To send patches you'll need a working git-send-email configuration.

'''MSMTP'''

You can use [http://msmtp.sourceforge.net/ msmtp] to achieve this. Install it with tls and ssl activated and place the following config file (.msmtprc) in your home directory
# msmtp configuration file

# Set default values for all following accounts.
defaults
tls on
tls_starttls on
tls_trust_file /certificates/EquifaxSecureCertificateAuthority.crt
logfile /log/.msmtp.log

# GMAIL
account gmail
host smtp.gmail.com
port 587
protocol smtp
from user.name@gmail.com
auth on
user user.name@gmail.com

# Set a default account
account default : gmail
Then configure git to use msmtp. The password will be asked for upon sending mail.
$ git config --global sendemail.smtpserver /usr/local/bin/msmtp
The certificate for gmail can be found here: [http://www.geotrust.com/resources/extended-validation-ssl/certs/Equifax%20Secure%20Certificate%20Authority.crt EquifaxSecureCertificateAuthority.crt]

If you receive a '''cannot set X509 trust file''' error when using another CA certificate, make sure it is in the PEM (text format) rather than DER format (binary).

'''Mac OS X'''

Setup info with e.g. gmail account
$ git config --global sendemail.smtpserver smtp.gmail.com
$ git config --global sendemail.smtpuser your-gmail-address-here
$ git config --global sendemail.smtpencryption tls
$ git config --global sendemail.smtpserverport 587

If errors occur telling you something like perl's SMTP::SSL package is not there. Do the following
$ sudo -H cpan Net::SMTP::SSL

=== Using git with color (Tip) ===
If you want to use git with colored output use:
$ git config --global color.ui true

If you are using an old git version (prior to 1.5.5) and previous command didn't work, use:
$ git config --global color.diff auto
$ git config --global color.status auto
$ git config --global color.branch auto

=== Setting up "git up" (Tip) ===
If you want to be able to just keep in sync using "git up" use:
$ git config --global alias.up "pull --rebase"
And if you like your tree to be messy and don't want git to complain (like in svn) use:
$ git config --global alias.up '!sh -c "git commit -a -m "Before rebase" && git pull --rebase && git reset head^"'

=== Setting up "git wu" (Git What's Up) (Tip) ===
If you want to see what you are about to "git push":
$ git config --global alias.wu "log --stat origin..@{0}"
Now use:
$ git wu
Note that this only works for the master branch.

=== Setting up "git wup" (Git What's Up - with patch) (Tip) ===
If you want to see what you are about to "git push", along with the diff:
$ git config --global alias.wup "log -p origin..@{0}"
Now use:
$ git wup

== Set up Hooks (Tip) ==
If you are using Qt-creator and want to keep your files listing in sync,
just set up a post-checkout hook accordingly.
#!/bin/sh
# this file as .git/hooks/post-checkout
if test -f vlc.files
then
echo "Updating Qt files list"
git ls-files > vlc.files
fi

== General GIT Workflow ==
1. Make your file edits in your local repository.

2. "git commit" the changes in your local repository

3. "git pull --rebase" or "git up" (if you did ''git config --global alias.up "pull --rebase"'') to bring the rest of your local repository up to date

4. "git log origin..master" to check what you are going to commit

4. "git push" to move your changes up to the master

"git stash" if you want to "hide" your changes. Do this if you think there may be other commits against the same things you are working on and want to refresh your local checkout (using a git pull --rebase) from the master. Use "git stash apply" to get your stash back.

"git checkout -f master" if you think your tree is pretty hopeless, need a kill-and-fill to bring the master into your local repository.

== List the local branch ==
You can now list your local branch by doing
$ git branch
which should ouput
$ git branch
* master

== List your local non committed changes ==
$ git status | less

== Commit ==
Now you can start to work on your tree. As soon as you feel you have reached a step in developement where you can commit your work '''locally''', use
$ git commit -a
or
$ git commit <specific files>

If you wish to give credit to someone else's work (e.g. you are applying a third party patch):
$ git commit <specific files> --author "Name Surname <user@domain.com>"

== List your commits ==
$ git log

== Keeping your local working branch in sync ==
$ git pull --rebase

To shorten up that command type
$ git config --global alias.up "pull --rebase"

Now you can just type:
$ git up

== Use a graphical interface ==
$ gitk # Tree Browser
$ qgit # Tree Browser
$ git-gui # Commit/push/... editor

== Submitting patches ==

First make sure you have '''read''' our [[Sending Patches]] page. And that you've '''read''' the [[Sending Patches#Check_List| Check List]].

If you have been developing on vlc locally and (still) don't have write access, you can submit all your commits in one shot using:
$ rm -Rf patches
$ git format-patch -o patches origin
$ git send-email --to vlc-devel@videolan.org patches
If you want to create a cover letter for multiple patches use:
$ git format-patch -o patches origin -n --cover-letter
$ git send-email --annotate --cover-letter --to vlc-devel@videolan.org patches
If you have multiple patch consider using:
$ git send-email --compose --no-chain-reply-to --to vlc-devel@videolan.org patches
This will produce the patches for each local commit in the directory "patches" and send them.
Use --no-chain-reply-to make sure it doesn't reply.

For x264, do the same with x264-devel@videolan.org


Don't do:
* [PATCH 0/m]
** [PATCH 1/m]
*** [PATCH 2/m]
**** ...
But do:
* [PATCH 0/m]
** [PATCH 1/m]
** [PATCH 2/m]
** ..

= Advanced usage =
== Creating a secondary local branch ==
If you want to work on a specific project that could require a branch of the trunk, create a local branch of the current branch by doing:
$ git branch mywork
and to actually use it do:
$ git checkout mywork
Which could be summarized by:
$ git checkout -b mywork

Then do some commit on it... And you can go back to your original master branch by doing:
$ git checkout master

== Fetching a remote branch ==
To see the remote branch use:
$ git branch -r
If the remote branch is named 0.8.6-bugfix
$ git branch 0.8.6-bugfix origin/0.8.6-bugfix
Branch 0.8.6-bugfix set up to track remote branch refs/remotes/origin/0.8.6-bugfix.
$ git branch
0.8.6-bugfix
* master
To checkout that branch use:
$ git checkout 0.8.6-bugfix
To stay up-to-date a simple
$ git pull --rebase
Should be enough.

If warnings appear that files still need updating:
$ include/libvlc_internal.h: needs update
include/mediacontrol_internal.h: needs update
include/vlc/libvlc.h: needs update
include/vlc_update.h: needs update
modules/access/mms/mms.c: needs update
...

Then do a checkout -f to revert non committed local changes
$ git checkout -f

To stay up-to-date another
$ git pull --rebase
Should give no more warnings.

To push to the remote branch, use:
$git push origin 0.8.6-bugfix:0.8.6-bugfix

== Creating a remote branch ==
If the new remote branch is named 0.9.0-bugfix, and is based on the local master branch.
First make sure everything go as planned with the --dry-run option:
$ git push --dry-run origin master:refs/heads/0.9.0-stable
To git@git.videolan.org:vlc.git
* [new branch] master -> 0.9.0-stable

Then push it:
$ git push origin master:refs/heads/0.9.0-stable
To git@git.videolan.org:vlc.git
* [new branch] master -> 0.9.0-stable
$ git branch -r
origin/0.9.0-stable
origin/master

To checkout that branch now see ''Fetching a remote branch''

== Backporting commits ==
It is possible to "backport" commit between the master branch and a -bugfix branch. However since VDD'09, the bugfix branches have been splitted to their own git repositories. This leaves us with 2 cases.

=== Normal simple case ===

Go to your -bugfix branch:
$ git checkout 1.0-bugfix

Backport the commit:
$ git cherry-pick -x -s <sha-id of commit>

If git fails to do the backport by itself, you'll be presnted with the usual options in case of a failed merge or patching. Use "git status", your favorite editor or "git mergetool" to resolve the situation. Then use "git add" and "git commit -c <sha-id of backported commit>".
Then push your commit as usual.

=== Case of VLC bugfix branches ===
Due to the number of commits in vlc.git and the amount of divergence between the master and 1.0-bugfix branches, they have been separated into two different git repositories. But that doesn't block you from backporting.

Get the -bugfix git:
$ git clone git://git.videolan.org/vlc/vlc-1.0.git vlc-bugfix
Add vlc.git as an additional remote:
$ git remote add vlc-master git://git.videolan.org/vlc.git
Update the information from vlc-master
$ git fetch vlc-master
Backport as normal
$ git cherry-pick -x -s <sha-id of commit>

== Publishing your own fork ==
Go to [http://repo.or.cz/w/vlc.git http://repo.or.cz/w/vlc.git] and click [http://repo.or.cz/regproj.cgi?fork=vlc.git fork]. You will be able to publish your work there.

Please don't forget to send a mail to the ''vlc-devel'' mailing list as soon as you create your fork.

== Revert your non-committed local changes ==
$ git checkout -f

==Edit or undo not yet pushed commits ==
This will undo the last commit
$ git reset HEAD^
which is the same as
$ git reset master^
(if your checked-out copy of your tree is master)
And also the same as
$ git reset a44a594 # note that there is no need to use the full sha id

If you have a stack of patch that you have not yet committed you can delete one patch from the list using git rebase --interactive
$ git rebase --interactive origin
pick eacf185 test
pick 56322eb VLMA owner is vlma prod.

# Rebase 826757e..56322eb onto 826757e
#
# Commands:
# pick = use commit
# edit = use commit, but stop for amending
# squash = use commit, but meld into previous commit

== Diff-ing ==
* You can diff between two branches using
$ git diff branch1 branch2
* You can diff between the previous 10th commit and current using
$ git diff HEAD~10 HEAD
* You can diff between the previous 10th commit and current of the branch "mywork" using
$ git diff mywork~10 mywork
* Imagine that git log is like
$ git log
commit e0394f269305edd09843257e7c1d1a66aaf48ab3
Author: jb <jb>
Date: Fri Apr 13 07:14:48 2007 +0000
qt4 - Mousewheel (2)
commit e80b339081aa6755f67c9bd8e2aacf93a9a79d95
[..]
commit ff7004b70fd239e4120deb160e2991bd5237b8df
[..]
commit a44a594898f981a145cfcace5f16f8973f9eb46f
[..]
commit 690df705c963cf6bf6f5746d54bc97a85ff91919
[..]
commit 679f8b1c3e0baa469efa970588b95a625c595d64
[..]

$ git diff a44a594898f981a145cfcace5f16f8973f9eb46f~2 e80b339081aa6755f67c9bd8e2aacf93a9a79d95
Will be equivalent to:
$ git diff ff7004b70fd239e4120deb160e2991bd5237b8df e80b339081aa6755f67c9bd8e2aacf93a9a79d95
And to:
$ git diff HEAD~4 HEAD^

* Remember that to produce a patch you should rather use git format-patch than git diff most of the time.

== Patch-ing ==
* You can apply patches using
$ git apply <patch>

== Tracking regression ==
git has a great tool called [http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html git-bisect] to help you to track a faulty commit. Imagine you are tracking a bug that is known to appear after 0.8.6 (assuming 0.8.6 is tagged):
$ git bisect start
$ git bisect bad # tell git current version has the bug you are tracking
$ git bisect good 0.8.6 # tell git 0.8.6 didn't have the bug
And then git will checkout a certain revision, and ask you to test it. And you simply say whether this version has the bug.
If it has the bug:
$ git bisect bad
if the bug is not present:
$ git bisect good
And so on by bisection... At the end git will indicate the faulty commit. Most of the time this tool is really efficient to track regression.

If you can provide a script that test the presence of the bug
$ git bisect run <script_name>
will be able to track down the regression by itself. See [http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html git-bisect Documentation].

= Using Git to push to VideoLAN git =
== Initial requirements ==
* You must have credentials to push commits into the repository. For other contributors, please read upper [[Git#Submitting_patches_to_the_vlc-devel_or_x264-devel|Submitting patches to the vlc-devel or x264-devel]] paragraph.
* Make sure you've set your name and email in your commits
$ git config --global user.name "Your Name"
$ git config --global user.email "me@example.com"

== Convert your tree to use your ssh push commit access ==
$ vi vlc/.git/config
And replace
git://git.videolan.org/vlc.git
With
git@git.videolan.org:vlc.git

== Staying up to date ==
$ git pull --rebase

If you don't want to have to type --rebase everytime you pull do:
$ git config branch.master.rebase true

This one creates a merge object which is not how SVN worked, so let's use the first version...
$ git pull

== Pushing your work ==
$ git log origin..master # Check what you are going to push
$ git push



= Documentation about git =
* [http://git-scm.com/ Official Git Website]
* [http://www.kernel.org/pub/software/scm/git/docs/tutorial.html Git Tutorial]
* [http://git.or.cz/course/svn.html Switching from SVN to git using cogito]
* [http://wiki.sourcemage.org/Git_Guide Very good Git guide]

[[Category:Coding]]

MacOSCompile

2009-09-28T22:39:33Z

Flameeyes: /* Snow Leopard */ <code> tags

== Compile VLC on Mac OS X ==

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

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

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

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

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

$ cd ../..
$ ./bootstrap
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ ./configure --enable-debug

$ make
Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

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

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

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

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

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

=== Build external libs ===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

MacOSCompile

2009-09-28T22:38:54Z

Flameeyes: /* Snow Leopard */ More Snow Leopard build quirks

== Compile VLC on Mac OS X ==

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

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

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

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

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

$ cd ../..
$ ./bootstrap
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ ./configure --enable-debug

$ make
Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

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

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

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

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

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

=== Build external libs ===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

MacOSCompile

2009-09-28T22:30:56Z

Flameeyes: Also set CXXFLAGS to the correct -arch when running ./configure

== Compile VLC on Mac OS X ==

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

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

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

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

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

$ cd ../..
$ ./bootstrap
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ ./configure --enable-debug

$ make
Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

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

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

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

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

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

=== Build external libs ===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=== Snow Leopard and 32-bit builds ===
With Mac OS X 10.6 (Snow Leopard/darwin10) the compiler tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" CXXFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

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

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

MacOSCompile

2009-09-28T21:14:53Z

Flameeyes: Add some notes about 32-bit builds and Snow Leopard

== Compile VLC on Mac OS X ==

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

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

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

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

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

$ cd ../..
$ ./bootstrap
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ ./configure --enable-debug

$ make
Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

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

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

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

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

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

=== Build external libs ===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=== Snow Leopard and 32-bit builds ===
With Mac OS X 10.6 (Snow Leopard/darwin10) the compiler tries to build for the x86_64 arch by default, if you want to make a 32-bit build of VLC, you have to change the configure, similarly to what shown above: <code>./configure CFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386"</code>

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

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

MacOSCompile

2009-09-28T21:07:06Z

Flameeyes: /* Quick Steps */ complete the 'cd' argument after clone

== Compile VLC on Mac OS X ==

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

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

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

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

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

$ cd ../..
$ ./bootstrap
$ export CC=/Developer/usr/bin/llvm-gcc-4.2
$ export CXX=/Developer/usr/bin/llvm-g++-4.2
$ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
$ ./configure --enable-debug

$ make
Read next section for more details.

== Steps ==

Please follow these steps for compiling:

=== Set the development environment ===

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

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

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

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

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

=== Build external libs ===

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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