dc3d5a7350c3003b50bb41cd878de701f9082740
[vlc.git] / FAQ
1 Frequentely Asked Questions for VideoLAN Client
2 $Id: FAQ,v 1.10 2002/07/25 22:34:37 lool Exp $
3
4 1. Using VLC
5
6 1.1 How do I read a DVD ?
7 -----------------------
8 Just launch vlc and use the "open disc" command from the graphical
9 interface. In case of trouble, you may want to use the command line
10 interface :
11     vlc dvd:/dev/dvd
12
13 1.2 How do I read an encrypted DVD ?
14 ----------------------------------
15 It's exactly the same as for a normal DVD. You will need write access to
16 /dev/dvd, because of the key negociation process.
17
18 If you compiled your VLC by hand, please bear in mind that you also need
19 to install libdvdcss. It can be downloaded from the VideoLAN website. It
20 used to be distributed in the same package as VLC, but now you must install
21 them seperately.
22
23 1.3 How do I switch to full screen display ?
24 ------------------------------------------
25 Press 'f' to toggle fullscreen mode. Note that not all video output
26 devices support full screen.
27
28 1.4 How do I hide the mouse cursor ?
29 ----------------------------------
30 It should disappear after a few seconds if you stop moving the mouse.
31
32 1.5 How do I use vlc if I don't want to install Gnome and all this
33 #@!£% *$@&§% !@# bloat ?
34 ---------------------------------------------------------------------------
35 You can run :
36     vlc --intf dummy myfile.mpg
37 Most commands are available from the command line, see vlc --help for
38 more information.
39
40 1.6 VLC eats my buffer cache, how to I use raw device ?
41 -----------------------------------------------------
42 If you don't know what is a raw device, don't even read this answer :-).
43 There is an experimental support for raw devices in libdvdcss. It needs
44 that you set up a raw device pointing to your DVD device (under Linux,
45 use the "raw" utility). Then pass the raw device as second argument, for
46 instance :
47     vlc dvd:/dev/dvd@/dev/raw0
48
49 1.7 How do I use VLC as a client for VLS/VLMS streaming ?
50 -------------------------------------------------------
51 First you must set up a VLS or VLMS stream. Please refer to the
52 documentation of these programs. Then start VLC :
53     vlc udp:
54 You shouldn't need any option. If you're paranoid and want to control
55 everything, here is the exact syntax :
56     vlc udp:[<server>[:<server port>]][@[<bind address>][:<bind port>]]
57
58 1.8 How do I uninstall / reinstall VLC ?
59 --------------------------------------
60 Why would you want to ?  ;)
61
62 If you're using a source distribution of VLC, for example a tarball or
63 the CVS, then you have probably used "make install" to install the
64 compiled VLC.  To remove it just "make uninstall".  If you want to
65 install a newer version than the currently installed one, you should
66 first uninstall the first one.  If you deleted the original source tree,
67 a "make uninstall" in the newer tree should still work.
68
69 For binary packages, remove old packages first and install the new ones
70 (normally this should be handled automagically by your sytem).
71
72 1.9 Debian: what should I put in my sources.list for videolan ?
73 -------------------------------------------------------------
74 deb     ftp://ftp.videolan.org/pub/videolan/ debian/
75 deb-src ftp://ftp.videolan.org/pub/videolan/ debian/
76
77
78 2. Troubleshooting
79
80 2.1 When I start vlc, I don't have any interface coming...
81 -------------------------------------------------------
82 If you installed a binary package, make sure you also installed an
83 interface package such as vlc-gtk or vlc-qt. If you installed from
84 source, make sure the development package for gtk or qt is correctly
85 installed (often gtk-dev or gtk-devel) and recompile.
86
87 2.2 Clicking on "disc" in the interface doesn't do anything
88 -----------------------------------------------------------
89 Wait a few seconds. Key cracking can take much time on some discs. If it
90 still doesn't work, you can have a more verbose output using "vlc -vvvvv".
91 Here are a few things to check for :
92 * Did you install the libdvdcss package ?
93 * Do you have write access to your DVD device ? For instance :
94 chmod 666 /dev/hdc
95 * Does your kernel log contain line about your DVD device ?
96 * Do you have a link from /dev/dvd to your real DVD device ? For instance
97 ln -s hdc /dev/dvd
98
99 2.3 [REMOVED]
100 -------------
101
102 2.4 The video runs but the picture is distorted...
103 -----------------------------------------------
104 There is probably a problem with the output layer. There are several
105 ways of troubleshooting it. First, try with another output plug-in, for
106 instance :
107 vlc --vout sdl
108 vlc --vout x11
109 Second, change your screen depth and/or definition. It quite often helps.
110 Lastly, have a look at your XFree86 video driver (nVidia for instance
111 releases optimized drivers for its boards).
112
113 2.5 Video is choppy...
114 -------------------
115 Your system is too slow to decode all pictures. It might be that your
116 CPU basically isn't fast enough. It can also be that the subsystem is
117 misconfigured/misdriven. Here are some elements to improve speed :
118 * Turn on DMA on your DVD device, for instance :
119 hdparm -X34 -d1 /dev/dvd
120 * Upgrade to the latest XFree86 version and the latest driver for your
121 video board ; check that the xvideo plug-in is effectively used with
122 vlc -vvvv
123 * Kill other applications running...
124
125 2.6 Audio is choppy...
126 -------------------
127 This is not normal ; it is a known problem and is being investigated.
128
129 2.7 Audio and video are out of sync
130 -----------------------------------
131 This is not normal. Try using another output plug-in (for instance --aout dsp),
132 kill esd or artsd if they are running... This is a known problem and
133 is being investigated.
134
135 2.8 [REMOVED]
136 -------------
137
138 2.9 Sound volume is too low
139 ----------------------------
140 You can raise it with --volume commandline switch or in the preferences
141 window of your graphical interface.
142
143 2.10 I have no image under DirectX
144 ----------------------------------
145 Check that your video card drivers are in their latest version and that
146 your DirectX is up-to-date.
147
148 2.11 VLC crashes
149 ----------------
150 Increase the verbosity level (either in the preferences or with a
151 "-vvvv" command-line option) and look at the debug messages (on the
152 terminal or in the Messages window).
153
154 2.12 I can only play a DVD as root
155 ----------------------------------
156 Check that as user you have write access to your DVD drive / device.
157
158 2.13 I'm stuck with option xxx, how do I reset options ?
159 ------------------------------------------------------
160 Under unices, remove your ~/.videolan/vlcrc; for Windows, remove vlcrc
161 in the videolan subfolder of your "Application Data" directory.
162
163
164 3. Ports and features
165
166 3.1 MacOS X port
167
168 3.1.1 Does VLC support the ATI DVD hardware acceleration cards ?
169 --------------------------------------------------------------
170 Currently it doesn't. We'd be glad to support them, but we lack technical
171 information on them.
172
173 3.1.2 [REMOVED]
174 ---------------
175
176 3.2 Win32 port
177
178 3.2.2 When moving the focus to another window, VLC network input stops
179 working properly !
180 ---------------------------------------------------------------------------
181 This is a known problem with Win 95-class systems. Upgrade to an NT-class
182 system.
183
184 3.3 Planned ports
185
186 3.3.1 Do you have plans for a MacOS 9 / OS/2 / &{#!@}~ port ?
187 --------------------------------------------------------
188 No, nobody reported to be actually working on a MacOS 9 port.  If you
189 feel like you could write it, we would of course welcome it.  Currently,
190 the developers are more interested in supporting the latest Operating
191 Systems and completing the functionalities.
192
193 3.3.2 Does VLC have dxr2 / dxr3 cards support ?
194 ---------------------------------------------
195 This support is currently being developed.
196
197 3.3.3 Does VLC support RTP ?
198 --------------------------
199 No, but this is planned.