X-Git-Url: http://git.videolan.org/?p=vlc.git;a=blobdiff_plain;f=doc%2Fvlc-howto.sgml;h=7746ead79b254eec1b70c0cb99e77edf824b4a68;hp=a1549e34290e8ce58ae898e8f51f59e1c6e455d7;hb=b7529857e7411546c14d3513b74be4b5b109f4d8;hpb=8f75e45a8c86a5aee081af5b85a9cdfeedc916bf diff --git a/doc/vlc-howto.sgml b/doc/vlc-howto.sgml index a1549e3429..7746ead79b 100644 --- a/doc/vlc-howto.sgml +++ b/doc/vlc-howto.sgml @@ -19,11 +19,11 @@ What is VideoLAN ?

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 + at broadcasting video on the campus, and providing the students with an MPEG-2 software-only decoder. VideoLAN is an OpenSource project which will thus allow anyone to watch DVD movies under Linux, BeOS, MacOS X, Windows - and most Unix - systems + and most UNIX systems. Recent additions allow to read .avi files, + and MPEG-4/DivX-encoded movies.

You may want to look at the port section on our website : @@ -34,20 +34,24 @@ What is the VideoLAN project ?

- VideoLAN is a complete software solution for video streaming, developed - by students at the and contributors from all over the world, under the General - Public License (GPL). It has been designed for streaming MPEG 1 and MPEG - 2 videos on local area networks (LAN), but it can be extended to - metropolitan or wide area networks (MAN, WAN), - thanks to the multicast technology. - The VideoLAN solution includes a server, which can stream video from - various sources (file, DVD, satellite, camera, ...), a client, which can - receive, decode and display MPEG 1 and MPEG 2 streams and, if necessary, - a channel server which tells automatically to the client the parameters - needed to receive the stream. - + VideoLAN is a complete software solution for video streaming, developed + by students at the and contributors from all over the world, under the . It has been designed for streaming MPEG 1 and MPEG 2 videos on + local area networks (LAN), but it can be extended to metropolitan or + wide area networks (MAN, WAN), thanks to the multicast technology. + + The VideoLAN solution includes a server, which can stream video from + various sources (file, DVD, satellite and MPEG 2 encoder), a client, which can + receive, decode and display MPEG 1 and MPEG 2 streams and, if necessary, + a channel server which tells automatically to the client the parameters + needed to receive the stream. + + Here is an illustration of the complete VideoLAN solution : + + DVD --->- Unicast/Broadcast/Multicast \ --- @@ -62,9 +66,10 @@ | Channel Server | | (VLCS) | ---------------- - - More details about the project can be found on the - . + + + More details about the project can be found on the + .

@@ -111,7 +116,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. Linux (all distributions, including iPAQ Familiar Linux) Windows (all 32bit versions) - Mas OS X + Mac OS X FreeBSD, NetBSD, OpenBSD, BSD/OS BeOS QNX RTOS @@ -119,18 +124,18 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

- Please note that the Linux, Windows and MacOS X are generally the most - uptodate versions. + Please note that the Linux, Windows and MacOS X versions are generally the most + up-to-date ones.

Software requirements

Depending on the outputs and inputs you are using, you may need - additionnal libraries. Please see . + additional libraries. Please see .

- For playing encrypted DVDs, you will need libdvdcss, which you can found + For playing encrypted DVDs, you will need libdvdcss, which you can find on this page : . @@ -159,19 +164,28 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

- In this HOWTO, we consider you already have a little knowledge about - Linux, and you know how to use a DVD. If not, good howtos can be - found on the Linux Documentation Projet. + + In this HOWTO, we consider you already have a little knowledge + about Linux, and you know how to use a DVD. If not, good howtos + can be found on the . +

Legal

- Copyright (©) 2001 by the VideoLAN project. This document may be - distributed only subject to the terms and conditions set forth in - . + + Copyright (©) 2002 by the VideoLAN project. + + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version + 1.1 or any later version published by the Free Software Foundation ; + with no Invariant Sections, with no Front-Cover Texts, and with no + Back-Cover Texts. The text of the license can be found on . +

@@ -227,7 +241,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. RPM package

- Install vlc just as you would install any rpm package : + Install vlc just as you would install any RPM package : rpm -i vlc-x.x.x.rpm @@ -248,9 +262,10 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. - MacOS X users + Mac OS X users

- To be completed + Double-click on the archive, and copy the vlc file to your Applications + folder.

@@ -258,7 +273,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

Launch the installer by double-clicking on it, and follow the installation instructions. Please note that in most cases you will need administrator - rights to install it under Windows NT, 2000 and XP + rights to install it under Windows NT, 2000 and XP.

@@ -273,7 +288,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. url="http://www.videolan.org/libdvdcss/download.html">

- For Windows users, libdvdcss is statically linked in the + For Windows, BeOS and Mac OS X users, libdvdcss is statically linked in the Windows binary, so you don't have to install it.

@@ -293,7 +308,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. Linux users

- Usually, you dvd device is /dev/hd? (if you have an ide drive). + Usually, your 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.

@@ -355,14 +370,14 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

If nothing appears and you are sure that a program is streamed 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 + with the channel server could have occurred (if you launched vlc from a terminal, you should see "Network error: no answer from vlcs").

Without VideoLAN Channel Server

- Simply choose clicking on the network button, then on ok should be + Simply clicking on the network button, then on ok should be sufficient in most cases.

@@ -495,7 +510,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. Command line options

- Many options are only available through command line. They are detailled here. + Many options are only available through command line. They are detailed here.

Opening streams @@ -556,9 +571,6 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

--intf <interface module> allows you to select the interface module

-

--input <input module> - allows you to select the input module.

-

--vout <video output module> allows you to select the video output.

@@ -568,10 +580,10 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

--filter <video filter module> allows you to add a video filter module.

-

--mpeg_adec <MPEG audio decoder module> +

--mpeg-adec <MPEG audio decoder module> allows you to select the audio MPEG decoder.

-

--ac3_adec <AC3 audio decoder module> +

--ac3-adec <AC3 audio decoder module> allows you to select the audio AC3 decoder.

@@ -588,9 +600,9 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. gives you information about the current version.

--list gives you the list of all available plugins.

-

--warning X or -vvvv (X times) +

-vvvv (X times) set the level of warning messages.

-

--stat +

--stats gives statistic outputs.

@@ -634,28 +646,28 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

--network-channel Start with channel server enabled.

-

--channel_server <string> +

--channel-server <string> Specify the channel server address.

-

--channel_port <integer> +

--channel-port <integer> Specify the channel server port.

--iface <string> Select the network interface to use.

-

--input_program <integer> +

--input-program <integer> Select the program to use (for streams with several programs, as those coming from satellite).

-

--input_audio <integer> +

--audio-type <integer> Select the audio channel to use.

-

--input_subtitle <integer> +

--subtitle-channel <integer> Select the subtitle.

-

--input_channel <integer> +

--audio_channel <integer> Select the channel number.

-

--dvd_device <string> +

--dvd <string> Specify the default dvd device.

-

--vcd_device <string> +

--vcd <string> Specify the default vcd device.

-

--ipv4 +

-4, --ipv4 Force IPv4.

-

--ipv6 +

-6, --ipv6 Force IPv6.

@@ -716,7 +728,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. Directly from CVS

default: enabled

- This filter deinterlaces video. It is usefull with streams coming + This filter deinterlaces video. It is useful with streams coming from a satellite broadcast.

@@ -1057,6 +1069,14 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">. .

+ + avi +

default: enabled

+

+ This input module allows to read .avi files. +

+
+ @@ -1135,6 +1155,28 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

+ + Codec modules +

The following modules add codec support.

+ + a52 +

default: disabled

+

+ This is a better AC3/A52 decoder than the built-in one, based on + liba52 : + . +

+
+ + ffmpeg +

default: disabled

+

+ This is a free MPEG-4/DivX/OpenDivX codec : + . +

+
+
+ OS support modules

The following modules add support or different OSs.

@@ -1256,7 +1298,7 @@ url="http://www.videolan.org/doc" name="VideoLAN Web Site">.

- Finally, there's a users mailing list (English speaking). To subscribe, send a mail to + Finally, there's a users mailing list (English-speaking). To subscribe, send a mail to containing "subscribe vlc" as message body.