VideoLAN Wiki - User contributions [en]

User:Jpeg

2010-11-07T14:50:59Z

Jpeg:

My name is Jean-Philippe Andre.
 
You can contact me by mail at: jpeg _at_ videolan _dot_ org

GCodeIn Ideas

2010-11-07T14:49:26Z

Jpeg: /* VLC Songkick extension */ jpeg page

= Google Code In =

This page is about gathering '''ideas''' for the VideoLAN project for acceptance in the [http://code.google.com/opensource/gci/2010-11/index.html Google Code In 2010-2011] program.

VideoLAN has been part of [http://code.google.com/soc/ Google Summer of Code] in [[SoC_2007|2007]], [[SoC_2008|2008]], [[SoC_2009|2009]] and [[SoC_2010|2010]].

= Ideas for VideoLAN =

== Warning ==
This is a temporary page for listing ideas for Google Code-in tasks.

The final tasks will be moved to melange, when needed.

== VideoLAN Communication ==

=== Wiki Orphans and Double tracking ===
'''Category''': Documentation 
'''Description''': The wiki has way too many [[Special:LonelyPages|orphaned pages]] and [[Special:DoubleRedirects| double redirected pages]], they should be linked by other pages or marked for deletion, and redirects should be fixed 
'''Outcome''': A better wiki with less orphaned pages or redirects 
'''Difficulty''': easy 
'''Tools''': a wiki account 
'''Time''': 4hours 
'''Mentor''': [[User:Xtophe|xtophe]] 

=== Wiki short pages tracking ===
'''Category''': Documentation 
'''Description''': The wiki has too many [[Special:ShortPages|short pages]], they should be improved, marked for deletion or merged with other pages 
'''Outcome''': A better wiki with less short pages 
'''Difficulty''': easy 
'''Tools''': a wiki account 
'''Time''': 4hours 
'''Mentor''': [[User:Xtophe|xtophe]] 

=== VideoLAN flyer/poster ===
'''Category''': Outreach 
'''Description''': The VideoLAN project needs a flyer for promotional matters 
'''Outcome''': A cool A5-sized flyer presenting VideoLAN 
'''Difficulty''': medium 
'''Tools''': Image-Editing software 
'''Time''': 3days 
'''Mentor''': [[User:Jpsaman|Jean-Paul Saman]] 

=== VideoLAN Forum improvements ===
'''Category''': Research and Outreach 
'''Description''': The VideoLAN [http://forum.videolan.org forums] have many shortcomings, especially regarding spam and "Solved topics" 
We need research on solutions and advise us how we can improve the forums 
'''Outcome''': small report on ideas, advice and solution 
'''Difficulty''': medium 
'''Tools''': Browser and Text editor 
'''Time''': 3days 
'''Mentor''': VLC_help 

=== VideoLAN PHP webpage for file uploading for bugreports ===
'''Category''': Code 
'''Description''': The VideoLAN project needs a small WebPage in PHP to be able to upload the files for the bugreports 
As some of those files are big, some progression bar should be done in Javascript too 
'''Outcome''': a working deployed PHP script 
'''Difficulty''': hard 
'''Tools''': PHP development environment 
'''Time''': 5days 
'''Mentor''': etix 

== VLC ==
=== Create VLC videos for training ===
'''Category''': Training 
'''Description''': Creation of youtube Videos of screencasts of VLC usage 
This task can be divided in chunks of 5 videos 
'''Outcome''': VLC Youtube channels 
'''Difficulty''': easy 
'''Tools''': VLC, screencast recorders 
'''Time''': 2 days 
'''Mentor''': [[User:linkfanel|linkfanel]] 

=== VLC documentation illustration ===
'''Category''': Documentation 
'''Description''': Creation of VLC screenshots and small diagrams to improve the VLC documentation on the wiki 
'''Outcome''': VLC illustrations on the documentation 
'''Difficulty''': easy 
'''Tools''': VLC, Image Editing software 
'''Time''': 5 days 
'''Mentor''': [[User:ivoire|Rémi Duraffort]] 

=== VLC users survey creation ===
'''Category''': Outreach 
'''Description''': Creation of a survey for VLC users, about their usage of VLC, that we will put on the website 
'''Outcome''': Survey ready to be sent to the VLC users 
'''Difficulty''': medium 
'''Tools''': text editor and web browser 
'''Time''': 5 days 
'''Mentor''': [[User:J-b|jb]] 

=== VLC fullscreen controller redesign ===
'''Category''': User Interface 
'''Description''': Find ideas to improve and redesign the fullscreen controller of the VLC version on Windows/Linux 
'''Outcome''': Sketchs and ideas for the fullscreen controller 
'''Difficulty''': medium 
'''Tools''': web browser and image editor 
'''Time''': 5 days 
'''Mentor''': [[User:J-b|jb]] 

=== VLC volume controller redesign ===
'''Category''': User Interface 
'''Description''': Find ideas to improve and redesign the volume controller of the VLC version on Windows/Linux 
'''Outcome''': Sketchs and ideas for the volume controller 
'''Difficulty''': hard 
'''Tools''': web browser and image editor 
'''Time''': 3 weeks 
'''Mentor''': [[User:J-b|jb]] 

=== VLC Lyrics extension ===
'''Category''': Code 
'''Description''': Creation of one extension in lua that can be able to fetch and display Lyrics from one website API 
'''Outcome''': Working Lua Lyrics extension script 
'''Difficulty''': hard 
'''Tools''': text editor and VLC 
'''Time''': 10 days 
'''Mentor''': [[User:Jpeg|jpeg]] 

=== VLC Songkick extension ===
'''Category''': Code 
'''Description''': Creating one extension in lua that can be able to fetch and display Lyrics from Songkick API 
'''Outcome''': Working Lua Songkick extension script 
'''Difficulty''': hard 
'''Tools''': text editor and VLC 
'''Time''': 10 days 
'''Mentor''': [[User:Jpeg|jpeg]] 

=== VLC webplugin testpages ===
'''Category''': Code 
'''Description''': This task is about updating the Html/CSS/JS scripting test pages for the [[Documentation:WebPlugin|Webplugins]]. 
'''Outcome''': Usable pages for testing the VLC webplugins 
'''Difficulty''': hard 
'''Tools''': text editor and a browser 
'''Time''': 10 days 
'''Mentor''': [[User:Jpsaman|Jean-Paul Saman]] 

=== VLC warnings cleanup ===
'''Category''': Code 
'''Description''': This has for objective to delete a lot of warnings in C and C++ code when doing VLC compilation for Linux and Windows. 
'''Outcome''': Less warnings in C and C++ code 
'''Difficulty''': hard 
'''Tools''': text editor and compilation toolchain 
'''Time''': 10 days 
'''Mentor''': [[User:ivoire|Rémi Duraffort]] 

=== libVLC Qt example media player ===
'''Category''': Code 
'''Description''': Creating a small example of how to create a media player based on libVLC and Qt on Windows/Linux. 
'''Outcome''': a cool media player to demonstrate the libVLC API in Qt 
'''Difficulty''': hard 
'''Tools''': complete compilation toolchain 
'''Time''': 15 days 
'''Mentor''': pdherbemont 

=== libVLC Gtk example media player ===
'''Category''': Code 
'''Description''': Creating a small example of how to create a media player based on libVLC and Gtk on Windows/Linux. 
'''Outcome''': a cool media player to demonstrate the libVLC API in Gtk 
'''Difficulty''': hard 
'''Tools''': complete compilation toolchain 
'''Time''': 15 days 
'''Mentor''': pdherbemont 

=== libVLC wxWidgets example media player ===
'''Category''': Code 
'''Description''': Creating a small example of how to create a media player based on libVLC and wxWidgets on Windows/Linux. 
'''Outcome''': a cool media player to demonstrate the libVLC API in wxWidgets 
'''Difficulty''': hard 
'''Tools''': complete compilation toolchain 
'''Time''': 15 days 
'''Mentor''': pdherbemont 

== VLMC ==

=== Create VLMC videos for training ===
'''Category''': Training 
'''Description''': Creation of youtube Videos of screencasts of VLMC usage 
This task can be divided in chunks of 3 videos 
'''Outcome''': VLMC Youtube channels 
'''Difficulty''': easy 
'''Tools''': VLMC, screencasting tools 
'''Time''': 3 days 
'''Mentor''': [[User:etix|etix]] 

=== VLMC UI testing ===
'''Category''': Quality Assurance 
'''Description''': Testing VLMC Interface and testing all dialogs and options to find bugs 
'''Outcome''': Bugreports 
'''Difficulty''': easy 
'''Tools''': VLMC 
'''Time''': 3 days 
'''Mentor''': Hugo 

=== VLMC files testing ===
'''Category''': Quality Assurance 
'''Description''': Testing VLMC for Windows or Linux with many file formats 
'''Outcome''': Bug reports on the forum that don't work 
'''Difficulty''': medium 
'''Tools''': VLMC, mediainfo, Windows/Linux 
'''Time''': 7 days 
'''Mentor''': Hugo 

== Contact ==
For ANY question, contact [[User:J-b|jb]] or [[User:xtophe|xtophe]]

IRC channel: #videolan or irc://irc.freenode.net

GCodeIn Ideas

2010-11-07T14:49:04Z

Jpeg: /* VLC Lyrics extension */

= Google Code In =

This page is about gathering '''ideas''' for the VideoLAN project for acceptance in the [http://code.google.com/opensource/gci/2010-11/index.html Google Code In 2010-2011] program.

VideoLAN has been part of [http://code.google.com/soc/ Google Summer of Code] in [[SoC_2007|2007]], [[SoC_2008|2008]], [[SoC_2009|2009]] and [[SoC_2010|2010]].

= Ideas for VideoLAN =

== Warning ==
This is a temporary page for listing ideas for Google Code-in tasks.

The final tasks will be moved to melange, when needed.

== VideoLAN Communication ==

=== Wiki Orphans and Double tracking ===
'''Category''': Documentation 
'''Description''': The wiki has way too many [[Special:LonelyPages|orphaned pages]] and [[Special:DoubleRedirects| double redirected pages]], they should be linked by other pages or marked for deletion, and redirects should be fixed 
'''Outcome''': A better wiki with less orphaned pages or redirects 
'''Difficulty''': easy 
'''Tools''': a wiki account 
'''Time''': 4hours 
'''Mentor''': [[User:Xtophe|xtophe]] 

=== Wiki short pages tracking ===
'''Category''': Documentation 
'''Description''': The wiki has too many [[Special:ShortPages|short pages]], they should be improved, marked for deletion or merged with other pages 
'''Outcome''': A better wiki with less short pages 
'''Difficulty''': easy 
'''Tools''': a wiki account 
'''Time''': 4hours 
'''Mentor''': [[User:Xtophe|xtophe]] 

=== VideoLAN flyer/poster ===
'''Category''': Outreach 
'''Description''': The VideoLAN project needs a flyer for promotional matters 
'''Outcome''': A cool A5-sized flyer presenting VideoLAN 
'''Difficulty''': medium 
'''Tools''': Image-Editing software 
'''Time''': 3days 
'''Mentor''': [[User:Jpsaman|Jean-Paul Saman]] 

=== VideoLAN Forum improvements ===
'''Category''': Research and Outreach 
'''Description''': The VideoLAN [http://forum.videolan.org forums] have many shortcomings, especially regarding spam and "Solved topics" 
We need research on solutions and advise us how we can improve the forums 
'''Outcome''': small report on ideas, advice and solution 
'''Difficulty''': medium 
'''Tools''': Browser and Text editor 
'''Time''': 3days 
'''Mentor''': VLC_help 

=== VideoLAN PHP webpage for file uploading for bugreports ===
'''Category''': Code 
'''Description''': The VideoLAN project needs a small WebPage in PHP to be able to upload the files for the bugreports 
As some of those files are big, some progression bar should be done in Javascript too 
'''Outcome''': a working deployed PHP script 
'''Difficulty''': hard 
'''Tools''': PHP development environment 
'''Time''': 5days 
'''Mentor''': etix 

== VLC ==
=== Create VLC videos for training ===
'''Category''': Training 
'''Description''': Creation of youtube Videos of screencasts of VLC usage 
This task can be divided in chunks of 5 videos 
'''Outcome''': VLC Youtube channels 
'''Difficulty''': easy 
'''Tools''': VLC, screencast recorders 
'''Time''': 2 days 
'''Mentor''': [[User:linkfanel|linkfanel]] 

=== VLC documentation illustration ===
'''Category''': Documentation 
'''Description''': Creation of VLC screenshots and small diagrams to improve the VLC documentation on the wiki 
'''Outcome''': VLC illustrations on the documentation 
'''Difficulty''': easy 
'''Tools''': VLC, Image Editing software 
'''Time''': 5 days 
'''Mentor''': [[User:ivoire|Rémi Duraffort]] 

=== VLC users survey creation ===
'''Category''': Outreach 
'''Description''': Creation of a survey for VLC users, about their usage of VLC, that we will put on the website 
'''Outcome''': Survey ready to be sent to the VLC users 
'''Difficulty''': medium 
'''Tools''': text editor and web browser 
'''Time''': 5 days 
'''Mentor''': [[User:J-b|jb]] 

=== VLC fullscreen controller redesign ===
'''Category''': User Interface 
'''Description''': Find ideas to improve and redesign the fullscreen controller of the VLC version on Windows/Linux 
'''Outcome''': Sketchs and ideas for the fullscreen controller 
'''Difficulty''': medium 
'''Tools''': web browser and image editor 
'''Time''': 5 days 
'''Mentor''': [[User:J-b|jb]] 

=== VLC volume controller redesign ===
'''Category''': User Interface 
'''Description''': Find ideas to improve and redesign the volume controller of the VLC version on Windows/Linux 
'''Outcome''': Sketchs and ideas for the volume controller 
'''Difficulty''': hard 
'''Tools''': web browser and image editor 
'''Time''': 3 weeks 
'''Mentor''': [[User:J-b|jb]] 

=== VLC Lyrics extension ===
'''Category''': Code 
'''Description''': Creation of one extension in lua that can be able to fetch and display Lyrics from one website API 
'''Outcome''': Working Lua Lyrics extension script 
'''Difficulty''': hard 
'''Tools''': text editor and VLC 
'''Time''': 10 days 
'''Mentor''': [[User:Jpeg|jpeg]] 

=== VLC Songkick extension ===
'''Category''': Code 
'''Description''': Creating one extension in lua that can be able to fetch and display Lyrics from Songkick API 
'''Outcome''': Working Lua Songkick extension script 
'''Difficulty''': hard 
'''Tools''': text editor and VLC 
'''Time''': 10 days 
'''Mentor''': jpeg 

=== VLC webplugin testpages ===
'''Category''': Code 
'''Description''': This task is about updating the Html/CSS/JS scripting test pages for the [[Documentation:WebPlugin|Webplugins]]. 
'''Outcome''': Usable pages for testing the VLC webplugins 
'''Difficulty''': hard 
'''Tools''': text editor and a browser 
'''Time''': 10 days 
'''Mentor''': [[User:Jpsaman|Jean-Paul Saman]] 

=== VLC warnings cleanup ===
'''Category''': Code 
'''Description''': This has for objective to delete a lot of warnings in C and C++ code when doing VLC compilation for Linux and Windows. 
'''Outcome''': Less warnings in C and C++ code 
'''Difficulty''': hard 
'''Tools''': text editor and compilation toolchain 
'''Time''': 10 days 
'''Mentor''': [[User:ivoire|Rémi Duraffort]] 

=== libVLC Qt example media player ===
'''Category''': Code 
'''Description''': Creating a small example of how to create a media player based on libVLC and Qt on Windows/Linux. 
'''Outcome''': a cool media player to demonstrate the libVLC API in Qt 
'''Difficulty''': hard 
'''Tools''': complete compilation toolchain 
'''Time''': 15 days 
'''Mentor''': pdherbemont 

=== libVLC Gtk example media player ===
'''Category''': Code 
'''Description''': Creating a small example of how to create a media player based on libVLC and Gtk on Windows/Linux. 
'''Outcome''': a cool media player to demonstrate the libVLC API in Gtk 
'''Difficulty''': hard 
'''Tools''': complete compilation toolchain 
'''Time''': 15 days 
'''Mentor''': pdherbemont 

=== libVLC wxWidgets example media player ===
'''Category''': Code 
'''Description''': Creating a small example of how to create a media player based on libVLC and wxWidgets on Windows/Linux. 
'''Outcome''': a cool media player to demonstrate the libVLC API in wxWidgets 
'''Difficulty''': hard 
'''Tools''': complete compilation toolchain 
'''Time''': 15 days 
'''Mentor''': pdherbemont 

== VLMC ==

=== Create VLMC videos for training ===
'''Category''': Training 
'''Description''': Creation of youtube Videos of screencasts of VLMC usage 
This task can be divided in chunks of 3 videos 
'''Outcome''': VLMC Youtube channels 
'''Difficulty''': easy 
'''Tools''': VLMC, screencasting tools 
'''Time''': 3 days 
'''Mentor''': [[User:etix|etix]] 

=== VLMC UI testing ===
'''Category''': Quality Assurance 
'''Description''': Testing VLMC Interface and testing all dialogs and options to find bugs 
'''Outcome''': Bugreports 
'''Difficulty''': easy 
'''Tools''': VLMC 
'''Time''': 3 days 
'''Mentor''': Hugo 

=== VLMC files testing ===
'''Category''': Quality Assurance 
'''Description''': Testing VLMC for Windows or Linux with many file formats 
'''Outcome''': Bug reports on the forum that don't work 
'''Difficulty''': medium 
'''Tools''': VLMC, mediainfo, Windows/Linux 
'''Time''': 7 days 
'''Mentor''': Hugo 

== Contact ==
For ANY question, contact [[User:J-b|jb]] or [[User:xtophe|xtophe]]

IRC channel: #videolan or irc://irc.freenode.net

User:Jpeg

2010-11-07T14:46:32Z

Jpeg: Created page with 'My name is Jean-Philippe Andre. You can contact me by mail at: jpeg _at_ videolandotorg'

My name is Jean-Philippe Andre.
You can contact me by mail at: jpeg _at_ videolandotorg

LibVLC Tutorial 086c

2010-07-29T04:31:39Z

Jpeg: /* Compile/link */ cosmetics

=== Tutorial for libVLC for version 0.8.6c ===

Tested on cygwin with gcc 3.4, windows xp; instructions also for linux with small code change.
You will want to change the plugin path to where you actually have vlc installed. And you will want to change the video filename to one which actually exists on your system. This will initialize vlc and play the video for ten seconds. After you get this to work, then you will want to look up the external API documentation to see how to use the other interfaces. Note there are two interfaces documented in the
external API page; the first one is the "old" legacy one using calls such as VLC_Init. The second one
is the "current" one using calls such as libvlc_new, which is used in the following code.

=== Code ===

#include <stdio.h>
#include <windows.h>
#include <vlc/libvlc.h>

static void quit_on_exception (libvlc_exception_t *excp) {
if (libvlc_exception_raised (excp)) {
fprintf(stderr, "error: %s\n", libvlc_exception_get_message(excp));
exit(-1);
}
}

int main(int argc, char **argv) {
libvlc_exception_t excp;
libvlc_instance_t *inst;
int item;
char *myarg0 = "-I"; char *myarg1 = "dummy";
char *myarg2 = "--plugin-path=c:\\program files\\videolan\\plugins";
char *myargs[4] = {myarg0, myarg1, myarg2, NULL};
char *filename = "c:\\video\\main\\Everybody_Hates_Chris_Feb_26.mpg";

libvlc_exception_init (&excp);
inst = libvlc_new (3, myargs, &excp);
quit_on_exception (&excp);
item = libvlc_playlist_add (inst, filename, NULL, &excp);
quit_on_exception (&excp);
libvlc_playlist_play (inst, item, 0, NULL, &excp);
quit_on_exception (&excp);
Sleep (10000);
libvlc_destroy (inst);
return 0;
}

=== Compile/link ===

You can use LibVLC without compiling your own copy of the VLC source code. You can use the libvlc.dll which comes in the standard end user installation. But, to access the include files, you will need to download and extract the source code. You only need to untar it; you do not even need to run the configure script.
Set your %PATH% to include the directory which contains libvlc.dll and the plugins directory. For example, add "C:\Program files\VideoLAN\VLC" in a relatively standard installation. This way the compiler can find libvlc.dll. Otherwise you have to copy the dll to your current directory.
Use the following Makefile:

VLC_INST = "C:\Program files\VideoLAN\VLC"
VLC_SRC = "C:\tools\vlc-0.8.6c\"
demo: demo.c
gcc -o demo demo.c -I$(VLC_SRC)/include \
-L$(VLC_INST) -llibvlc

=== Code for Linux ===

#include <stdio.h>
#include <stdlib.h>
#include <vlc/libvlc.h>

static void quit_on_exception (libvlc_exception_t *excp) {
if (libvlc_exception_raised (excp)) {
fprintf(stderr, "error: %s\n", libvlc_exception_get_message(excp));
exit(-1);
}
}

int main(int argc, char **argv) {
libvlc_exception_t excp;
libvlc_instance_t *inst;
int item;
char *filename = "/tmp/WorldOfPadman_Intro.avi";

libvlc_exception_init (&excp);
inst = libvlc_new (argc, argv, &excp);
quit_on_exception (&excp);
item = libvlc_playlist_add (inst, filename, NULL, &excp);
quit_on_exception (&excp);
libvlc_playlist_play (inst, item, 0, NULL, &excp);
quit_on_exception (&excp);
usleep (10000000);
libvlc_destroy (inst);
return 0;
}

See [http://files.filefront.com/WorldOfPadman+Introavi/;6089800;/fileinfo.html] for ''WorldOfPadman_Intro.avi''. (You can, of course, substitute any video you like.)

=== Compile/Link/Run for Linux ===

$ export VLC_SRC=/tmp/vlc-0.8.6c
$ gcc -I ${VLC_SRC}/include/ -lvlc -L ${VLC_SRC}/src/.libs/ demo.c -o demo
$ export LD_LIBRARY_PATH=${VLC_SRC}/src/.libs/
$ ./demo --plugin-path ${VLC_SRC}

User:J-b

2009-02-15T06:08:33Z

Jpeg: /* Get VLC */

== General presentation ==

'''Hello!'''

My name is '''Jean-Baptiste Kempf''' and [http://www.jbkempf.com my personnal website] explains more who I am and what I do.
I graduated in one of the best 'Grandes Ecoles', best scientific schools and universities in France: the ''[http://www.ecp.fr "Ecole Centrale Paris"]''.

I also got a ''Master Degree'' in Computer Science from the University of Paris.

My degree ''"Ingénieur de l'école Centrale Paris"'', which is also a Master Degree.

I am now a scientific attaché at the French Consulate in San Francisco.

I am working on the VideoLAN project in many aspects for about a year now and I am very much involved, but not only on the devs aspects.

As a dev, I mostly program Qt4 interface. I also work a lot on contribs and external libraries and [[FourCC]] supports. I have built VLC media player on most possible platform (no BeOS, though).

As a non-dev, I moderate e-mails, worked a lot on this wiki (almost rewritten it with [[User:H2g2bob]]), answer forums and mails, work on the websites and help on IRC. As you can imagine, I do a lot of support.

I am looking for a job, outside France. Interested? :D

jb (at) videolan (d0t) org is my mail, related to VideoLAN.
[http://www.jbkempf.com My Website] (far from being finished) is my website.

Use my talk page to talk to me or give me some TODOs.

== Wiki ==

I have rewritten a lot of pages on this wiki, and I have more than 1000 edits on this wiki.

=== Names ===

I am know under 'j-b', 'jb' on all the [[VideoLAN Sites]]

== My VLC ==
This is my tips to help you build the best VLC ever. I use debian/sid, for many reasons.

=== External libraries ===
apt-get build-dep vlc libdvdcss2

=== Get VLC ===
<pre> git clone git://git.videolan.org/vlc.git</pre>
<pre> cd vlc; ./bootstrap </pre>

<pre> cd extras;</pre>

=== x264 (optional) ===

<pre> git clone git://git.videolan.org/x264.git x264-trunk</pre>

<pre> cd x264-trunk; make</pre>

=== live555 (optional) ===
<pre>
wget http://www.live555.com/liveMedia/public/live555-latest.tar.gz
</pre>

<pre>
tar xvzf live555-latest.tar.gz
cd live

sh genMakefiles linux;
make
</pre>

=== ffmpeg (mandatory) ===

<pre>
cd vlc-trunk/extras
svn checkout svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg
cd ffmpeg
</pre>

==== ffmpeg configure line ====
<pre>
./configure --enable-gpl --enable-pthreads --enable-libmp3lame --enable-libfaac</pre>
<pre> make </pre>

=== VLC configure line ===
<pre>
./configure --prefix=/usr \
--enable-snapshot --enable-debug \
--enable-dbus-control --enable-musicbrainz \
--enable-shared-libvlc --enable-mozilla \
--enable-lirc \
--enable-live555 --with-live555-tree=../extras/live \
--with-ffmpeg-tree=../extras/ffmpeg \
--enable-x264 --with-x264-tree=../extras/x264-trunk \
--enable-shout --enable-taglib \
--enable-v4l --enable-cddax \
--enable-dvb --enable-vcdx \
--enable-realrtsp --enable-xvmc \
--enable-svg --enable-dvdread \
--enable-dc1394 --enable-dv \
--enable-theora --enable-faad \
--enable-twolame --enable-real \
--enable-flac --enable-tremor \
--with-ffmpeg-mp3lame --with-ffmpeg-faac \
--enable-quicktime --enable-dirac \
--enable-skins2 --enable-qt4 \
--enable-ncurses \
--enable-aa --enable-caca \
--enable-esd --enable-portaudio \
--enable-jack --enable-xosd \
--enable-galaktos --enable-goom \
--enable-ggi \
--disable-cddax --disable-vcdx

</pre>

<pre>make</pre>

== Ubuntu ==
apt-get build-dep vlc

apt-get install libtool automake1.9

ffmpeg.

XSPF

2009-01-17T13:47:20Z

Jpeg: /* VLC Extensions */

{{website|XPSF|http://www.xspf.org/}}
'''XSPF''', pronounced "spiff", is a [[playlist]] in [[XML]] format, which is supported by [[Xiph]]. It is a free and open format so can be easily, freely used for sharing playlists.

== Sample ==
A very simple document looks like this:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
<trackList>
<track><location>file:///mp3s/song_1.mp3</location></track>
<track><location>file:///mp3s/song_2.mp3</location></track>
<track><location>file:///mp3s/song_3.mp3</location></track>
</trackList>
</playlist>

== Compatability ==
{{compat}}

== VLC Extensions ==
XSPF supports extensions to allow applications to add special data. These extensions can appear in the following entries:
* playlist
* track

The extension format is defined in the namespace <code>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</code>:
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
...
<extension application="http://www.videolan.org/vlc/playlist/0">
...
</extension>
</playlist>

Currently, extensions support the following elements:
* vlc:node
* vlc:item
* vlc:id
* vlc:option

The extensions vlc:node and vlc:item are used to specify how to display the playlist tree, which is not supported by standard XSPF.

=== vlc:node ===
This element will be displayed as a node in the playlist. It appears as an extension of the '''playlist''' block (under playlist/extension). Only its name can be specified:
<vlc:node title="Node title">
[list of vlc:item or vlc:node]
</vlc:node>

=== vlc:item ===
This element represents a playlist item (not a node). It appears as an extension of the '''playlist''' block (under playlist/extension). It contains only a track id (see below, vlc:id):
<vlc:item tid="42" />

=== vlc:id ===
This element specifies a track's id. It appears as an extension of the '''track''' block (under playlist/trackList/track/extension).
<vlc:id>42</vlc:id>
The value of the id corresponds to the value of the attribute tid of vlc:item.

=== vlc:option ===
This element allows you to add options to the input item. It appears as an extension of the '''track''' block (under playlist/trackList/track/extension).
<vlc:option>option-name</vlc:option>
Or, if the option has a value:
<vlc:option>option-name=option-value</vlc:option>

=== Example of XSPF with VLC extensions ===
Let's summarize these as an example:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
<title>Playlist</title>
<location>D:/media/example.xspf</location>
<trackList>
<track>
<title>Track 1</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>0</vlc:id>
</extension>
</track>
<track>
<title>Track 2</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>1</vlc:id>
</extension>
</track>
<track>
<title>Track 3</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>2</vlc:id>
</extension>
</track>
<track>
<title>Track 4</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>3</vlc:id>
<vlc:option>my-option=42</vlc:option>
</extension>
</track>
</trackList>
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:node title="Node 1">
<vlc:item tid="0" />
<vlc:item tid="1" />
<vlc:node title="Node 2">
<vlc:item tid="2" />
<vlc:item tid="3" />
</vlc:node>
</vlc:node>
</extension>
</playlist>

This playlist example will be displayed as:
Playlist
`- Node 1
|- Track 1
|- Track 2
`- Node 2
|- Track 3
`- Track 4

The input for ''Track 4'' will be created with the option ''my-option'' set to 42.

== See also ==
There are many advantages to using XML as the format.
More information is available at
* [http://www.xiph.org/ Xiph.org]
* [http://www.xspf.org/quickstart/ XSPF project website].

[[Category:Playlist]]

XSPF

2009-01-17T13:46:27Z

Jpeg: /* vlc:item */

{{website|XPSF|http://www.xspf.org/}}
'''XSPF''', pronounced "spiff", is a [[playlist]] in [[XML]] format, which is supported by [[Xiph]]. It is a free and open format so can be easily, freely used for sharing playlists.

== Sample ==
A very simple document looks like this:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
<trackList>
<track><location>file:///mp3s/song_1.mp3</location></track>
<track><location>file:///mp3s/song_2.mp3</location></track>
<track><location>file:///mp3s/song_3.mp3</location></track>
</trackList>
</playlist>

== Compatability ==
{{compat}}

== VLC Extensions ==
XSPF supports extensions to allow applications to add special data. These extensions can appear in the following entries:
* playlist
* track

The extension format is defined in the namespace <code>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</code>:
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
...
<extension application="http://www.videolan.org/vlc/playlist/0">
...
</extension>
</playlist>

Currently, extensions support the following elements:
* vlc:node
* vlc:item
* vlc:id
* vlc:option

The extensions vlc:node and vlc:item are used to specify how to display the playlist tree, which is not supported by standard XSPF.

=== vlc:node ===
This element will be displayed as a node in the playlist. It appears as an extension of the '''playlist''' block (under playlist/extension). Only its name can be specified:
<vlc:node title="Node title">
[list of vlc:item or vlc:node]
</vlc:node>

=== vlc:item ===
This element represents a playlist item (not a node). It appears as an extension of the '''playlist''' block (under playlist/extension). It contains only a track id (see below, vlc:id):
<vlc:item tid="42" />

=== vlc:id ===
This element specifies a track's id. It appears as an extension of the '''track''' block.
<vlc:id>42</vlc:id>
The value of the id corresponds to the value of the attribute tid of vlc:item.

=== vlc:option ===
This element allows you to add options to the input item. It appears as an extension of the '''track''' block.
<vlc:option>option-name</vlc:option>
Or, if the option has a value:
<vlc:option>option-name=option-value</vlc:option>

=== Example of XSPF with VLC extensions ===
Let's summarize these as an example:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
<title>Playlist</title>
<location>D:/media/example.xspf</location>
<trackList>
<track>
<title>Track 1</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>0</vlc:id>
</extension>
</track>
<track>
<title>Track 2</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>1</vlc:id>
</extension>
</track>
<track>
<title>Track 3</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>2</vlc:id>
</extension>
</track>
<track>
<title>Track 4</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>3</vlc:id>
<vlc:option>my-option=42</vlc:option>
</extension>
</track>
</trackList>
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:node title="Node 1">
<vlc:item tid="0" />
<vlc:item tid="1" />
<vlc:node title="Node 2">
<vlc:item tid="2" />
<vlc:item tid="3" />
</vlc:node>
</vlc:node>
</extension>
</playlist>

This playlist example will be displayed as:
Playlist
`- Node 1
|- Track 1
|- Track 2
`- Node 2
|- Track 3
`- Track 4

The input for ''Track 4'' will be created with the option ''my-option'' set to 42.

== See also ==
There are many advantages to using XML as the format.
More information is available at
* [http://www.xiph.org/ Xiph.org]
* [http://www.xspf.org/quickstart/ XSPF project website].

[[Category:Playlist]]

XSPF

2009-01-17T13:46:09Z

Jpeg: /* vlc:node */

{{website|XPSF|http://www.xspf.org/}}
'''XSPF''', pronounced "spiff", is a [[playlist]] in [[XML]] format, which is supported by [[Xiph]]. It is a free and open format so can be easily, freely used for sharing playlists.

== Sample ==
A very simple document looks like this:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
<trackList>
<track><location>file:///mp3s/song_1.mp3</location></track>
<track><location>file:///mp3s/song_2.mp3</location></track>
<track><location>file:///mp3s/song_3.mp3</location></track>
</trackList>
</playlist>

== Compatability ==
{{compat}}

== VLC Extensions ==
XSPF supports extensions to allow applications to add special data. These extensions can appear in the following entries:
* playlist
* track

The extension format is defined in the namespace <code>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</code>:
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
...
<extension application="http://www.videolan.org/vlc/playlist/0">
...
</extension>
</playlist>

Currently, extensions support the following elements:
* vlc:node
* vlc:item
* vlc:id
* vlc:option

The extensions vlc:node and vlc:item are used to specify how to display the playlist tree, which is not supported by standard XSPF.

=== vlc:node ===
This element will be displayed as a node in the playlist. It appears as an extension of the '''playlist''' block (under playlist/extension). Only its name can be specified:
<vlc:node title="Node title">
[list of vlc:item or vlc:node]
</vlc:node>

=== vlc:item ===
This element represents a playlist item (not a node). It appears as an extension of the '''playlist''' block. It contains only a track id (see below, vlc:id):
<vlc:item tid="42" />

=== vlc:id ===
This element specifies a track's id. It appears as an extension of the '''track''' block.
<vlc:id>42</vlc:id>
The value of the id corresponds to the value of the attribute tid of vlc:item.

=== vlc:option ===
This element allows you to add options to the input item. It appears as an extension of the '''track''' block.
<vlc:option>option-name</vlc:option>
Or, if the option has a value:
<vlc:option>option-name=option-value</vlc:option>

=== Example of XSPF with VLC extensions ===
Let's summarize these as an example:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
<title>Playlist</title>
<location>D:/media/example.xspf</location>
<trackList>
<track>
<title>Track 1</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>0</vlc:id>
</extension>
</track>
<track>
<title>Track 2</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>1</vlc:id>
</extension>
</track>
<track>
<title>Track 3</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>2</vlc:id>
</extension>
</track>
<track>
<title>Track 4</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>3</vlc:id>
<vlc:option>my-option=42</vlc:option>
</extension>
</track>
</trackList>
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:node title="Node 1">
<vlc:item tid="0" />
<vlc:item tid="1" />
<vlc:node title="Node 2">
<vlc:item tid="2" />
<vlc:item tid="3" />
</vlc:node>
</vlc:node>
</extension>
</playlist>

This playlist example will be displayed as:
Playlist
`- Node 1
|- Track 1
|- Track 2
`- Node 2
|- Track 3
`- Track 4

The input for ''Track 4'' will be created with the option ''my-option'' set to 42.

== See also ==
There are many advantages to using XML as the format.
More information is available at
* [http://www.xiph.org/ Xiph.org]
* [http://www.xspf.org/quickstart/ XSPF project website].

[[Category:Playlist]]

XSPF

2009-01-15T14:03:30Z

Jpeg: VLC extensions in XSPF

{{website|XPSF|http://www.xspf.org/}}
'''XSPF''', pronounced "spiff", is a [[playlist]] in [[XML]] format, which is supported by [[Xiph]]. It is a free and open format so can be easily, freely used for sharing playlists.

== Sample ==
A very simple document looks like this:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
<trackList>
<track><location>file:///mp3s/song_1.mp3</location></track>
<track><location>file:///mp3s/song_2.mp3</location></track>
<track><location>file:///mp3s/song_3.mp3</location></track>
</trackList>
</playlist>

== Compatability ==
{{compat}}

== VLC Extensions ==
XSPF supports extensions to allow applications to add special data. These extensions can appear in the following entries:
* playlist
* track

The extension format is defined in the namespace <code>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</code>:
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
...
<extension application="http://www.videolan.org/vlc/playlist/0">
...
</extension>
</playlist>

Currently, extensions support the following elements:
* vlc:node
* vlc:item
* vlc:id
* vlc:option

The extensions vlc:node and vlc:item are used to specify how to display the playlist tree, which is not supported by standard XSPF.

=== vlc:node ===
This element will be displayed as a node in the playlist. It appears as an extension of the '''playlist''' block. Only its name can be specified:
<vlc:node title="Node title">
[list of vlc:item or vlc:node]
</vlc:node>

=== vlc:item ===
This element represents a playlist item (not a node). It appears as an extension of the '''playlist''' block. It contains only a track id (see below, vlc:id):
<vlc:item tid="42" />

=== vlc:id ===
This element specifies a track's id. It appears as an extension of the '''track''' block.
<vlc:id>42</vlc:id>
The value of the id corresponds to the value of the attribute tid of vlc:item.

=== vlc:option ===
This element allows you to add options to the input item. It appears as an extension of the '''track''' block.
<vlc:option>option-name</vlc:option>
Or, if the option has a value:
<vlc:option>option-name=option-value</vlc:option>

=== Example of XSPF with VLC extensions ===
Let's summarize these as an example:
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
<title>Playlist</title>
<location>D:/media/example.xspf</location>
<trackList>
<track>
<title>Track 1</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>0</vlc:id>
</extension>
</track>
<track>
<title>Track 2</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>1</vlc:id>
</extension>
</track>
<track>
<title>Track 3</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>2</vlc:id>
</extension>
</track>
<track>
<title>Track 4</title>
...
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:id>3</vlc:id>
<vlc:option>my-option=42</vlc:option>
</extension>
</track>
</trackList>
<extension application="http://www.videolan.org/vlc/playlist/0">
<vlc:node title="Node 1">
<vlc:item tid="0" />
<vlc:item tid="1" />
<vlc:node title="Node 2">
<vlc:item tid="2" />
<vlc:item tid="3" />
</vlc:node>
</vlc:node>
</extension>
</playlist>

This playlist example will be displayed as:
Playlist
`- Node 1
|- Track 1
|- Track 2
`- Node 2
|- Track 3
`- Track 4

The input for ''Track 4'' will be created with the option ''my-option'' set to 42.

== See also ==
There are many advantages to using XML as the format.
More information is available at
* [http://www.xiph.org/ Xiph.org]
* [http://www.xspf.org/quickstart/ XSPF project website].

[[Category:Playlist]]

ActiveX/HTML

2008-10-08T12:36:42Z

Jpeg: Fix <html> tag breaking the layout

{{howto| use the [[ActiveX]] control within a webpage}}

==Embedding Activex using Javascript==

You can insert the [[ActiveX]] control in your HTML pages like this :

<OBJECT classid="clsid:9BE31822-FDAD-461B-AD51-BE1D1C159921"
codebase="http://downloads.videolan.org/pub/videolan/vlc/latest/win32/axvlc.cab"
width="640" height="480" id="vlc" events="True">
<param name="Src" value="" />
<param name="ShowDisplay" value="True" />
<param name="AutoLoop" value="False" />
<param name="AutoPlay" value="False" />
</OBJECT>

Then, using Javascript, you can select another source, or change the audio track :

document.vlc.playlistClear();
var options=[":audio-track=5"]; // select audio track 5 (=6th, 1st is 0)
document.vlc.addTarget("...",options,2,0); // replace entry 0
document.vlc.play();

See http://people.videolan.org/~damienf/plugin-0.8.6.html for a complete demo.

==Embedding ActiveX using m3u Playlists==
Maybe a better to show VLC in an HTML Website is to use m3u Playlists. It has got the advantage that users with turned-off Javascript can also use this plugin, since document.vlc.addTarget won't work with javascript turned off.

* Step 1: Create the HTML website with the VLC-Object linked to the m3u playlist
* Step 2: Create your m3u playlist with all options, save and upload it to your webspace.
* Step 3 (optional): Create buttons and other objects to control VLC (like document.vlc.play();)

'''Step 1: Creating the website to embed ActiveX Control'''
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
< HTML >
<BODY marginwidth="0" marginheight="0" topmargin="0" leftmargin="0">
<OBJECT classid="clsid:E23FE9C6-778E-49D4-B537-38FCDE4887D8"
codebase="http://downloads.videolan.org/pub/videolan/vlc/latest/win32/axvlc.cab"
width="400" height="300" id="vlc" events="True">
<param name="Src" value="myplaylist.m3u" />
<param name="ShowDisplay" value="True" />
<param name="AutoLoop" value="True" />
<param name="AutoPlay" value="True" />
<param name="Volume" value="100">
</OBJECT>
</BODY>
< /HTML >
You should modify the values of width, height and volume (0-100) fitting to your desires. If you don't know them, simply delete them (e.g. remove ''width="640"'' from the code).

'''Step 2: Creating the m3u playlist'''

Open Notepad, create your playlist and save it as 'myplaylist.m3u' for this example.
#EXTM3U // Required to identify this file as m3u file
#EXTVLCOPT--input-repeat=-1 // repeat the following file/playlist
#EXTVLCOPT--http-reconnect=true // required for a streaming-client to enable repeat
#EXTVLCOPT--any further parameter goes here // see also [[VLC command-line help]]
#EXTINF:0, Test Description // set the title for the following file shown in your playlist
video.mpg // the actual file to be displayed

'''Annotations:'''
* For actual looping of the entire playlist, the user has to have check 'Repeat all' under Preferences --> Playlist --> General
* Mind that options have different names if you play a file locally or if you want to stream it (--sub-filter --> --s-filter)

'''Mind the different Options-styles:'''
--option A global option that is set for the duration of the program.
-option A single letter version of a global --option.
:option An option that only applies to the playlistitem directly before it
and that overrides previous settings.

==Known Problems and how to solve them==

'''Problem'''

A know problem is, that the VLC-Plugin won't be displayed. Instead, you are asked whether you want to install the VLC-ActiveX-Component. "Don't install" cancels the installation and nothing happens. "Install" runs the usual VLC-Setup (mind to install the ActiveX-Plugin), but after reopening an HTML-page with the VLC-Plugin, it's the same situation as before.

'''Solution'''

* Use the "other" ClassID in your HTML-Source as shown above:
<OBJECT classid="clsid:9BE31822-FDAD-461B-AD51-BE1D1C159921" ...

* You have to lower the security settings on your PC. '''Do this at your own risk! Use [http://www.getfirefox.com Firefox] to browse the web!'''

* In Internet Explorer select [Tools], [Internet Options]. The "Internet Options" window opens. Select the Tab "Advanced". Scroll down until you see the main point "Security".

* Check the following entries:
** Allow active content to CDs to run on My Computer
** Allow active content to run in files on My Computer
** Allow software to run or install even if the signature is invalid

* Instead of lowering security level, you can add the website address to the right security area.

==See also==
* [[ActiveX/Delphi|Delphi Implementation]]
* [[ActiveX|ActiveX Description]]

[[Category:Embedded]]

Win32CompileCygwinNew

2008-07-17T20:45:38Z

Jpeg: Update contrib, format fix

This is a new version of the Win32CompileCygwin written by [[User:J-b|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
libiconv
libtool
make
mingw-runtime
nasm
patchutils
pkg-config
subversion

Editor
vim

Libs
libgcrypt

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

==Cygwin environment==

Start Cygwin from the icon on your desktop (With Windows Vista run it with admin rights, so right click and select "Run as administrator"). 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

'''Note for Windows users using [http://www.cygwin.com Cygwin] (linux-like build environment):'''

Applies to:

Windows XP Service Pack 2 with Security Update '''KB925902''' installed
Windows XP Service Pack 3

There is a problem on Windows XP (and possibly on other Microsoft Operating Systems) with 'git clone' which aborts unexpectedly with a Cygwin error during the 'checking out files' (reproducable every time and at the same percentage) at the end of the clone procedure:

$ 2 [main] git 4012 D:\cygwin\bin\git.exe:
*** fatal error - '''could not load shell32, Win32 error 487'''

This has been verified (May 22, 2008) against the currently available Cygwin 1.5.25-12 with git package versions 1.5.5.1-1 and 1.5.4-1 and is a generic problem which also affects cloning from other git repositories (although x264.git seems unaffected).

The issue is referred to in the mail archives of the Cygwin project mailing list here
[http://sourceware.org/ml/cygwin/2007-07/msg00858.html Git error on Cygwin].

By eliminating the impossible, whatever remained, however improbable, it is the following Windows Security Update (April 3, 2007) which is actually the cause of the Cygwin issue: [http://www.microsoft.com/technet/security/bulletin/ms07-017.mspx Microsoft Security Bulletin MS07-017 - Vulnerabilities in GDI Could Allow Remote Code Execution (925902)]

Even though the same Security Update applies to the following systems, these are reported not to be affected:

Windows Vista Service Pack 1
Windows 2003 Server Standard Service Pack 2

''It is possible to get 'git clone' working again on the affected systems by removing the Security Update (KB925902) but this is obviously not recommended for security reasons.''

== Snapshots ==

You can do the same by using the snapshots in the [http://nightlies.videolan.org/ nightly builds] site.

=Bootstrap=

Open the '''configure.ac''' file, and modify the requirement for gettext 0.17 to 0.15 (so replace line '''AM_GNU_GETTEXT_VERSION(0.17)''' with line '''AM_GNU_GETTEXT_VERSION(0.15)'''), and then run bootstrap.

cd vlc
./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.

== Get the 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-20080702-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-20080702-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 (/usr/win32 folder) 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/

=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 \
--disable-mkv --disable-taglib

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 linuxs 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

After your configure-vlc.sh is completed, copy it to your vlc directory and run it:

./configure-vlc.sh

If it complains about permissions, use chmod and try again:

chmod 777 configure-vlc.sh

NOTE. (If you plan to use JVLC) To make vlc-control.dll accessible by Java on ''Windows'' cofigure-vlc.sh should be modified to include "-Wl,--add-stdcal-alias". Example:

...
CC="gcc -mno-cygwin -Wl,--add-stdcall-alias" CXX="g++ -mno-cygwin -Wl,--add-stdcall-alias" \
./configure \
...

===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

Build it! (remember to run configure-vlc.sh before first build)

make

Cross your fingers and wait... because it might take few hours before compilation is done.
If you have multicore CPU or multi CPU box, you can use -j2 switch (or maybe -j3 or -j4 etc.) to speed up make process

make -j2

==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. You can use '''export TMPDIR="/cygdrive/c/temp"''' or any directory for it (/cygdrive/c/temp is same as C:\temp). If this doesn't help, make sure you run cygwin with admin rights (With Windows Vista, right click cygwin shortcut and select "Run as administrator"). Avira AntiVir might also cause issues to m4, so disabling it while ./bootstrap might help.

=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 by [[User:J-b|jb]]

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

20080311 Simplification

20080323 Added some tips for Vista

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

DBus-spec

2008-04-25T14:30:42Z

Jpeg:

Specification for a Common, Desktop neutral, Media Player D-Bus interface

'''Please note this document is not specific to VLC and is a work in progress.'''

OBSOLETE, KEPT FOR HISTORICAL REASONS

MPRIS discussion is at http://wiki.xmms2.xmms.se/index.php/Media_Player_Interfaces

MPRIS specification is at http://wiki.xmms2.xmms.se/index.php/MPRIS

What follows has been largely stolen from http://bmpx.beep-media-player.org/site/MPRIS_Interfacing_Specification

This is an attempt to create a specification for media players to use, for '''YOUR''' applications to be able to interact with '''ANY''' Media Player '''YOU''' want to use on '''ANY''' desktop '''YOU''' want to use.

This is in the spirit of http://www.freedesktop.org and uses code and ideas from this project, most notably D-Bus : http://dbus.freedesktop.org and uses ideas from http://www.musicbrainz.org

= Other players =

How other "Media Players" interact with D-Bus

== bmpx ==

http://bmpx.beep-media-player.org/site/MPRIS_Interfacing_Specification

== banshee ==

http://cvs.gnome.org/viewcvs/*checkout*/banshee/src/Banshee.Base/DBusPlayer.cs

== rhythmbox ==

http://cvs.gnome.org/viewcvs/rhythmbox/remote/dbus/rb-client.c?view=markup

== muine ==

http://cvs.gnome.org/viewcvs/muine/DBusLib/Player.cs?view=markup

== amarok ==

http://amarok.kde.org/wiki/DCOP_Functions
(D-Bus will replace DCOP in KDE4, Amarok 2.0)

== xmms 2 ==

http://wiki.xmms2.xmms.se/index.php/MPRIS

= Definitions =

== "Media Player" ==

An application, either with GUI or GUI-less (or which allows for both modes of operation) which is capable of playing back audio/video streams. The means by which it does accomplish that (e.g. which audio backend to use, and which output method) is out of the scope of this document.

The "Media Player" '''must''':
* Be able to play back at least local storage file streams.
* Be able to play back at least one stream at a time.

== "Client" ==

The Client is an unspecified application that will interact with the "Media Player" using D-Bus protocol.
For example:

* A softphone, that pauses, or step the volume down, when a call is being received.
* An applet that nicely integrates in your desktop environment, to control your "Media Player".
* An instant messaging client which informs your buddies of what you're listening to.
* A monitor that stores in a database what you are listening to, for statistics purpose.
* A video editing software that calls an external "Media Player" to preview your work.

== "Tracklist" ==

A list of media files which resides within the "Media Player", and whose implementation is opaque to the remote interface.

The "Tracklist" '''must''':
* Hold an ordered list of locations of the media files as URIs (e.g. file:// or <nowiki>http://</nowiki>). The implementation of this can be opaque, which means, it does not neccesarily need to store URIs, but upon remote request, it must be able to return an URI for a given media file.
* Keep the list in an ordered fashion. The order can be changed at any time trough e.g. sorting algorithms, in which case the "Media Player" must send information about the reordering trough it's remote interface

The "Tracklist" '''can''', but does not '''need''' to:
* Hold "Metadata" about media files

== "Metadata" ==

"Metadata" is data that the files carry within themselves as a means of self-identification (commonly known as "tags"), or data that has been retrieved about the files trough other means, e.g. an internet service that provides additional data about particular media files.
"Metadata" is an array of dict entries, like ("length", 253), ("name", "Bolero"), ("video-codec", "DIVX"). The dict entry is in the form (string, variant) eg: {sv}.

Furthermore, "Metadata" can be split into two categories:

1) Technical metadata:
* "URI":"s"
* "length":"i" (length in seconds)
* "video-codec":"s" (video codec as a fourcc)
* "audio-codec":"s" (audio codec as a fourcc)
* "video-bitrate":"i" video bitrate
* "audio-bitrate":"i" audio bitrate
* "audio-samplerate":"i" (audio samplerate)

2) Informational metadata
* "name":"s"
* "artist":"s"
* "album":"s"
* "unique-id":"s" : Musicbrainz Track Identifier as specified on http://musicbrainz.org/docs/specs/metadata_tags.html
* "genre":"s"

This list is informative, and can be extended up to your needs, for example: "age of the captain":"i"

Only Required fields are: "URI" and "length"

= D-Bus =

== The Service ==

org.freedesktop.MediaPlayer

All "Media Players" '''must''' request this name and do not let other "Media Players" 'steal' this name.
Using libdbus, that would be:

DBusConnection *dbus_connection;
DBusError dbus_error;
dbus_bus_request_name( dbus_connection, "org.freedesktop.MediaPlayer", 0, &dbus_error );

To be able to request the name, and so, be able to communicate via D-Bus, no "Media Player" must be running. The "Media Player" may call the Quit method, and wait till the name is unregistered, to ensure this is the case.

: I think this is a bad idea, it's not the place for a interop Spec to force single instance behaviour without a good reason (i run amarok all the time and use vlc to play videos or streams...). Why not suggest that mediaplayers register with the well known service name ("org.freedesktop.MediaPlayer") with the options QueueService and suggest the media player should register an application specific service in addition?

: if done that way we gain the feature to query the dbus daemon for all clients queued for that dbus name, so enumerating all current musicplayers that support the Spec is not problem. Contacting the players is not problem to because every client on dbus has a unique name anyway. DBus signal do AFAIK carry the dbus service name of the sending client, so there is no trouble knowing which player send a signal. [[User:textshell|textshell]]

== The Object Hierarchy ==

* / : Media Player identification

* /Player : Playback control

* /TrackList : TrackList management

== The interface ==

All methods must be accessed through the interface org.freedesktop.MediaPlayer

i.e. calling Quit with qdbus would be:
$ qdbus org.freedesktop.MediaPlayer /Player org.freedesktop.MediaPlayer.Quit

== The Methods ==

What's missing: we could use musicbrainz unique identifier to identify current element in the playlist
From fd.o : GetTrackList (using xspf?), ClearTrackList

* /

Identity : Identify the "Media Player" as in "VLC 0.9.0", "bmpx 0.34.9", "Totem 2.16.2" ...

<method name="Identity">
<arg type="s" direction="out"/>
</method>

* /TrackList

GetMetadata : Gives all meta data available for element at given position in the "TrackList"

<method name="GetMetadata">
<arg type="i" direction="in" />
<arg type="a{sv}" direction="out" />
</method>

GetCurrentTrack : Position of Current URI in the "TrackList"

<method name="GetCurrentTrack">
<arg type="i" direction="out" />
</method>

GetLength : Number of elements in the "TrackList"

<method name="GetLength">
<arg type="i" direction="out" />
</method>

AddTrack : Appends an URI in the "TrackList", play it immediately if the 2nd argument is TRUE

<method name="AddTrack">
<arg type="s" />
<arg type="b" />
</method>

DelTrack : Removes an URI from the "TrackList", given its position

<method name="DelTrack">
<arg type="i" />
</method>

* /Player

Next : Goes to the next element (what if we're at the end?)

<method name="Next">
</method>

Prev : Goes to the previous element (what if we're at the beginning?)

<method name="Prev">
</method>

Pause : If playing : pause. If paused : unpause. If stopped : start playing

<method name="Pause">
</method>

Stop : Stop playing.

<method name="Stop">
</method>

Play : If playing : rewind to the beginning of current track, else : start playing.

<method name="Play">
</method>

Quit : Makes the "Media Player" exit.

<method name="Quit">
</method>

GetStatus : Return the status of "Media Player": 0 = Playing, 1 = Paused, 2 = Stopped.

<method name="GetStatus">
<arg type="i" direction="out"/>
</method>

VolumeSet : Sets the volume (argument must be in [0;100])

<method name="VolumeSet">
<arg type="i"/>
</method>

GetVolume : Returns the current volume (must be in [0;100])

<method name="VolumeGet">
<arg type="i" direction="out"/>
</method>

PositionSet : Sets the playing position (argument must be in [0;100])

<method name="PositionSet">
<arg type="i"/>
</method>

PositionGet : Returns the playing position (must be in [0;100])

<method name="PositionGet">
<arg type="i" direction="out"/>
</method>

== The signals ==

TrackChange : Signal is emitted when the "Media Player" plays another "Track". Argument of the signal is the metadata attached to the new "Track"

<signal name="TrackChange">
<arg type="a{sv}"/>
</signal>

StatusChange : Signal is emitted when the status of the "Media Player" change. The argument has the same meaning than the value returned by GetStatus.

<signal name="StatusChange">
<arg type="i"/>
</signal>

CapabilityChange : [TODO] Signal is emitted when the "Media Player" changes capabilities, Flags are CAN_GO_NEXT CAN_GO_PREV CAN_PAUSE CAN_PLAY CAN_SEEK CAN_PROVIDE_METADATA PROVIDES_TIMING

<signal name="CapabilityChange">
<arg type=TODO />
</signal>

= See Also =
* [http://bmpx.beep-media-player.org/site/MPRIS_Interfacing_Specification MPRIS Interfacing Specification] (BMPx wiki)
* [http://wiki.xmms2.xmms.se/index.php/Media_Player_Interfaces Media Player Interfaces] (XMMS2 wiki)

VLC ECP Project

2008-02-25T16:38:31Z

Jpeg: Three people at ECP have a 2nd year project about VLC. This page describes their goals.

Five people from Ecole Centrale Paris ([[http://www.ecp.fr ECP]]) have a second year project related to VLC Media Player. Three of them work on VLC development : ivoire, phytos and JPeg.

= Project ECP =

== Main goal ==

The main objective of our project is to create a Media Collection, or Media Library, based on an SQL database. This would allow people to use VLC Media Player as a real Media Center.

The database will be used to store information about every medias, and create a collection with them. The database will be a little complex because VLC Media Player is able to read Videos, Musics, Streams from the Internet, ... and all of these medias have to be collected.

== Git repository ==

Thanks to pdherbemont, we have our own git branch in the VLC repository. See [[http://git2.videolan.org/?p=vlc-ecp-project.git;a=summary]] for more details.

= Pending patches =

Some of these patches may have already been included in the main SVN or Git repo.

== Subtitles downloader ==

''By JPeg''

I have written a module to automagically download subtitles from [[http://www.opensubtitles.org OpenSubtitles.Org]] and insert them in the Video playback. It is based on a lua script to fetch a list of subtitles from a webpage. This way allows us to implement other subtitles databases than only OpenSubtitles.Org.

An user interface has been implemented only for Qt4.

== Zip files extractor ==

''By JPeg''

As OpenSubtitles.Org does not provide directly .srt, .sub, etc... subtitles files but a .zip archive, I had to decompress the files. I just reused code from skins2 and create a simple module with it. This module, called extractzip provides functions to extract files from archives. (On 25 February 2008, it supports only ZIP compression model).

It would be great to create a demux on this model, so that you don't need to extract files on the hard drive to read them.