VLC user guide. Henri Fallon Alexis de Lattre Johan Bilien Anil Daoud Mathieu Gautier Clément Stenac - PDF

Description
VLC user guide Henri Fallon Alexis de Lattre Johan Bilien Anil Daoud Mathieu Gautier Clément Stenac VLC user guide by Henri Fallon, Alexis de Lattre, Johan Bilien, Anil Daoud, Mathieu Gautier, and Clément

Please download to get full document.

View again

of 40
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Information
Category:

Film

Publish on:

Views: 58 | Pages: 40

Extension: PDF | Download: 0

Share
Transcript
VLC user guide Henri Fallon Alexis de Lattre Johan Bilien Anil Daoud Mathieu Gautier Clément Stenac VLC user guide by Henri Fallon, Alexis de Lattre, Johan Bilien, Anil Daoud, Mathieu Gautier, and Clément Stenac Copyright 2002, 2003 by the VideoLAN project This document is the complete user guide of VLC. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 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 in the appendix GNU Free Documentation License. Table of Contents 1. Introduction...1 What is the VideoLAN project?...1 How can I use VideoLAN?...2 Command line usage Modules and options for VLC...7 The modules...7 Video outputs...7 Video filters modules...9 Audio outputs...10 Input modules...11 Demuxers...13 Interface modules...14 Codec modules...16 OS support modules...17 Miscellaneous...18 Compilation Options Installing VLC...20 Installing VLC...20 Uninstalling VLC The command line interface...24 Introduction...24 Opening streams...24 Modules selection...25 Stream Output...25 Other Options The Mozilla plugin...31 Install the plugin...31 Build HTML pages that use the plugin...31 A. GNU Free Documentation License...33 PREAMBLE...33 APPLICABILITY AND DEFINITIONS...33 VERBATIM COPYING...34 COPYING IN QUANTITY...34 MODIFICATIONS...35 COMBINING DOCUMENTS...36 COLLECTIONS OF DOCUMENTS...36 AGGREGATION WITH INDEPENDENT WORKS...36 TRANSLATION...36 TERMINATION...37 FUTURE REVISIONS OF THIS LICENSE...37 ADDENDUM: How to use this License for your documents...37 iii Chapter 1. Introduction What is the VideoLAN project? Overview VideoLAN is a complete software solution for video streaming, developed by students of the Ecole Centrale Paris (http://www.ecp.fr) and developers from all over the world, under the GNU General Public License (http://www.gnu.org/copyleft/gpl.html) (GPL). VideoLAN is designed to stream MPEG videos on high bandwidth networks. The VideoLAN solution includes : VLS (VideoLAN Server), which can stream MPEG-1, MPEG-2 and MPEG-4 files, DVDs, digital satellite channels, digital terrestial television channels and live videos on the network in unicast or multicast, VLC (initially VideoLAN Client), which can be used as a server to stream MPEG-1, MPEG-2 and MPEG-4 files, DVDs and live videos on the network in unicast or multicast ; or used as a client to receive, decode and display MPEG streams under multiple operating systems. Here is an illustration of the complete VideoLAN solution : Figure 1-1. Global VideoLAN solution La solution VideoLAN globale More details about the project can be found on the VideoLAN Web site (http://www.videolan.org/). VideoLAN software VLC VLC works on many platforms : Linux, Windows, Mac OS X, BeOS, *BSD, Solaris, Familiar Linux, Yopy/Linupy and QNX. It can read : MPEG-1, MPEG-2 and MPEG-4 / DivX files from a hard disk, a CD-ROM drive,... DVDs and VCDs, from a satellite card (DVB-S), 1 Chapter 1. Introduction MPEG-1, MPEG-2 and MPEG-4 streams from the network sent by VLS or VLC s stream output. VLC can also be used as a server to stream : MPEG-1, MPEG-2 and MPEG-4 / DivX files, DVDs, from an MPEG encoding card, to : one machine (i.e. to one IP address) : this is called unicast, a dynamic group of machines that the clients can join or leave (i.e. to a multicast IP address) : this is called multicast, in IPv4 or IPv6. To get the complete list of VLC s possibilities on each plateform supported, see the VLC features page (http://www.videolan.org/vlc/features.html). Note: VLC doesn t work on Mac OS 9, and will probably never do. VLS VLS can stream : an MPEG-1, MPEG-2 or MPEG-4 files stored on a hard drive or on a CD, a DVD located in a local DVD drive or copied on a hard disk, a satellite card (DVB-S) or a digital terrestial television card (DVB-T), an MPEG encoding card ; to: one machine (i.e. to one IP address) : this is called unicast, a dynamic group of machines that the clients can join or leave (i.e. to a multicast IP address) : this is called multicast, in IPv4 or IPv6. A Pentium 100 MHz with 32 MB of memory should be enough to send one stream on the network. When streaming a lot of videos stored on a hard drive, the actual limitation is not the processor but the hard drive and the network connection. VLS works under Linux and Windows. To get the complete list of VLS s possibilities on each plateform supported, see the streaming features page (http://www.videolan.org/streaming/features.html). Mini-SAP-server You can add a channel information service based on the SAP/SDP standard to the VideoLAN solution. The mini-sap-server sends announces about the multicast programs on the network in IPv4 or IPv6, and VLCs receive these annouces and automatically add the programs announced to their playlist. The mini-sap-server works under Linux and Mac OS X. 2 Chapter 1. Introduction How can I use VideoLAN? Documentation The user documentation of VideoLAN is made up of 4 documents : the VideoLAN Quickstart. This document will give you a quick overview of of VLC, VLC s stream output, the Video On Demand solution and the channel information service system. the VideoLAN HOWTO. This document is the complete guide of the VideoLAN streaming solution. the VLC user guide. This document is the complete guide for VLC. the VLS user guide. This document is the complete guide for VLS. the VideoLAN FAQ. This document contains Frequently Asked Questions about VideoLAN. The latest version of these documents can be found on the documentation page (http://www.videolan.org/doc/). You can also have a look at the VideoLAN Wiki (http://wiki.videolan.org). This is a website that everyone can change. We use it to document everything that is not in the official documentation: the tips and tricks for each O.S., the graphical interfaces, etc... User support If you have problems using VideoLAN, and if you don t find the answer to your problems in the documentation, please look at the online archive of the mailing-lists (http://www.via.ecp.fr/via/ml/videolan/index-en.html). There are two English-speaking mailing-lists for the users : for the questions on VLC, for the questions on VLS, mini-sap-server and the network. If you want to subscribe or unsubscribe to the mailing-lists, please go to the mailing-list page (http://www.videolan.org/support/lists.html). You can also talk with VideoLAN users and developers on IRC : server irc.freenode.net, channel #videolan. If you find a bug, please follow the instructions on the bug reporting page (http://www.videolan.org/support/bug-reporting.html). Command line usage VLC has many different graphical interfaces, that are organized quite differently in order to be in harmony with the guidelines of each operating system supported. Documenting the use of each graphical interface is too long, and some features are only available via the command line interface. Therefore we decided to document only the command line interface, but in many cases it shoud be easy to guess how to use the graphical interface for the same use! VLS has a command line and a telnet interface, but no graphical interface! All the commands that show up in this document should be typed inside a terminal.. 3 Chapter 1. Introduction Open a terminal Windows Click on Start, Run and type : cmd Enter (Windows 2000 / XP), command Enter (Windows 95 / 98 / ME). The terminal appears Le terminal apparait Figure 1-2. Windows terminal Note: Under Windows, you need to be in the directory where the program is installed to run it. Linux / Unix Open a terminal : 4 Chapter 1. Introduction Figure 1-3. Linux X terminal In the documentation, we adopt the following conventions for the Unix commands : commands that should be typed as root have a # prompt : # command_to_be_typed_as_root commands that should be typed as a regular user have a % prompt : % command_to_be_typed_as_regular_user Mac OS X Go to Applications, open the folder Utilities and double-click on Terminal : Figure 1-4. Mac OS X terminal 5 Chapter 1. Introduction Note: Under Mac OS X, you need to be in the directory where the program is installed to run it, and start the command with./. BeOS In the deskbar, go to Application and then Terminal : Figure 1-5. BeOS terminal Note: Under BeOS, you need to be in the directory where the program is installed to run it, and start the command with./. 6 Chapter 2. Modules and options for VLC The modules VLC uses a modular system, which allows to add easily new fonctions and formats. Here is a description of nearly all the VLC modules. A few internal modules won t be explained here. For a complete list of all VLC modules, please have a look at the LIST file in the subdirectory modules of the VLC source tree. If you installed VLC through a binary file, you will get the default modules. If, however, you want to customize VLC to your needs, you will have to compile VLC from sources. If you don t intend to compile VLC and want only the regular functions, reading this part is not very useful. The compilation itself is explained in the next chapter. If you wish to compile a module which is stated disabled by default, you have to launch the configure script with : %./configure --enable-module_name On the other hand, if you would like to disable a module that is enabled by default, you would have to use : %./configure --disable-module_name Each VLC module has its own help and options. To see what options are associated with a module, use : % vlc -p module_name or use the Preferences Panel of your favorite graphical interface. Video outputs Video outputs are the modules that enable the support of some systems to display the video on your screen. x11 For Unix with X11 servers only This is the basic x11 video output. It only requires a working X11 server. You will need xlibs headers to compile it (xlibs-dev package on Debian systems). xvideo For GNU/Linux only It requires an xvideo compliant graphic card (it is the case for nearly all modern cards). It uses hardware acceleration for YUV transformation and rescaling. 7 Chapter 2. Modules and options for VLC sdl This video output uses sdl libraries. You need at least version of this libraries. You may indicate the path to the sdl-config program with the --with-sdl-config-path=path switch, when running the configre script. directx on win32 For Windows only This video output uses Microsoft Direct X libraries. It is recommended for the win32 port. You may indicate the path to directx libraries and headers with the --with-directx=path switch, when running the configure script. wingdi on win32 For Windows only This video output uses GDI. It is designed for users who don t have Direct X, but the perfs are very low. If you have DirectX, do not use it. fb on GNU/Linux For GNU/Linux only This is the frame buffer video output. It requires that your kernel was compiled with frame buffer support. glide This video output uses Glide libraries (hardware acceleration for 3Dfx cards). You may indicate the path to the library with the --with-glide=path configure option. mga For GNU/Linux only This module provides hardware acceleration for Matrox cards under GNU/Linux. ggi 8 Chapter 2. Modules and options for VLC aa This is the ASCII Art Video Output. This video output uses the aalib library to display video through ASCII art. It requires aalib headers (aalib1-dev package under Debian GNU/Linux) to compile. svgalib For GNU/Linux only This is a video output for the SVGAlib library. qte For ipaq only This is a video output for QT Embedded, an ipaq-specifiq graphical library. Video filters modules These modules allow you to perform modifications on the rendered image. deinterlace Always enabled This filter deinterlaces video. It is useful with streams coming from a digital satellite channel or digital terrestial television channels. wall Always enabled This filter allows you to have the video cut in pieces in several windows, which you can order as you wish. It can be used to generate image walls with several sources. distort Always enabled This filter adds a distortion effect to the video. Who said it was useless? :-) transform Always enabled This filter allows to rotate the video in several ways. 9 Chapter 2. Modules and options for VLC invert Always enabled This filter inverses colors. adjust Always enabled This filter allows you to set image contrast, hue, saturation and brightness clone Always enabled Ce filtre vous permet de dupliquer l image. crop Always enabled This filter allows you to crop parts of the image. motionblur Always enabled This filter adds a motion blur effect to the image. Audio outputs These modules allow you to choose the way the sound will be output to your audio system. oss on GNU/Linux For GNU/Linux and Unix only This is the audio output for OSS (Open Sound System) output (/dev/dsp, for example, under Linux). It requires that your kernel was compiled with support for your sound card, or, if you use ALSA (Advanced Linux Sound System), the OSS emulation layer must be active. alsa For GNU/Linux only This is the sound output for ALSA (Advanced Linux Sound Architecture). It only works under Linux, and it requires that you installed the ALSA drivers and libraries. 10 Chapter 2. Modules and options for VLC esd For GNU/Linux & Unix only This sound output has ESD (Enlightened Sound Daemon) support (usually used with Gnome). You must have the daemon and its libraries installed. arts For GNU/Linux & Unix only This sound output has arts (KDE s sound server) support. You must have the daemon and its libraries installed. waveout on win For Windows only This is the Wave output, which is used by the win32 port. coreaudio on Mac OS X For Mac OS X only This audio output uses CoreAudio under Mac OS X sdl This audio output uses SDL. Please refer to the video output. Input modules These modules allow VLC to read its streams from different sources. dvdplay This is the regular DVD input module. It will need libdvdcss for DVD decryption (see the libdvdcss page (http://developers.videolan.org/libdvdcss/)) and libdvdplay for DVD navigation (see the libdvdplay (http://developers.videolan.org/libdvdplay/) page). 11 Chapter 2. Modules and options for VLC dvd This is the old DVD input module. It uses libdvdcss for DVD decryption (see the libdvdcss page (http://developers.videolan.org/libdvdcss/)). dvdread This is an alternative to the previous ones. It uses libdvdread for DVD reading (see the Ogle download page (http://www.dtek.chalmers.se/groups/dvd/downloads.shtml)) and libdvdcss for DVD decryption (see the libdvdcss page (http://developers.videolan.org/libdvdcss/)). vcd This is the VideoCD input. cdda This is the Audio CD input. http,ftp,udp,file,directory,mms Always enabled These are standard input modules. The HTTP input can be used for Video On Demand. satellite This is an input module that allows to read directly from a Hauppauge WinTV Nova card under GNU/Linux. It requires drivers available from linuxtv.org (http://www.linuxtv.org/). v4l For GNU/Linux only This module allows to get Video4Linux streams. dvb For GNU/Linux only 12 Chapter 2. Modules and options for VLC This module allows to read from DVB-S, DVB-T, and DBC-C satellite, digital terrestrial, or cable cards. It uses the Video4Linux 2 API, that is only available in kernel 2.5.X and 2.6.X. pvr For GNU/Linux only This module allows to read from Hauppauge PVR cards. slp This module allows to get the names and addresses for streams announced using the SLP protocol Demuxers In a video stream, the video signal and the audio one are always into containers formats. Demuxers extract the streams from it and pass it to the decoders. For example, an AVI file can contain a MPEG-4 video, or an uncompressed video. AVI is only a storing format, not a compression format. avi Always enabled This module allows you to read.avi files. asf Always enabled This module allows you to read.asf files aac Always enabled This module allows you to read AAC files ogg This module allows you to read.ogg files 13 Chapter 2. Modules and options for VLC rawdv Always enabled This module allows you to read DV files dvbpsi This module allows to demux streams from a satellite card. mp4 Always enabled This module allows you to read.mp4 files mkv This module allows you to read files that use the Matroska free format. ps,ts Always enabled These modules allow you to read MPEG2 Program Stream or Transport Tream files. id3,m3u Always enabled These modules allow you to read M3U, B4S, PLS, and ASX playlists, and ID3 tags. Interface modules These modules allow you to choose the interface or interfaces you want to use (whether graphical or control interfaces). wxwindows The wxwindows interface is a portable interface that is currently working under GNU/Linux and Windows. It is now the best graphical interface available under both Windows and GNU/Linux. skins on win32 This skinnable interface module works under Win32 and X11. You can create your own skins very easily with XML files. 14 Chapter 2. Modules and options for VLC gtk This is the GTK+ interface. It needs gtk libraries and headers files if you are compiling it. Note that it can also be used under Windows. gnome For GNU/Linux only This is the Gnome interface. It needs gnome libraries (libgnome32 package under Debian) and headers (libgnome-dev package under Debian) if you wish to compile it. qt This is the QT interface module. You will need the libraries (libqt2 package on Debian) and headers (libqt-dev package under Debian) if you wish to compile it. kde For GNU/Linux only This is the KDE interface module. You will need the libraries (kdelibs3 package on Debian) and headers (kde-devel package under Debian) if you wish to compile it. rc Always enabled This is the Remote Control interface module. It allows you to control VLC via commands, such as play, stop, etc... or via a script. This interface is text-based, so you should use it when you are in console mode. http Always enabled This module allows you to remote control your VLC via a web browser. You can create custom web pages. ncurses For GNU/Linux only This is a text interface, using ncurses library. You will need ncurses headers if you want to compile it (libncurses5-dev package on Debian). 15 Chapter 2. Modules and options for VLC lirc For GNU/Linux only This interface module allows you to control VLC through a remote. A lircrc example is provided to help you configure it to your remote (see doc/lirc/example.lircrc). opie This is an interface plugin for the Qt Embedded library (ipaq graphical library). gestures Always enabled This module allows you to control VLC via mouse gestures. joystick For GNU/Linux only This module allows you to control VLC via a joystick with many options. Codec modules The following modules add codec (ie, compression formats) support. a52 This decoder uses liba52 (see the liba52 web site (http://liba52.sourceforge.net/). ffmpeg This is a free MPEG-4/DivX/OpenDivX codec : ffmpeg (see the ffmpeg web site (http://ffmpeg.sourceforge.net/)). vorbis This codec allows you to read the Vorbis (audio) encoded files. 16 Chapter 2. Modules and options for VLC xvid This codec allows you to read files encoded with Xvid (see Xvid web site (http://www.xvid.org/)). mad This codec is a very smart MP3 decoder, that only uses integers. This allows its use for CPU which don t handle floating point numbers (on PDA, for example). libmpeg2 This codec allows to read MPEG2 files. faad Faad is an MPEG-4 audio decoder. tarkin tarkin is a new codec (experimental) by the Ogg Project (see the Ogg Vorbis web site (http://www.vorbis.com)). theora theora is a new codec (experimental) by the Ogg Project (see the Ogg Vorbis web site (http://www.vorbis.com)). cinepak This codec decodes the Cinepak format. tremor This is an Ogg/Vorbis codec that only makes integer calculus, whi
Related Search
Similar documents
View more...
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks