Commit 49a7d5c1 authored by Johan Bilien's avatar Johan Bilien
Browse files

* big update of Henri's howto

parent 84821085
......@@ -2,8 +2,8 @@
<linuxdoc><article>
<titlepag>
<title>VLC HOWTO</title>
<author>by the Videolan Team<tt><htmlurl url="mailto:videolan-faq@videlan.org" name="videolan-faq@videlan.org"></tt></author>
<date>v0.0.4, 12 may 2001</date>
<author>by the Videolan Team<tt><htmlurl url="mailto:videolan@videlan.org" name="videolan@videlan.org"></tt></author>
<date>v0.0.9, 16 april 2002</date>
<abstract>
This document describes how to use the vlc (VideoLAN client) to read DVDs and mpeg files and DVDs.
......@@ -21,7 +21,8 @@
VideoLAN is a project of sudents of the École Centrale Paris which aims
to broadcast video on the campus, and provide the students with a MPEG2
software-only decoder. VideoLAN is an OpenSource project which will thus
allow anyone to watch DVD movies under Linux, BeOS, MacOS and most Unix
allow anyone to watch DVD movies under Linux, BeOS, MacOS X, Windows
and most Unix
systems
</p>
<p>
......@@ -48,7 +49,7 @@
<p>
The English version is maintained by Henri Fallon,
and the VideoLAN team. It can be found at:
Johan Bilien, and the VideoLAN team. It can be found at:
<htmlurl url="http://www.videolan.org/doc.html"
name="http://www.videolan.org/doc.html">.
</p>
......@@ -80,19 +81,19 @@
</sect>
<sect>
<heading>Installing the vlc : the packages</heading>
<p>
This is certainly the simplest way to intsall the vlc on your system,
especially if you're using a packaged OS.
<heading>Quick start</heading>
<p> This section will help you get, install and use vlc without giving you
much details.
</p>
<sect1>
<heading>Get and install vlc from binary packages</heading>
<p>
The first thing to do is to get an archive, on our web site
<htmlurl url="http://www.videolan.org/download.html" name="http://www.videolan.org/download.html">
</p>
<sect1>
<heading>Linux/Unix users</heading>
<sect2>
<heading>Which package to chose ?</heading>
<p>
......@@ -113,22 +114,6 @@
</p>
</sect2>
<sect2>
<heading>Binary archive</heading>
<p>
Untar it typing
<verb>
tar xvzf vlc-x.x.x.tar.gz
</verb>
Go in the vlc directory and get to the 'How to play movies' section If
you wish not to keep vlc in this single directory but install it fully
on your system, you may, as root, type
<verb>
make install
</verb>
</p>
</sect2>
<sect2>
<heading>Debian package</heading>
<p>
......@@ -156,197 +141,442 @@
the package you downloaded (gnome, gtk, esd, ...).
</p>
</sect2>
</sect1>
<sect2>
<heading>BeOS users</heading>
<p>
Double-click on the archive. It should open your favorite archive extracter.
You can then execute the vlc from there, or extract the archive to a
diretory and run it from there.
</p>
</sect2>
<sect2>
<heading>MacOS X users</heading>
<p>
To be completed
</p>
</sect2>
<sect2>
<heading>Windows users</heading>
<p>
Decompress the archive with your favourite extracter in a directory of your
choice.
</p>
</sect2>
</sect1>
<sect1>
<heading>BeOS users</heading>
<heading>Get libdvdcss</heading>
<p>
Double-click on the archive. It should open your favorite archive extracter.
You can then execute the vlc from there, or extract the archive to a
diretory and run it from there.
In order to read CSSsrambled DVDs, you will need libdvdcss.
You can find binary
packages for your distribution here : <htmlurl
name="http://www.videolan.org/libdvdcss/download/index.html"
url="http://www.videolan.org/libdvdcss/download/index.html">
</p>
</sect1>
<sect1>
<heading>MacOS X users</heading>
<heading>Use the vlc for DVD reading</heading>
<p>
To be completed
Launch the application simply by typing vlc in a terminal (or by
double-clicking on its icon in a graphical shell). You should see
the graphical interface appear.
</p>
</sect1>
</sect>
<sect>
<heading>Using the vlc</heading>
<p>
Good job, you have installed the vlc on your system. Now, it's time to
use it. Don't worry, it's not that difficult.
</p>
<sect1>
<heading>Lauching</heading>
<sect2>
<heading>The graphical interface</heading>
<p>
Basically, double clicking on the vlc icon, or typing 'vlc' in a
console should launch a graphical interface On Linux/Unix, you may want
to specify gnome or gtk interface, with the "--intf" option.
</p>
</sect2>
<sect2>
<heading>In case it doesn't work</heading>
<p>
In case this does not work, you'll have to use command line options.
Usually, to play a file, you'll use :
<verb>
vlc [file name]
</verb>
To play a dvd, if your dvd device is "/dev/dvd", you'll type :
<verb>
vlc dvd:/dev/dvd
</verb>
</sect2>
<p>
For reading a DVD (or a VCD), click on the "Disc" button. The new window
you must then enter the path to your DVD or VCD drive :
<sect2>
<heading>Linux users</heading>
<p>
Usually, you dvd device is /dev/hd? (if you have an ide drive).
For instance, if you DVD player is master on the second IDE device,
it will be /dev/hdc.
</p>
<p>
It is very useful to create a symlink to this file, called /dev/dvd.
To do this, as root, type (if your dvd device is /dev/hdc for example) :
<verb>
ln -s /dev/hdc /dev/dvd
</verb>
Also make sure you have read AND write permission to the device
(otherwise dvd decryption won't work).
</p>
</sect2>
<sect2>
<heading>Windows users</heading>
<p>
The path to your DVD drive usually is D: or E:. You may have a look
in "My Computer" and look to which letter your DVD drive is assigned.
</p>
</sect2>
<sect2>
<heading>BeOS users</heading>
<p>
Under BeOS, the dvd device looks like
"/dev/disk/ide/atapi/1/slave/0/raw" for example, if your dvd device is
slave on your first (not sure) ide device.
</p>
</sect2>
<sect2>
<heading>What is this DVD device you keep talking about</heading>
<heading>Other OS</heading>
<p>
This is a file which is "linked" somehow to your dvd device.
To do ...
</p>
<sect3>
<heading>Linux users</heading>
</sect2>
<sect1>
<heading>Use the vlc for network streaming</heading>
<p>
This is the vlc original usage.
</p>
<p>
Launch the vlc as you would have for DVD reading. Then click on the
"Network" button.
</p>
<sect2>
<heading>If using a VideoLAN Channel Server</heading>
<p>
Usually, you dvd device is /dev/hd? (if you have an ide drive).
For instance, if you DVD player is master on the second IDE device,
it will be /dev/hdc.
The only thing you have to do is to check the "Channel server" box
and to enter the IP address and port
of this channel
server. Ask your administrator if you don't have it. Then click on OK.
</p>
<p>
It is very useful to create a symlink to this file, called /dev/dvd.
To do this, as root, type (if your dvd device is /dev/hdc for example) :
<verb>
ln -s /dev/hdc /dev/dvd
</verb>
Also make sure you have read AND write permission to the device
(otherwise dvd decryption won't work).
You will see a new "Channel" field in the interface. You may now
enter the selected channel and click on OK. After a few seconds,
if a program is being sent in this channel, you should see the program
start.
</p>
</sect3>
<sect3>
<heading>BeOS users</heading>
<p>
Under BeOS, the dvd device looks like
"/dev/disk/ide/atapi/1/slave/0/raw" for example, if your dvd device is
slave on your first (not sure) ide device.
If nothing appears and you are sure that a program is broadcasted in
this channel, you may try once again, because a problem of communication
with the channel server could have occured (in you launched vlc from
a terminal, you should see "Network error: no answer from vlcs").
</p>
</sect3>
<sect3>
<heading>Other OS</heading>
</sect2>
<sect2>
<heading>Without VideoLAN Channel Server</heading>
<p>
To do ...
Simply choose clicking on the network button, then on ok should be
sufficient in most cases.
</p>
</sect3>
</sect2>
</sect1>
<p>
After clicking on OK, and if a program is being sent, you should see
a window open with your program.
</p>
</sect2>
</sect>
<sect>
<heading>The graphical interface</heading>
<p>
Please note that the gnome, gtk and win32 interfaces are currently the most
advanced. The following descriptions refer to them.
</p>
<sect1>
<heading>Using the interface</heading>
<heading>Opening a stream</heading>
<p>
By now you should see a beautiful interface, with buttons and menus.
The text should be quite self-explaining : "Open file", "Open Disc", ...
For opening streams through the graphical interface, click on either
"File" for opening a file stored on your hard drive, "Disc" for
opening a DVD or a VCD, "Network" for reading a stream from a vls
or through http input, or "Satellite" for reading directly
from a satellite card.
</p>
<sect1>
<heading>Basic stream control</heading>
<p>
For Dvd's you can choose directly from the "open" box the title & chapter
you want to play.
You have at your disposal all the classical control of a video player.
For example when playing local streams, you can do pauses, speed up or
slow down the stream ... Just use the corresponding buttons.
</p>
</sect1>
<sect1>
<heading>Fullscreen - chapters - features</heading>
<heading>DVD and VCD navigation</heading>
<p>
Some of the following features don't work yet on some platforms.
We're doing our best to get the ports in sync.
When reading a DVD or a VCD, you can change chapter and title either
by using the
right-click menu or by using the dedicated bar that appears when reading
from a disc.
</p>
</sect1>
<sect1>
<heading>Programs, audio and subtitles</heading>
<p>
At any time you can change the audio/subtitles channel using either the
"setting" menu from the interface or using the "right click" menu from
the video output window.
When reading a multiprogram stream, you can change the current program
by selecting it in the "View/Programs" submenu, or using the "right click"
menu from the video output window.
</p>
<p>
To change chapter, you can use the right-click menu or the interface.
Please note that the gnome interface is more advanced than the gtk or
qt ones.
In DVDs, if different angles are availables, they will be treated as
different programs.
</p>
<p>
Using the 'f' key when using SDL or XVideo output toggles the
fullscreen mode. Be warned that "right click" menus are a bit
unstable.
At any time you can change the audio/subtitles channel using either the
"setting" menu from the interface or using the "right click" menu from
the video output window.
</p>
</sect1>
<sect1>
<heading>User help</heading>
<heading>Preferences window</heading>
<p>
First of all, it something seems to go wrong, read and try try to
understand the error messages. If you are a confirmed user, you
may try the "-vvv" option which makes the vlc very verbose.
By choosing "Preferences" in the "Settings" menu, you will open
the preferences window. This window is generated dynamically according
to the modules that were compiled.
</p>
<p>
There is a FAQ page on our website :
<htmlurl url="http://www.videolan.org/doc.html" name="http://www.videolan.org/doc.html">.
If you think one question should be in the FAQ, please contact
<htmlurl url="mailto:videolan-faq@videlan.org" name="videolan-faq@videlan.org">
In every tab, you may click on "Save" to store your settings in your
~/.videolan/vlrrc file.
</p>
<p>
Finally, there's a users mailing list (English speaking). To subscribe, send a mail to
<htmlurl url="mailto:listar@videlan.org" name="listar@videlan.org"> containing
"subscribe vlc" as message body.
</p>
</sect>
<sect2>
<heading>Interface tab</heading>
<p>
In that tab, you can select which interface you would like to use on next
start. Click on the choosen interface, click on "Select" then on "Save".
</p>
</sect2>
<sect2>
<heading>Audio tab</heading>
<p>
In this tab, you can select the audio output you would like to use on
next start. You may also specify some other settings such as the output
level, the audio frequency, ...
</p>
</sect2>
<sect2>
<heading>Video tab</heading>
<p>
In this tab, you can select which video output will be used on next start,
and add a video filter module. You may also specify some video settings,
such as the window size or if you would like fullscreen display.
</p>
</sect2>
<sect2>
<heading>Input tab</heading>
<p>
In this tab, you can enter the input method with options (for example
<tt>udp:@239.255.255.42</tt>) that will be used on next start. You can
also add some settings, such as the channel server address ...
</p>
</sect2>
<sect2>
<heading>Decoders tab</heading>
<p>
In this tab, you can select which decoder you want to use for MPEG audio
and AC3 streams.
</p>
</sect2>
<sect2>
<heading>CPU tab</heading>
<p>
In this tab, you may disable the use of some CPU extensions such as
MMX or SSE.
</p>
</sect2>
<sect2>
<heading>Playlist tab</heading>
<p>
In this tab, you can select some playlist options, such as looping the
playlist.
</p>
</sect2>
<sect2>
<heading>Miscellanous tab</heading>
<p>
In this tab, you can select which memcpy version you want to use. Some
of them uses MMX 3Dnow! extensions.
</p>
</sect2>
</sect1>
</sect>
<sect>
<heading>Advanced use of the vlc</heading>
<heading>Command line options</heading>
<p>
Many options are only available through command line. They are detailled here.
</p>
<sect1>
<heading>Command line options</heading>
<heading>Opening streams</heading>
<p>
The following commands start vlc and add a first element to the playlist.
</p>
<sect2>
<heading>Choosing the video output</heading>
<heading>Opening a file</heading>
<p>
You have to use the "-V" otpion. For example :
<verb>
vlc -V xvideo
</verb>
Simply start vlc with <tt>vlc my_file.mpg</tt>.
</p>
<p>
You may tell vlc what input to use, for example add <tt>--input ts</tt>
when playing a ts MPEG, although vlc should be able to recognize the type
of MPEG.
</p>
</sect2>
<sect2>
<heading>Choosing the audio output</heading>
<heading>Opening a DVD or VCD</heading>
<p>
Use the "-A" option. For example :
<verb>
vlc -A alsa
</verb>
Simply start vlc with <tt>vlc dvd:DVDDRIVE</tt> or <tt> vlc vcd:CDROMDRIVE
</tt>, where DVDDRIVE/CDROMDRIVE is the complete
path to your dvd/cdrom drive.
</p>
<p>
You may add <tt>-t X -T Y</tt> to start directly from the Xth chapter, Yth
title.
</p>
</sect2>
<sect2>
<heading>Specifying a file</heading>
<heading>Start a network stream</heading>
<p>
Simply put the file name at the end of the command line, you won't need then
to click "open" when the interface launches :
<verb>
vlc myfile.mpeg
</verb>
To receive an UDP stream (being sent from a VLS), start vlc with
<tt> vlc udpstream:[@&lt;bind address&gt;[:&lt;server port&gt;]] </tt>.
</p>
<p>
Please note that bind address refers to the destination address, for
example your broadcast address. If the stream is being broadcasted,
<verb> vlc udpstream:</verb> should be sufficient. If the stream
is multicasted, you must specify the multicast address, for example
<verb> vlc udpstream:@239.255.255.42 </verb>
</p>
</sect2>
</sect1>
<sect1>
<heading>Modules selection</heading>
<p>
The vlc tries to select the most appropriate interface, input and output
modules, among the ones available on the system, according to
the stream he is given to read. However, you may wish to force
the use of a specific module with the following options:
<p> <verb>--intf &lt;interface module&gt;</verb>
allows you to select the interface module </p>
<p> <verb>--input &lt;input module&gt;</verb>
allows you to select the input module.</p>
<p> <verb>--vout &lt;video output module&gt;</verb>
allows you to select the video output.</p>
<p> <verb>--aout &lt;audio output module&gt;</verb>
allows you to select the audio output.</p>
<p> <verb>--filter &lt;video filter module&gt;</verb>
allows you to add a video filter module.</p>
<p> <verb>--mpeg_adec &lt;MPEG audio decoder module&gt;</verb>
allows you to select the audio MPEG decoder.</p>
<p> <verb>--ac3_adec &lt;AC3 audio decoder module&gt;</verb>
allows you to select the audio AC3 decoder.</p>
</sect1>
<sect1>
<heading>Other options</heading>
<sect2>
<heading>Help options:</heading>
<p> <verb>--help</verb>
gives you all the available options.</p>
<p> <verb>--longhelp</verb>
gives you a more detailled version of the available options.</p>
<p> <verb>--version</verb>
gives you information about the current version.</p>
<p> <verb>--list</verb>
gives you the list of all available plugins.</p>
<p> <verb>--warning X or -vvvv (X times)</verb>
set the level of warning messages.</p>
<p> <verb>--stat</verb>
gives statistic outputs.</p>
</sect2>
<sect2>
<heading>Specifying the title and chapter where to start</heading>
<p>
Use the "-t" and "-T" to specify title and chapter. For example, to go to the 12th
chapter of the 2nd title, you'll type :
<verb>
vlc -t 2 -T 12
</verb>
</p>
<heading>Audio options:</heading>
<p> <verb>--noaudio</verb>
disables the audio output</p>
<p> <verb>--mono</verb>
forces the vlc to treat the stream in mono audio.</p>
<p> <verb>--volume &lt;integer&gt;</verb>
set the level of audio output.</p>
<p> <verb>--rate &lt;integer&gt;</verb>
set the audio output frequency (Hz)</p>
<p> <verb>--desync &lt;integer&gt;</verb>
compensates desynchronization of audio (ms)</p>
</sect2>
<sect2>
<heading>Video options:</heading>
<p> <verb>--novideo</verb>
disables the video output</p>
<p> <verb>--width &lt;integer&gt;</verb>
<verb>--height &lt;integer&gt;</verb>
set the video window dimensions.</p>
<p> <verb>--grayscale</verb>
turns video output into grayscale mode.</p>
<p> <verb>--fullscreen</verb>
set fullscreen video.</p>
<p> <verb>--nooverlay</verb>
disables hardware acceleration for the video output</p>
<p> <verb>--spumargin &lt;integer&gt;</verb>
force subtitles position.</p>
</sect2>
<sect2>
<heading>Input options:</heading>
<p> <verb>--network-channel</verb>
Start with channel server enabled.</p>
<p> <verb>--channel_server &lt;string&gt;</verb>
Specify the channel server address.</p>
<p> <verb>--channel_port &lt;integer&gt;</verb>
Specify the channel server port.</p>
<p> <verb>--iface &lt;string&gt;</verb>
Select the network interface to use.</p>
<p> <verb>--input_program &lt;integer&gt;</verb>
Select the program to use (for streams with
several programs, as those coming from satellite).</p>
<p> <verb>--input_audio &lt;integer&gt;</verb>
Select the audio channel to use.</p>
<p> <verb>--input_subtitle &lt;integer&gt;</verb>
Select the subtitle.</p>
<p> <verb>--input_channel &lt;integer&gt;</verb>
Select the channel number.</p>
<p> <verb>--dvd_device &lt;string&gt;</verb>
Specify the default dvd device.</p>
<p> <verb>--vcd_device &lt;string&gt;</verb>
Specify the default vcd device.</p>
<p> <verb>--ipv4</verb>
Force IPv4.</p>
<p> <verb>--ipv6</verb>
Force IPv6.</p>
</sect2>
<sect2>
<heading>CPU options</heading>
<p> <verb>--nommx</verb>
disable the use of mmx CPU extensions.</p>
<p> <verb>--no3dn</verb>
disable the use of 3D Now! CPU extensions.</p>
<p> <verb>--nommxext</verb>
disable the use of mmx ext CPU extensions.</p>
<p> <verb>--noaltivec</verb>
disable the use of AltiVec CPU extensions.</p>
</sect2>
</sect1>
</sect>
<sect>