1 <!doctype linuxdoc system>
4 <title>VLC HOWTO</title>
5 <author>Originally written by Henri Fallon, maintained by Johan Bilien<tt><htmlurl url="mailto:jobi@videolan.org" name="<jobi@videolan.org>"></tt></author>
6 <date>v0.0.9, 16 april 2002</date>
9 This document describes how to use the vlc (VideoLAN client) to read DVDs and mpeg files, locally or from a network.
16 <heading>Introduction</heading>
19 <heading>What is VideoLAN ?</heading>
21 VideoLAN is a project of sudents of the École Centrale Paris which aims
22 to broadcast video on the campus, and provide the students with a MPEG2
23 software-only decoder. VideoLAN is an OpenSource project which will thus
24 allow anyone to watch DVD movies under Linux, BeOS, MacOS X, Windows
29 You may want to look at the port section on our website :
30 <htmlurl url="http://www.videolan.org" name="http://www.videolan.org/">.
35 <heading>What is the VideoLAN project ?</heading>
37 VideoLAN is a complete software solution for video streaming, developed
38 by students at the <htmlurl url="http://www.ecp.fr" name="Ecole Centrale
39 Paris"> and contributors from all over the world, under the General
40 Public License (GPL). It has been designed for streaming MPEG 1 and MPEG
41 2 videos on local area networks (LAN), but it can be extended to
42 metropolitan or wide area networks (MAN, WAN),
43 thanks to the multicast technology.
44 The VideoLAN solution includes a server, which can stream video from
45 various sources (file, DVD, satellite, camera, ...), a client, which can
46 receive, decode and display MPEG 1 and MPEG 2 streams and, if necessary,
47 a channel server which tells automatically to the client the parameters
48 needed to receive the stream.
52 DVD --->- Unicast/Broadcast/Multicast
54 File --->-- -------- / \ --------
55 |->-| Server |=====>====| LAN |---->-----| Client |
56 Satellite ->-- | (VLS) | \ / | (VLC) |
57 / -------- --- --------
66 More details about the project can be found on the
67 <htmlurl url="http://www.videolan.org" name="VideoLAN Web site">.
72 <heading>The documentation of the project</heading>
74 There are four main documents :
77 url="http://www.videolan.org/doc/videolan-quickstart/videolan-quickstart.html"
78 name="VideoLAN Quickstart">,
79 <item>the <htmlurl url="http://www.videolan.org/network/doc/videolan-howto.html"
80 name="VideoLAN HOWTO">,
81 <item>the <htmlurl url="http://www.videolan.org/vls/doc/vls-guide.html"
82 name="VideoLAN Server user guide">,
83 <item>this VideoLAN Client Howto.
86 The up-to-date version of these documents can be found on the <htmlurl
87 url="http://www.videolan.org/doc" name="VideoLAN Web Site">.
90 <heading>Translated versions of this document</heading>
92 No translation is currently available.
96 The English version is maintained by Henri Fallon,
97 Johan Bilien, and the VideoLAN team. It can be found at:
98 <htmlurl url="http://www.videolan.org/doc/index.html"
99 name="http://www.videolan.org/doc/index.html">.
104 <heading>Requirements</heading>
106 <heading>Operating system</heading>
108 VLC works under the following systems :
112 <item> Linux (all distributions, including iPAQ Familiar Linux)
113 <item> Windows (all 32bit versions)
115 <item> FreeBSD, NetBSD, OpenBSD, BSD/OS
122 Please note that the Linux, Windows and MacOS X are generally the most
127 <heading>Software requirements</heading>
129 Depending on the outputs and inputs you are using, you may need
130 additionnal libraries. Please see <ref id="modules" name="description">.
133 For playing encrypted DVDs, you will need libdvdcss, which you can found
135 <htmlurl name="http://www.videolan.org/libdvdcss/download.html"
136 url="http://www.videolan.org/libdvdcss/download.html">.
140 <heading>Hardware requirements</heading>
142 The hardware power needed depends a lot of the type of stream.
143 For reading a DVD, a CPU working at around 450 MHz is required.
146 VLC can benefits from hardware acceleration from modern video cards
147 for YUV transformation and window rescaling. it also uses MMX, MMX EXT,
148 SSE, 3Dnow! optimizations if available.
155 <heading>Disclaimer</heading>
157 This documentation is given "as is", and any comment and improvement
162 In this HOWTO, we consider you already have a little knowledge about
163 Linux, and you know how to use a DVD. If not, good howtos can be
164 found on the Linux Documentation Projet.
169 <heading>Legal</heading>
171 Copyright (©) 2001 by the VideoLAN project. This document may be
172 distributed only subject to the terms and conditions set forth in
173 <htmlurl url="http://metalab.unc.edu/LDP/LDP-COPYRIGHT.html"
174 name="the LDP license">.
180 <heading>Quick start</heading>
182 <p> This section will help you get, install and use vlc without giving you
187 <heading>Get and install vlc from binary packages</heading>
189 The first thing to do is to get an archive, on our web site
190 <htmlurl url="http://www.videolan.org/download.html" name="http://www.videolan.org/download.html">
194 <heading>Which package to chose ?</heading>
196 There are different packages because vlc has "plugins" which provide
197 features but also enlarge the executable and require external libraries.
200 SDL is a lib which allows you to have an accelerated video output.
201 You will need libsdl > 1.1.6
204 If you're using the enlightened sound daemon, you may want to try
208 Generally, when you don't know what a module name is, you don't
214 <heading>Debian package</heading>
218 dpkg -i vlc-x.x.x.deb
222 Depending on the package you have downloaded, you may have dependency
223 problems. You have to solve them, by installing the required libraries.
228 <heading>RPM package</heading>
230 Install vlc just as you would install any rpm package :
236 You may have to install external libraries to meet dependencies, depending on
237 the package you downloaded (gnome, gtk, esd, ...).
242 <heading>BeOS users</heading>
244 Double-click on the archive. It should open your favorite archive extracter.
245 You can then execute the vlc from there, or extract the archive to a
246 directory and run it from there.
251 <heading>MacOS X users</heading>
257 <heading>Windows users</heading>
259 Launch the installer by double-clicking on it, and follow the installation
260 instructions. Please note that in most cases you will need administrator
261 rights to install it under Windows NT, 2000 and XP
267 <heading>Get libdvdcss</heading>
269 In order to read CSSsrambled DVDs, you will need libdvdcss.
271 packages for your distribution here : <htmlurl
272 name="http://www.videolan.org/libdvdcss/download.html"
273 url="http://www.videolan.org/libdvdcss/download.html">
276 For Windows users, libdvdcss is statically linked in the
277 Windows binary, so you don't have to install it.
282 <heading>Use the vlc for DVD reading</heading>
284 Launch the application simply by typing vlc in a terminal (or by
285 double-clicking on its icon in a graphical shell). You should see
286 the graphical interface appear.
290 For reading a DVD (or a VCD), click on the "Disc" button. The new window
291 you must then enter the path to your DVD or VCD drive :
294 <heading>Linux users</heading>
296 Usually, you dvd device is /dev/hd? (if you have an ide drive).
297 For instance, if you DVD player is master on the second IDE device,
301 It is very useful to create a symlink to this file, called /dev/dvd.
302 To do this, as root, type (if your dvd device is /dev/hdc for example) :
304 ln -s /dev/hdc /dev/dvd
306 Also make sure you have read AND write permission to the device
307 (otherwise dvd decryption won't work).
311 <heading>Windows users</heading>
313 The path to your DVD drive usually is D:\ or E:\. You may have a look
314 in "My Computer" and look to which letter your DVD drive is assigned.
318 <heading>BeOS users</heading>
320 Under BeOS, the dvd device looks like
321 "/dev/disk/ide/atapi/1/slave/0/raw" for example, if your dvd device is
322 slave on your first (not sure) ide device.
326 <heading>Other OS</heading>
332 <heading>Use the vlc for network streaming</heading>
334 This is the vlc original usage.
338 Launch the vlc as you would have for DVD reading. Then click on the
342 <heading>If using a VideoLAN Channel Server</heading>
344 The only thing you have to do is to check the "Channel server" box
345 and to enter the IP address and port
347 server. Ask your administrator if you don't have it. Then click on OK.
350 You will see a new "Channel" field in the interface. You may now
351 enter the selected channel and click on OK. After a few seconds,
352 if a program is being sent in this channel, you should see the program
356 If nothing appears and you are sure that a program is streamed in
357 this channel, you may try once again, because a problem of communication
358 with the channel server could have occured (in you launched vlc from
359 a terminal, you should see "Network error: no answer from vlcs").
363 <heading>Without VideoLAN Channel Server</heading>
365 Simply choose clicking on the network button, then on ok should be
366 sufficient in most cases.
369 After clicking on OK, and if a program is being sent, you should see
370 a window open with your program.
376 <heading>The graphical interface</heading>
378 Please note that the gnome, gtk and win32 interfaces are currently the most
379 advanced. The following descriptions refer to them.
382 <heading>Opening a stream</heading>
384 For opening streams through the graphical interface, click on either
385 "File" for opening a file stored on your hard drive, "Disc" for
386 opening a DVD or a VCD, "Network" for reading a stream from a vls
387 or through http input, or "Satellite" for reading directly
388 from a satellite card.
391 <heading>Basic stream control</heading>
393 You have at your disposal all the classical control of a video player.
394 For example when playing local streams, you can do pauses, speed up or
395 slow down the stream ... Just use the corresponding buttons.
398 <heading>DVD and VCD navigation</heading>
400 When reading a DVD or a VCD, you can change chapter and title either
402 right-click menu or by using the dedicated bar that appears when reading
408 <heading>Programs, audio and subtitles</heading>
410 When reading a multiprogram stream, you can change the current program
411 by selecting it in the "View/Programs" submenu, or using the "right click"
412 menu from the video output window.
415 In DVDs, if different angles are availables, they will be treated as
419 At any time you can change the audio/subtitles channel using either the
420 "setting" menu from the interface or using the "right click" menu from
421 the video output window.
424 <heading>Preferences window</heading>
426 By choosing "Preferences" in the "Settings" menu, you will open
427 the preferences window. This window is generated dynamically according
428 to the modules that were compiled.
431 In every tab, you may click on "Save" to store your settings in your
432 ~/.videolan/vlcrc file.
435 <heading>Interface tab</heading>
437 In that tab, you can select which interface you would like to use on next
438 start. Click on the choosen interface, click on "Select" then on "Save".
442 <heading>Audio tab</heading>
444 In this tab, you can select the audio output you would like to use on
445 next start. You may also specify some other settings such as the output
446 level, the audio frequency, ...
450 <heading>Video tab</heading>
452 In this tab, you can select which video output will be used on next start,
453 and add a video filter module. You may also specify some video settings,
454 such as the window size or if you would like fullscreen display.
458 <heading>Input tab</heading>
460 In this tab, you can enter the input method with options (for example
461 <tt>udp:@239.255.255.42</tt>) that will be used on next start. You can
462 also add some settings, such as the channel server address ...
466 <heading>Decoders tab</heading>
468 In this tab, you can select which decoder you want to use for MPEG audio
473 <heading>CPU tab</heading>
475 In this tab, you may disable the use of some CPU extensions such as
480 <heading>Playlist tab</heading>
482 In this tab, you can select some playlist options, such as looping the
487 <heading>Miscellanous tab</heading>
489 In this tab, you can select which memcpy version you want to use. Some
490 of them uses MMX 3Dnow! extensions.
496 <heading>Command line options</heading>
498 Many options are only available through command line. They are detailled here.
501 <heading>Opening streams</heading>
503 The following commands start vlc and add a first element to the playlist.
506 <heading>Opening a file</heading>
508 Simply start vlc with <tt>vlc my_file.mpg</tt>.
511 You may tell vlc what input to use, for example add <tt>--input ts</tt>
512 when playing a ts MPEG, although vlc should be able to recognize the type
517 <heading>Opening a DVD or VCD</heading>
519 Simply start vlc with <tt>vlc dvd:DVDDRIVE</tt> or <tt> vlc vcd:CDROMDRIVE
520 </tt>, where DVDDRIVE/CDROMDRIVE is the complete
521 path to your dvd/cdrom drive.
524 You may add <tt>-t X -T Y</tt> to start directly from the Xth chapter, Yth
529 <heading>Start a network stream</heading>
531 To receive an UDP stream (being sent from a VLS), start vlc with
532 <tt> vlc udpstream:[@<bind address>[:<server port>]] </tt>.
535 Please note that bind address refers to the destination address, for
536 example your broadcast address. If the stream is being broadcasted,
537 <verb> vlc udpstream:</verb> should be sufficient. If the stream
538 is multicasted, you must specify the multicast address, for example
539 <verb> vlc udpstream:@239.255.255.42 </verb>
541 To receive a http stream, start vlc with <tt>vlc <your URL></tt>.
549 <heading>Modules selection</heading>
551 The vlc tries to select the most appropriate interface, input and output
552 modules, among the ones available on the system, according to
553 the stream he is given to read. However, you may wish to force
554 the use of a specific module with the following options:
556 <p> <verb>--intf <interface module></verb>
557 allows you to select the interface module </p>
559 <p> <verb>--input <input module></verb>
560 allows you to select the input module.</p>
562 <p> <verb>--vout <video output module></verb>
563 allows you to select the video output.</p>
565 <p> <verb>--aout <audio output module></verb>
566 allows you to select the audio output.</p>
568 <p> <verb>--filter <video filter module></verb>
569 allows you to add a video filter module.</p>
571 <p> <verb>--mpeg_adec <MPEG audio decoder module></verb>
572 allows you to select the audio MPEG decoder.</p>
574 <p> <verb>--ac3_adec <AC3 audio decoder module></verb>
575 allows you to select the audio AC3 decoder.</p>
579 <heading>Other options</heading>
581 <heading>Help options:</heading>
583 <p> <verb>--help</verb>
584 gives you all the available options.</p>
585 <p> <verb>--longhelp</verb>
586 gives you a more detailled version of the available options.</p>
587 <p> <verb>--version</verb>
588 gives you information about the current version.</p>
589 <p> <verb>--list</verb>
590 gives you the list of all available plugins.</p>
591 <p> <verb>--warning X or -vvvv (X times)</verb>
592 set the level of warning messages.</p>
593 <p> <verb>--stat</verb>
594 gives statistic outputs.</p>
598 <heading>Audio options:</heading>
601 <p> <verb>--noaudio</verb>
602 disables the audio output</p>
603 <p> <verb>--mono</verb>
604 forces the vlc to treat the stream in mono audio.</p>
605 <p> <verb>--volume <integer></verb>
606 set the level of audio output.</p>
607 <p> <verb>--rate <integer></verb>
608 set the audio output frequency (Hz)</p>
609 <p> <verb>--desync <integer></verb>
610 compensates desynchronization of audio (ms)</p>
614 <heading>Video options:</heading>
616 <p> <verb>--novideo</verb>
617 disables the video output</p>
618 <p> <verb>--width <integer></verb>
619 <verb>--height <integer></verb>
620 set the video window dimensions.</p>
621 <p> <verb>--grayscale</verb>
622 turns video output into grayscale mode.</p>
623 <p> <verb>--fullscreen</verb>
624 set fullscreen video.</p>
625 <p> <verb>--nooverlay</verb>
626 disables hardware acceleration for the video output</p>
627 <p> <verb>--spumargin <integer></verb>
628 force subtitles position.</p>
632 <heading>Input options:</heading>
635 <p> <verb>--network-channel</verb>
636 Start with channel server enabled.</p>
637 <p> <verb>--channel_server <string></verb>
638 Specify the channel server address.</p>
639 <p> <verb>--channel_port <integer></verb>
640 Specify the channel server port.</p>
641 <p> <verb>--iface <string></verb>
642 Select the network interface to use.</p>
643 <p> <verb>--input_program <integer></verb>
644 Select the program to use (for streams with
645 several programs, as those coming from satellite).</p>
646 <p> <verb>--input_audio <integer></verb>
647 Select the audio channel to use.</p>
648 <p> <verb>--input_subtitle <integer></verb>
649 Select the subtitle.</p>
650 <p> <verb>--input_channel <integer></verb>
651 Select the channel number.</p>
652 <p> <verb>--dvd_device <string></verb>
653 Specify the default dvd device.</p>
654 <p> <verb>--vcd_device <string></verb>
655 Specify the default vcd device.</p>
656 <p> <verb>--ipv4</verb>
658 <p> <verb>--ipv6</verb>
663 <heading>CPU options</heading>
664 <p> <verb>--nommx</verb>
665 disable the use of mmx CPU extensions.</p>
666 <p> <verb>--no3dn</verb>
667 disable the use of 3D Now! CPU extensions.</p>
668 <p> <verb>--nommxext</verb>
669 disable the use of mmx ext CPU extensions.</p>
670 <p> <verb>--noaltivec</verb>
671 disable the use of AltiVec CPU extensions.</p>
682 <heading>Building the vlc from sources</heading>
684 You can choose either to take the latest release, or a CVS source. Note that
685 CVS snapshots may be broken, although we do our best to prevent this from
689 From here, you have to be a little experienced, even more if you want to use
693 <heading>Getting an archive</heading>
695 You have guessed it, the first thing to do is to get the source.
696 Until there, everyone should understand :)
699 <heading>Web site</heading>
701 Source packages can be found in the "tarballs" section of the download page :
702 <htmlurl url="http://www.videolan.org/download.html" name="http://www.videolan.org/dowload.html">.
705 CVS snapshots are available from the address :
706 <htmlurl url="http://www.videolan.org/packages/snapshots/"
707 name="http://www.videolan.org/packages/snapshots/">.
710 Then untar the archive :
712 tar xzf vlc-x-x-x.tar.gz
717 <heading>Directly from CVS</heading>
719 Firs log in as suer anonymous with an empty password :
721 cvs -d :pserver:anonymous@anoncvs.videolan.org:/var/cvs/videolan login
723 Then retrieve the repository :
725 cvs -d :pserver:anonymous@anoncvs.videolan.org:/var/cvs/videolan -z3 checkout vlc
730 <heading>libdvdcss</heading>
732 To compile vlc with dvd support, you need to get and install libdvdcss.
735 It is available for download here :
736 <htmlurl url="http://www.videolan.org/libdvdcss/download.html"
737 name="http://www.videolan.org/libdvdcss/download.html">
739 Decompress the tarball in a directory of your choice and build it :
741 tar -xvzf libdvdcss-x.x.x.tar.gz
745 [as root] make install
748 You can also find binaries packages for many distributions.
752 <heading>Building the program</heading>
753 <p><label id="compile">
754 Go into the vlc directory and run the configure script :
758 If you want to enable options, you may add "--enable-option"
759 to the previous line.
760 For example, to build with the xvideo extension, and alsa support,
763 ./configure --enable-xvideo --enable-alsa
765 To get the list of the available options, and know if they are
773 Also have a look on the <ref id="modules" name="following modules
777 A very typical installation, on a XFree 4.1 system, recent video card, with
780 ./configure --enable-esd --enable-gnome
785 <heading>Plugins, builtins ...</heading>
787 The configure script should create a Makefile.opts file, which you can edit and modify.
788 Indeed you can chose to have features (as esd support, for example) built as plugins
789 or inside the program.
792 If you build a feature as a plugin, it can lead to a little loss of performance.
793 It you build it inside the code, it'll enlarge a bit the size of the executable.
796 When you're done with Makefile.opts (which also works if you leave it
802 It should compile without any error. If there are, please check you
803 have the required libraries
804 installed on your system, as the configure script can't check them all.
807 When you're done with it, as root, type :
811 if you wish to have vlc fully installed on your system. If you prefer
813 current directory, you may skip the "make install". You'll then have
815 directory and type "./vlc" instead of just typing vlc.
821 <heading>Modules description</heading>
824 Here is a description of nearly all the available modules for the
825 vlc. If you wish to compile one which is stated disabled by default,
826 you have to launch the configure script with
827 <verb> ./configure --enable-module_name </verb>. See <ref
828 name="compilation instructions" id="compile">.
830 <heading>Video outputs</heading>
832 <heading>x11</heading>
833 <p>default :enabled </p>
835 This is the basic x11 video output. It only requires a
836 working X11 server. You will need xlibs headers to compile it
837 (xlibs-dev package on Debian systems).
842 <heading>xvideo</heading>
843 <p>default : enabled</p>
845 It requires an xvideo compliant graphic card (it is the case for
846 nearly all the modern card). It uses hardware acceleration for
847 yuv transformation and for rescaling.
852 <heading>sdl</heading>
853 <p>default : enabled</p>
855 This video output uses sdl libraries. You need at least version 1.1.6 of
859 You may indicate the path to the sdl-config program with the
860 <verb> --with-sdl-config-path=PATH </verb> option given to the <verb>
861 configure</verb> script.
866 <heading>directx</heading>
867 <p>default: enabled on win32</p>
869 This video output uses Microsoft Direct X libraries. It is recommended
873 You may indicate the path to directx libraries and headers with
874 the <verb>--with-directx=PATH</verb> option.
878 <heading>fb</heading>
879 <p>default: enabled on Linux</p>
881 This is the frame buffer video output. It requires that your kernel
882 was compiled with frame buffer support.
887 <heading>glide</heading>
888 <p>default: disabled</p>
890 This video output uses Glide libraries (hardware acceleration for
894 You may indicate the path to the library with the
895 <verb>--with-glide=PATH</verb> compilation option.
900 <heading>mga</heading>
901 <p>default: disabled</p>
903 It provides hardware acceleration for Matrox cards on Linux.
908 <heading>ggi</heading>
909 <p>default: disabled</p>
913 <heading>aa</heading>
914 <p>default: disabled</p>
916 This video output uses the aalib library to display video
917 through ASCII art. It requires aalib headers (aalib1-dev under Debian)
923 <heading>Video filters modules</heading>
925 <heading>deinterlace</heading>
926 <p>default: enabled</p>
928 This filter deinterlaces video. It is usefull with streams coming
929 from a satellite broadcast.
934 <heading>wall</heading>
935 <p>default: enabled</p>
937 This filter allows you to have the video cut in pieces in several
938 windows, which you can order as you wish. It can be used to generate
939 image walls with several sources. Start it with
940 <verb> --filter wall:XxY</verb> in order to have the video cut in X rows
945 <heading>distort</heading>
946 <p>default: enable</p>
948 This filter adds a distortion effect to the video. Who said it
954 <heading>transform</heading>
955 <p>default: enable</p>
957 This filter rotates the video window of 90 degrees.
962 <heading>invert</heading>
963 <p>default: enabled</p>
965 This filter inverses colors.
970 <heading>Sound outputs</heading>
972 <heading>dsp</heading>
973 <p>default: enabled on Linux</p>
975 This is the Linux /dev/dsp output. It requires that your kernel
976 was compiled with support for your sound card.
981 <heading>alsa</heading>
982 <p>default: disabled</p>
984 This is the sound output for Advanced Linux Sound Architecture.
985 It requires that you installed the alsa drivers and libraries.
990 <heading>esd</heading>
991 <p>default: disabled</p>
993 This sound output has Enlightened Sound Daemon support
994 (usually used with Gnome).
995 You must have the daemon and its libraries installed.
999 <heading>arts</heading>
1000 <p>default: disabled</p>
1002 This sound output has aRts (KDE's sound server) support.
1003 You must have the daemon and its libraries installed.
1008 <heading>waveout</heading>
1009 <p>default: enabled on win32</p>
1011 This is the Wave output, which is used by the win32 port.
1017 <heading>Input modules</heading>
1019 <heading>dvd</heading>
1020 <p>default: enabled</p>
1022 This is the DVD input module. It will need libdvdcss, which can
1023 be found <htmlurl url="http://www.videolan.org/libdvdcss/"
1024 name="http://www.videolan.org/libdvdcss/">.
1029 <heading>dvdread</heading>
1030 <p>default: disabled</p>
1032 This is an alternative to the previous one, it uses libdvdread
1033 (which also needs libdvdcss).
1037 <heading>vcd</heading>
1038 <p>default: enabled</p>
1040 This is the VideoCD input.
1044 <heading>http</heading>
1045 <p>default: enabled</p>
1047 This is the http input. You can use it for Video On Demand.
1051 <heading>satellite</heading>
1052 <p>default: disabled</p>
1054 This is an input module that allows to read directly from a
1055 Hauppauge WinTV Nova card under Linux. It requires drivers 0.9.4
1057 <htmlurl url="http://www.linuxtv.org/" name="linuxtv.org">.
1063 <heading>Interface modules</heading>
1065 <heading>gtk</heading>
1066 <p>default: enabled</p>
1068 This is the GTK+ interface. It needs gtk libraries (libgtk1.2 package
1069 on Debian) and headers files if you are compiling it (libgtk1.2-dev
1070 package on Debian). Note that it can be used under Windows.
1074 <heading>gnome</heading>
1075 <p>default: disabled</p>
1077 This is the Gnome interface. It needs gnome libraries (libgnome32 under
1078 Debian) and headers (libgnome-dev) if you wish to compile it.
1082 <heading>intfwin</heading>
1083 <p>default: enabled on win32</p>
1085 This is the Windows native interface. It requires Borland C++ builder
1086 to compile. You may use <verb>--with-bc-builder=PATH</verb> option
1087 to specify the path to this application.
1092 <heading>qt</heading>
1093 <p>default: disabled</p>
1095 This is the QT libraries interface module. You will need the libraries
1096 (libqt2 package on Debian) and headers (libqt-dev) if you wish to
1101 <heading>kde</heading>
1102 <p>default: disabled</p>
1104 This is the KDE interface module. You will need the libraries
1105 (kdelib package on Debian) and headers (kde-devel) if you wish to
1111 <heading>rc</heading>
1112 <p>default: enable</p>
1114 This is the Remote Control interface module. With this one, vlc
1115 is controled by sending him commands, such as play, stop, ... so
1116 that you may control vlc through a script.
1121 <heading>ncurses</heading>
1122 <p>default: disabled</p>
1124 This is a text interface, using ncurses library. You will need
1125 ncurses headers if you want to compile it (libncurses5-dev on Debian).
1129 <heading>lirc</heading>
1130 <p>default: disabled</p>
1132 This interface module allows you to control vlc through a remote.
1133 A lircrc example is provided to help you configure it to your remote
1134 (see doc/lirc/example.lircrc).
1139 <heading>OS support modules</heading>
1140 <p> The following modules add support or different OSs. </p>
1142 <heading>macosx</heading>
1143 <p>default: enabled on MacOS X</p>
1145 This is the MacOS X support module, including a native interface.
1150 <heading>qnx</heading>
1151 <p>default: enabled on qnx</p>
1153 This is the QNX RTOS support module.
1159 <heading>Specific use of the vlc</heading>
1161 <heading>Use the vlc as a viever and decoder for the Hauppauge WinTV
1164 <heading>What is required ?</heading>
1166 At the present time, the satellite input only works under Linux.
1167 It requires that drivers version 0.9.4 of the card, drivers
1168 that are being developped by the <htmlurl name="linuxtv.org"
1169 url="http://www.linuxtv.org/">.
1173 <heading>Building the vlc with satellite support</heading>
1175 Get the sources, either from our last .tar.gz release,
1176 or best from the cvs (see <ref name="cvs instructions"
1180 Move to the vlc directory, then launch
1182 ./configure --enable-satellite
1184 You may add other compilation options, see <ref
1185 name="compilation instructions" id="compile">.
1186 Then launch the compilation with
1190 You may install it with (as root)
1194 or run it from the current directory.
1198 <heading>Running it from the command line</heading>
1202 vlc satellite:<frequency(Hz)>,<polarization(0 for V,
1204 >FEC (1 for 1/2, 2 for 2/3 ...)>,<symbol rate (kbytes/sec)>
1206 You then have to select your program, either with the command line option
1208 --input_program <program_number (also called service ID)>
1210 or by choosing it in the view/programs menu.
1213 <heading>Running it from the GTK/Gnome interface</heading>
1215 Click on the "Sat" icon. In the opening box, you may enter
1216 your transponder settings, then click on "Ok".
1219 After a few seconds, the word satellite should appear under the command
1220 buttons. You may now choose your program from the View/Programs menu.
1225 <heading>Use the vlc to create image walls.</heading>
1227 The idea is to use several video sources, each one displaying a part
1228 of the whole image, to get a bigger result.
1231 Vlc and the VideoLAN solution can provide a good way to create
1232 such displays : a vls broadcasts a stream in several vlc each
1233 display a part of image.
1236 For this, you should use the wall filter : start vlc with
1238 vlc udp: --filter wall:<number of rows>x<number of columns>
1239 :<number of the part to diplay>
1246 <heading>Get more help</heading>
1248 First of all, it something seems to go wrong, read and try to
1249 understand the error messages. You can have detailed messages by
1250 choosing messages in the view menu, in GTK, Gnome and Win32 interfaces.
1253 There is a FAQ page on our website :
1254 <htmlurl url="http://www.videolan.org/doc/index.html" name="http://www.videolan.org/doc/index.html">.
1255 If you think one question should be in the FAQ, please contact
1256 <htmlurl url="mailto:videolan@videolan.org" name="videolan@videolan.org">
1259 Finally, there's a users mailing list (English speaking). To subscribe, send a mail to
1260 <htmlurl url="mailto:listar@videlan.org" name="listar@videlan.org"> containing
1261 "subscribe vlc" as message body.
1264 </article></linuxdoc>