Commit 41d11c19 authored by Alexis de Lattre's avatar Alexis de Lattre

ALL : VLC FAQ transformed into VideoLAN FAQ, which is hosted in the CVS

under www.videolan.org/doc/faq/
parent 92993d58
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY dbstyle SYSTEM "/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl" CDATA DSSSL>
]>
<style-sheet>
<style-specification use="docbook">
<style-specification-body>
; Personnalization of James Clark's stylesheet for HTML output
; These parameters overide James Clark's one.
; Change of HTML page for each chapter, not for each "sect1"
(define (chunk-element-list)
(list ))
; "screens" should be in verbatim mode"
(define %shade-verbatim%
#t)
; I want small icons for "notes", "warnings", "caution" & "important"
(define %admon-graphics%
#t)
; Path for the icons
(define %admon-graphics-path%
"../common/")
; Use ID attributes as name for component HTML files
(define %use-id-as-filename%
#t)
; Are sections enumerated ?
(define %section-autolabel%
#t)
</style-specification-body>
</style-specification>
<external-specification id="docbook" document="dbstyle">
</style-sheet>
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY dbstyle SYSTEM
"/usr/share/sgml/docbook/stylesheet/dsssl/modular/print/docbook.dsl" CDATA DSSSL>
]>
<style-sheet>
<style-specification use="docbook">
<style-specification-body>
; Personnalization of James Clark's stylesheet for PS & PDF output
; These parameters overide James Clark's one.
; Magins
(define %left-margin%
3pi)
(define %right-margin%
3pi)
(define %top-margin%
5pi)
(define %bottom-margin%
3.5pi)
(define %header-margin%
2pi)
(define %footer-margin%
2pi)
</style-specification-body>
</style-specification>
<external-specification id="docbook" document="dbstyle">
</style-sheet>
# Makefile for the VideoLAN Documentation
DOC := faq-alone
NAME := FAQ-vlc
# We build HTML, PS, PDF, RTF and TXT for the Web site
all: html ps pdf rtf txt
html:
sgmltools -b onehtml -s ../common/stylesheet-html.dsl $(DOC).sgml
# Delete empty file !
rm -f faq-alone.html
ln -sf faq.html index.html
zip $(NAME)-html.zip *.html
ps:
sgmltools -b ps -s ../common/stylesheet-print-noicones.dsl $(DOC).sgml
mv -f $(DOC).ps $(NAME).ps
zip $(NAME)-ps.zip $(NAME).ps
pdf:
sgmltools -b pdf -s ../common/stylesheet-print-noicones.dsl $(DOC).sgml
mv -f $(DOC).pdf $(NAME).pdf
zip $(NAME)-pdf.zip $(NAME).pdf
rtf:
sgmltools -b rtf -s ../common/stylesheet-print-noicones.dsl $(DOC).sgml
mv -f $(DOC).rtf $(NAME).rtf
zip $(NAME)-rtf.zip $(NAME).rtf
txt:
sgmltools -b txt $(DOC).sgml
mv -f $(DOC).txt $(NAME).txt
clean:
rm -f *.zip *.html *.pdf *.ps *.txt *.rtf
<!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook V4.1//EN'
[
<!ENTITY faq SYSTEM "faq.sgml">
]>
<article id="faq">
<articleinfo>
<title>VLC FAQ</title>
<copyright>
<year>2002, 2003</year>
<holder>the VideoLAN project</holder>
</copyright>
<abstract>
<para>This document is the VideoLAN Client (VLC) Frequently
Asked Questions. For a complete user guide, please have
a look at the VLC User Guide, available on the <ulink
url="http://www.videolan.org/doc/">VideoLAN website</ulink></para>
</abstract>
</articleinfo>
&faq;
</article>
<?xml version="1.0" encoding="ISO-8859-15"?>
<!DOCTYPE article
PUBLIC "-//Norman Walsh//DTD Simplified DocBook XML V4.1.2.4//EN"
"http://nwalsh.com/docbook/simple/4.1.2.4/sdocbook.dtd" [
<!ENTITY faq SYSTEM "faq.xml">
]>
<article>
<articleinfo>
<title>VLC FAQ</title>
<copyright>
<year>2002, 2003</year>
<holder>the VideoLAN project</holder>
</copyright>
<abstract>
<para>This document is the VideoLAN Client (VLC) Frequently
Asked Questions. For a complete user guide, please have
a look at the VLC User Guide, available on the <ulink
url="http://www.videolan.org/doc/">VideoLAN website</ulink></para>
</abstract>
</articleinfo>
&faq;
</article>
<?xml version="1.0" encoding="iso-8859-15"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
<xsl:import href="/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/xhtml/docbook.xsl"/>
<!-- <xsl:param name="qanda.defaultlabel">number</xsl:param> -->
<xsl:param name="generate.id.attributes" select="0"/>
<!-- <xsl:param name="section.autolabel" select="1"/> -->
<xsl:param name="label.from.part" select="1"/>
<!-- <xsl:param name="section.label.includes.component.label" select="1"/> -->
</xsl:stylesheet>
<qandaset><title>VLC FAQ</title>
<qandadiv><title>Using VLC</title>
<qandaentry>
<question><para>How do I read a DVD?</para></question>
<answer><para>Just launch VLC and use the "open disc" command from the graphical
interface. In case of trouble, you may want to use the command line.
For instance, provided your DVD device is <filename>/dev/dvd</filename> :</para>
<screen><prompt>% </prompt><userinput>vlc dvd:/dev/dvd</userinput></screen>
</answer></qandaentry>
<qandaentry>
<question><para>How do I read an encrypted DVD?</para></question>
<answer><para>It is exactly the same as for a normal DVD. You will
need write access to <filename>/dev/dvd</filename>, because of the key
negociation process.
If you compiled your VLC by hand, please bear in mind that you also need
to install libdvdcss. It can be downloaded from the VideoLAN website. It
used to be distributed in the same package as VLC, but now you must install
them seperately.
</para></answer></qandaentry>
<qandaentry>
<question><para>How do I switch to full screen display?</para></question>
<answer><para>Press <keycap>f</keycap> to toggle fullscreen mode. Note
that not all video output devices support full screen.
</para></answer></qandaentry>
<qandaentry>
<question><para>How do I hide the mouse cursor?</para></question>
<answer><para>It should disappear after a few seconds if you stop moving
the mouse.
</para></answer></qandaentry>
<qandaentry>
<question><para>How do I use VLC if I do not want to install Gnome and
all this #@!% *$@&% !@# bloat?</para></question>
<answer><para>You can run:</para>
<screen><prompt>% </prompt><userinput>vlc --intf dummy myfile.mpg</userinput>
</screen>
<para>Most commands are available from the command line, see
<command>vlc --help</command> for more information.</para>
</answer></qandaentry>
<qandaentry>
<question><para>VLC eats my buffer cache, how can I use raw device?</para></question>
<answer><para>If you do not know what is a raw device, do not even read
this answer :-).</para>
<para>There is an experimental support for raw devices in libdvdcss. It
needs that you set up a raw device pointing to your DVD device (under
Linux, use the "raw" utility). Then pass the raw device as second
argument, for instance:</para>
<screen><prompt>% </prompt><userinput>vlc dvd:/dev/dvd@/dev/raw0</userinput></screen>
</answer></qandaentry>
<qandaentry>
<question><para>How do I use VLC as a client for VLS
streaming?</para></question>
<answer><para>First you must set up a VLS stream. Please refer to the
documentation of the program. Then start VLC:</para>
<screen><prompt>% </prompt><userinput>vlc udp:</userinput></screen>
<para>You should not need any option. If you are paranoid and want to control
everything, here is the exact syntax:</para>
<screen><prompt>% </prompt><userinput>vlc udp:[&lt;server&gt;[:&lt;server port&gt;]][@[&lt;bind address&gt;][:&lt;bind port&gt;]]</userinput></screen>
</answer></qandaentry>
<qandaentry>
<question><para>How do I uninstall / reinstall VLC?</para></question>
<answer><para>Why would you want to? ;)</para>
<para>If you are using a source distribution of VLC, for example
a tarball or the CVS, then you have probably used <command>make
install</command> to install the compiled VLC. To remove it just
<command>make uninstall</command>. If you want to install a newer
version than the currently installed one, you should first uninstall
the first one. If you deleted the original source tree, a <command>make
uninstall</command> in the newer tree should still work.</para>
<para>For binary packages, remove old packages first and install the new
ones (normally this should be handled automagically by your sytem).
</para></answer></qandaentry>
<qandaentry>
<question><para>Debian: what should I put in my sources.list for
videolan?</para></question>
<answer>
<para><programlisting>
deb http://www.videolan.org/pub/videolan/debian $(ARCH)/
deb-src http://www.videolan.org/pub/videolan/debian sources/
</programlisting></para>
</answer></qandaentry>
<qandaentry>
<question><para>How can I save my VLC configuration?</para></question>
<answer><para>In the graphical interface, go to <emphasis>Settings /
Preferences</emphasis> and click on <emphasis>Save</emphasis>.
</para></answer></qandaentry>
<qandaentry>
<question><para>Where does VLC store its config file?</para></question>
<answer><para>Currently, a config file is created on a per user basis
(there is no global configuration file). If you modify the available
options in VLC and save the new configuration, then a configuration file
will be created in your user directory. The precise location of this
file depends on the Operating System you are running: </para>
<itemizedlist>
<listitem><para>Unices (Linux, etc.):
<filename>$(HOME)/.vlc/vlcrc</filename></para></listitem>
<listitem><para>Mac OS X: <filename>/Library/Preferences/VLC</filename>
</para></listitem>
<listitem><para>Windows: <filename>Application Data\vlc\vlcrc</filename>
(Application Data is usually in <filename>C:\Documents and
Settings\your_name</filename></para></listitem>
<listitem><para>BeOS:
<filename>config/settings/vlcrc</filename></listitem>
</itemizedlist>
</answer></qandaentry>
<qandaentry>
<question><para>How do I join an IPv6 multicast stream?</para></question>
<answer><para>You often have to indicate the interface name on your system, for instance :
udp:@[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210%eth0]:1234
</para></answer></qandaentry>
</qandadiv>
<qandadiv><title>Troubleshooting</title>
<qandaentry>
<question><para>VLC has a strange behavior...</para></question>
<answer><para>The first thing to do is to delete VLC's configuration
file :</para>
<itemizedlist>
<listitem><para>under unices, remove the file
<filename>~/.vlc/vlcrc</filename>;</para></listitem>
<listitem><para>under Windows, remove the file
<filename>vlcrc</filename> in the <filename>vlc</filename> subfolder of
your <filename>Application Data</filename> directory.</para></listitem>
</itemizedlist>
<para>Then restart VLC ; if it doesn't get any better, read the
following questions !</para>
</answer></qandaentry>
<qandaentry>
<question><para>When I start VLC, I do not see any interface
coming</para></question>
<answer><para>If you installed a binary package, make sure you also
installed an interface package such as <emphasis>vlc-gtk</emphasis>
or <emphasis>vlc-qt</emphasis>. If you installed from source, make
sure the development package for gtk 1.2 or qt is correctly installed
(often <emphasis>gtk-dev</emphasis>, <emphasis>gtk-devel</emphasis> or
<emphasis>libgtk1.2-dev</emphasis>) and recompile.
</para></answer></qandaentry>
<qandaentry>
<question><para>Clicking on "<emphasis>disc</emphasis>" in the interface
does not do anything</para></question>
<answer><para>Wait a few seconds. Key discovering can take much time on
some discs. If it still does not work, you can have a more verbose
output using <command>vlc -vvvvv</command>. Here are a few things to
check for:</para>
<itemizedlist>
<listitem><para>Did you install the libdvdcss package?</para></listitem>
<listitem><para>Do you have write access to your DVD device?
For instance, under Unix, <command>chmod 666 /dev/hdc</command>
</para></listitem>
<listitem><para>Under Unix, does your kernel log contain line about your
DVD device?</para></listitem>
<listitem><para>Under Unix, do you have a link from <filename>/dev/dvd</filename> to your real DVD device? For instance:</para>
<screen><prompt># </prompt><userinput>cd /dev && ln -s hdc dvd</userinput></screen></listitem>
</itemizedlist>
</answer></qandaentry>
<qandaentry>
<question><para>The video runs but the picture is distorted</para></question>
<answer><para>There is probably a problem with the output layer. There
are several ways of troubleshooting it. First, try with another output
plugin, for instance:</para>
<screen>
<prompt>% </prompt><userinput>vlc --vout sdl</userinput>
<prompt>% </prompt><userinput>vlc --vout x11</userinput>
</screen>
<para>Second, change your screen depth and/or definition. It quite
often helps. Lastly, if running Unix, have a look at your XFree86 video
driver (nVidia for instance releases optimized drivers for its boards).
</para></answer></qandaentry>
<qandaentry>
<question><para>Video is choppy</para></question>
<answer><para>Your system is too slow to decode all pictures. It might
be that your CPU basically is not fast enough. It can also be that the
subsystem is misconfigured/misdriven, this happens for example under
Redhat Linux. Here are some elements to improve speed: </para>
<itemizedlist>
<listitem><para>Turn on DMA on your DVD device, for instance:</para>
<itemizedlist>
<listitem><para>Under Linux:</para>
<screen><prompt>% </prompt><userinput>hdparm -d1 /dev/dvd</userinput></screen>
</listitem>
<listitem><para>Under Windows, go to the <emphasis>System</emphasis>
section of the control panel, and go to the <emphasis>Hardware
manager</emphasis> (it is sometimes in a separate tab, and sometimes,
you have to go to the <emphasis>Advanced</emphasis> tab. Then,
righ-click on your DVD player, and check the <emphasis>DMA</emphasis>
checkbox</para></listitem>
</itemizedlist>
<listitem><para>Upgrade to the latest driver for your video board</para>
<para>If you are running Linux, you can additionnaly upgrade to the
latest XFree86 version ; if supported, check that the xvideo plug-in is
effectively used with</para>
<screen><prompt>% </prompt><userinput>vlc -vvvv</userinput></screen>
</listitem>
<listitem><para>Kill other applications running...</para></listitem>
</itemizedlist>
</answer></qandaentry>
<qandaentry>
<question><para>Audio is choppy</para></question>
<answer><para>This is not normal; it is a known problem and is being
investigated.
</para></answer></qandaentry>
<qandaentry>
<question><para>Audio and video are out of sync</para></question>
<answer><para>This is not normal. Try using another output plugin (for
instance <command>--aout dsp</command>), kill <emphasis>esd</emphasis>
or <emphasis>artsd</emphasis> if they are running. This is a known
problem and is being investigated.
</para></answer></qandaentry>
<qandaentry>
<question><para>Sound volume is too low</para></question>
<answer><para>You can raise it with <command>--volume</command> command
line switch or in the preferences window of your graphical interface.
</para></answer></qandaentry>
<qandaentry>
<question><para>I have no image under DirectX</para></question>
<answer><para>Check that your video card drivers are in their latest
version and that your DirectX is up-to-date.
</para></answer></qandaentry>
<qandaentry>
<question><para>VLC crashes</para></question>
<answer><para>Increase the verbosity level (either in the preferences
or with a <emphasis>-vvvv</emphasis> command line option) and look at the
debug messages (in the terminal or in the Messages window).</para>
<para>If you are convinced that it's a bug in VLC, have a look at the
<ulink url="http://www.videolan.org/support/bug-reporting.html">bug
reporting page</ulink>.
</para></answer></qandaentry>
<qandaentry>
<question><para>Under Unices, i can only play a DVD as root</para></question>
<answer><para>Check that as user you have write access to your DVD drive
/ device.
</para></answer></qandaentry>
<qandaentry>
<question><para>I do not have access to the GUI anymore</para></question>
<answer><para>If you change the default interface module in the
preferences menu to a non GUI module (ie. to a command line interface)
and then save the configuration, the only way to get VLC to show a GUI
again is to run it directly from the command line.</para>
<para>For instance on Windows, you need to open a Command Line
console, go to the directory where you installed VLC (usually
<filename>C:\Program Files\VideoLAN\VideoLAN Client</filename>) and then
type <command>vlc --intf win32</command> You will then be able to modify
the configuration again and save it.
</para></answer></qandaentry>
<qandaentry>
<question><para>I have just upgraded to VLC 0.4.5, and now I do not have
any sound with the streams coming from the VLS!</para></question>
<answer><para>This is a known problem. VLC 0.4.5 and later are now
compliant to general usage regarding A/52 sound, and the new behavior
is incompatible with the previous one. VLS version 0.4.0 and later now
fixes this problem. If, for any reason, you wish to keep VLS 0.3.3, you
can still read those streams by launching VLC (0.4.5 or later) with
<command>--vls-backwards-compat</command>.
</para></answer></qandaentry>
<qandaentry>
<question><para>NO VIDEO!! or NO AUDIO!!</para></question>
<answer><para>DON'T PANIC! Use the verbose mode of VLC to search the
problem, you may either set the verbosity option in the interface
preferences or use the <command>-vvvv</command> command line switch to
increase the number of report/error messages given by VLC. If you are
not using a terminal, use the Messages window in the View menu.
</para></answer></qandaentry>
</qandadiv>
<qandadiv><title>Ports and features</title>
<qandadiv><title>MacOS X port</title>
<qandaentry>
<question><para>Does VLC support the ATI DVD hardware acceleration
cards?</para></question>
<answer><para>Currently it does not. We would be glad to support them,
but we lack technical information on them.
</para></answer></qandaentry>
</qandadiv>
<qandadiv><title>Win32 port</title>
<qandaentry>
<question><para>When moving the focus to another window, VLC network
input stops working properly!</para></question>
<answer><para>This is a known problem with Win 95-class systems (ie,
Windows 95/98/Me). Upgrade to an NT-class system (ie, Windows NT/2000 or
XP).
</para></answer></qandaentry>
<qandaentry>
<question><para>I have selected a subtitle file, but nothing
happens!</para></question>
<answer><para>This is a known problem. To correct it, open the
preferences panel (in the View menu), and in the
<emphasis>Decoders</emphasis> tab click on <emphasis>subtitles decoder
module (spudec)</emphasis>, without checking the box. Then, click on
<emphasis>Configure</emphasis>, and replace the given path with the
correct path to the font file. It should be something like this:
<command>C:\vlc\share\font-eutopiabold36.rle</command>. Then save the
preferences.
</para></answer></qandaentry>
</qandadiv>
<qandadiv><title>Planned ports</title>
<qandaentry>
<question><para>Do you have plans for a MacOS 9 / OS/2 / &{#!@}~
port?</para></question>
<answer><para>No, nobody reported to be actually working on a MacOS 9
or OS/2 port. If you feel like you could write it, we would of course
welcome it. Currently, the developers are more interested in supporting
the latest Operating Systems and completing the functionalities.
</para></answer></qandaentry>
<qandaentry>
<question><para>Does VLC have dxr2 / dxr3 cards support?</para></question>
<answer><para>This support is currently being developed.
</para></answer></qandaentry>