basic-use.xml 27.8 KB
Newer Older
Clément Stenac's avatar
Clément Stenac committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="basic"><title id="tbasic">
Basic use of VLC
</title>

<sect1 id="desc"><title id="tdesc">General interface description</title>

<para>VLC has several interfaces: a cross-platform interface, for
Windows and GNU/Linux, called wxWidgets, a MacOS X native interface and
a skinnable interface for Windows and GNU/Linux.</para>

<sect2><title>Windows and GNU/Linux</title>

<para>This is the default interface on Windows and GNU/Linux (the
screenshot is done on GNU/Linux, but it would look quite the same on
Windows.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The wxWidgets interface</para></textobject>
  <caption><para>The wxWidgets interface</para></caption>
</mediaobject>

<para>This interface also features an <emphasis>Extended GUI</emphasis> which contains many additional features. To display or hide it, go to the <emphasis>Settings</emphasis> menu and click <emphasis>Extended GUI</emphasis>.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-extended.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The wxWidgets interface with extended GUI</para></textobject>
  <caption><para>The wxWidgets interface with extended GUI</para></caption>
</mediaobject>

</sect2>

<sect2><title>Native Mac OS X (Cocoa)</title>
<para>This is the default interface on Mac OS X.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Mac OS X interface</para></textobject>
  <caption><para>The Mac OS X interface</para></caption>
</mediaobject>

<para>This interface features an <emphasis>Extended GUI</emphasis> as well.
It is called "Extended Controls" and can be opened through the Window-menu.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-extended.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Mac OSX interface with with the extended controls panel</para></textobject>
  <caption><para>The Mac OSX interface with with the extended controls panel</para></caption>
</mediaobject>

</sect2>
</sect1>

<sect1><title>Simple play</title>

<sect2><title>Play a file</title>
<para>To open a file, open the <emphasis>File</emphasis> menu, and select 
the <emphasis>Quick Open File</emphasis> menu item. An Open File dialog 
box will appear. Select the file you want to open, 
and select Open. VLC will start playing the selected file. 
</para>

<para>An alternative is to Drag'n'Drop your file on the VLC main interface or 
playlist window from the file explorer (Finder on MacOS X).</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-file-menu.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The File menu - wxWidgets interface</para></textobject>
  <caption><para>The File menu - wxWidgets interface</para></caption>
</mediaobject>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-file-menu.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The File menu - MacOS X interface</para></textobject>
  <caption><para>The File menu - MacOS X interface</para></caption>
</mediaobject>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-open-file.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open file dialog - wxWidgets interface</para></textobject>
  <caption><para>The Open file dialog - wxWidgets interface</para></caption>
</mediaobject>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-open-file.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open file dialog - MacOS X interface</para></textobject>
  <caption><para>The Open file dialog - MacOS X interface</para></caption>
</mediaobject>

</sect2>
<sect2><title>Play a CD/DVD/VCD</title>
<para>
To Play a CD, VCD or a DVD, open the <emphasis>File</emphasis> menu, and 
select the <emphasis>Open Disc...</emphasis> menu item. In the Open Disk 
Dialog Box, select the type of media (DVD, VCD or Audio CD). When reading a DVD,
 you can enable DVD menus by selecting the <emphasis>DVD (menus)</emphasis> 
Disc type in the wxWidgets Interface. In the MacOS X interface, 
this can be done by selecting the "Use DVD menus" dialog box.
</para>
<para>You can select the drive from which the media should be read by giving 
the appropriate drive letter or device name in the "Device Name" text input. 
This should be autodetected on MacOS X.</para>
<para>If you want to start the DVD or VCD playback from a given title and 
chapter instead of from the beginning, you can set it using the <emphasis>Title
</emphasis> and <emphasis>Chapter</emphasis> selectors.</para>
<para>You can start playback by selecting the <emphasis>Ok</emphasis> 
button.</para> 

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-open-disk.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open disk dialog - wxWidgets interface</para></textobject>
  <caption><para>The Open disk dialog - wxWidgets interface</para></caption>
</mediaobject>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-open-disk.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open disk dialog - MacOS X interface</para></textobject>
  <caption><para>The Open disk dialog - MacOS X interface</para></caption>
</mediaobject>

</sect2>
<sect2><title>Play a network stream (WebRadio, WebTV, ...)</title>
<para>
To open a network stream, open the "File" menu and select the "Open Network 
Stream" menu item.</para>

<itemizedlist>
<listitem><para>To open a UDP unicast stream, select <emphasis>UDP/RTP
</emphasis>, and set the appropriate UDP port in the selector 
(it is 1234 for streams sent by a VLC or VLS server).
</para></listitem>
<listitem><para>
To open a UDP multicast stream, select <emphasis>UDP/RTP
multicast</emphasis>. Give the address of the multicast group
in the "Address" text input, and select the appropriate UDP
port.</para></listitem>
<listitem><para>
To open a stream sent over http (Webradios, WebTVs, Shoutcast, Icecast...), 
ftp, or mms (Microsoft Media Server), select "HTTP/FTP/MMS", and 
give the corresponding complete URL, (such as 
http://live.stream.org:8080/live or mms://live.ms.stream.net:8080/live.asf) 
in the corresponding text input. This also the way to open a RTSP stream 
with the MacOS X interface.
</para></listitem>
<listitem><para>
To open a RTSP stream (sent by Darwin Streaming Server, VLC, etc), 
in the wxWidgets interface, select "RTSP" and give the URL in the text input.
</para></listitem></itemizedlist>

<para>You can start playback by selecting the <emphasis>Ok</emphasis> button.
</para>
<para>If you get some stuttering during playback, you can try to increase the 
size of the read buffer. This can be done in the <emphasis>Open Network Stream
</emphasis> dialog box, by selecting the <emphasis>Caching</emphasis> box. 
You can then choose the amount time (in milliseconds) VLC should store data 
in its buffer before starting playback.
</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-open-net.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open network dialog - wxWidgets interface</para></textobject>
  <caption><para>The Open network dialog - wxWidgets interface</para></caption>
</mediaobject>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-open-net.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open network dialog - MacOS X interface</para></textobject>
  <caption><para>The Open network dialog - MacOS X interface</para></caption>
</mediaobject>

</sect2>
<sect2><title>Play from an acquisition card</title>
<para>This currently only possible on Linux and Windows. Open the File menu, 
and select "Open Capture Device..."</para>

<para>
On Windows, supported cards include webcams, TV cards, acquisition 
cards... provided they come with directshow compatible drivers (Almost 
all acquisition cards do). You can choose the device to use for video and 
audio capture using the "Video device name" and "Audio device name" selectors. 
If your device doesn't appear in the list, try to select the "Refresh list" 
button. You can access the settings of your acquisition device by selecting 
the <emphasis>configure</emphasis> button. Options here depend on the driver 
of the device. You can select the "Device Proprieties" box if you want the 
configuration dialog box of every device to be displayed after having pressed 
the <emphasis>Ok</emphasis> button. Select the <emphasis>Tuner properties</emphasis> box to be prompted for tuner settings (PAL/NTSC standard, frequency...) 
for TV cards. The <emphasis>Advanced options...</emphasis> button allows to select some further settings useful in some rare cases, such as the chroma 
of the input (the way colors are encoded) and the size of the input buffer.
</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-open-capture.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open Capture device dialog and a device configuration windows- wxWidgets interface</para></textobject>
  <caption><para>The Open Capture device dialog and a device configuration windows - wxWidgets interface</para></caption>
</mediaobject>

<para>On Linux, supported cards include webcams, TV cards, acquisition cards, provided they are supported by the Video4Linux architecture. Haupaugge PVR 250/350 cards are also supported, using the  <ulink 
url="http://ivtv.sourceforge.net/">IVTV drivers </ulink>.</para>

<itemizedlist>
<listitem><para>
For Video4Linux devices, you can set the name of the video and audio 
devices using the "Video device name" and "Audio device name" text inputs. 
The "Advanced options..." button allows to select some further settings useful
in some rare cases, such as the chroma of the input (the way colors are
encoded) and the size of the input buffer.</para></listitem>
</itemizedlist>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-open-v4l.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open Video4Linux dialog- wxWidgets interface</para></textobject>
  <caption><para>The Open Video4Linux dialog - wxWidgets interface</para></caption>
</mediaobject>

<itemizedlist>
<listitem><para>
To use a Hauppauge PVR card, select the PVR tab in the "Open" dialog box. 
Use the "Device" text input to set the device of the card you want to use. 
You can set the Norm of the tuner (PAL, SECAM or NTSC) by using the "Norm" 
Drop Down. The Frequency selector allows you to set the frequency of the tuner 
(in kHz), the bitrate selector to set the bitrate of the resulting encoded 
stream (in bit/s). The "Advanced Options button allows to set some more 
settings, such as the size of the encoded video (in pixels), its framerate 
(in frame per second), the interval between 2 key frames, etc.</para></listitem>
</itemizedlist>

<para>After having set all the required parameters, you can start the capture by selecting the "Ok" button.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-open-pvr.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Open PVR dialog- wxWidgets interface</para></textobject>
  <caption><para>The Open PVR dialog - wxWidgets interface</para></caption>
</mediaobject>


</sect2>

</sect1>

<sect1><title>Using the playlist</title>

<para>VLC can of course store a list several files to play one after the other, 
using its playlist system. To access the playlist, click on the 
<emphasis>Playlist</emphasis> button on the main interface 
(see <xref linkend="desc" endterm="tdesc"/>).</para>

<para>Each time you use the Open dialog box, the stream you select is
appended at the end of the playlist and started.</para>

<para>The playlist window shows all the streams available in the playlist.
Double-click one to have it played.</para>


<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-playlist.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Playlist - wxWidgets interface</para></textobject>
  <caption><para>The Playlist - wxWidgets interface</para></caption>
</mediaobject>
<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-playlist.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Playlist - MacOS X interface</para></textobject>
  <caption><para>The Playlist - MacOS X interface</para></caption>
</mediaobject>


<sect2><title>Adding items, saving and loading playlists</title>

<para>In the wxWidgets interface, the <emphasis>Manage</emphasis> menu
allows you to append an item at the end of the playlist (its playback
won't start immediately), to save the playlist as a M3U or PLS file, or
to import a playlist file.</para>

<para>In the MacOS X interface, saving a playlist can be done
using the <emphasis>Save Playlist...</emphasis> function in the
<emphasis>File</emphasis> menu. To import a playlist file, open it
the same way as any other media file, using the <emphasis>Quick Open
File...</emphasis> menu item.</para>

</sect2>

<sect2><title>Sorting</title>

<para>In the wxWidgets interface, <emphasis>Sort</emphasis> allows
you to sort the playlist according to several criteria, or to shuffle
it. You can also sort by clicking the header of the column</para>

<para>In the MacOS X interface, sorting can be done by clicking
the header of the column matching the criteria you want to use for
sorting.</para>

</sect2>

<sect2><title>Playlist modes</title>

<para>The playlist supports several playback modes.</para>

<para>In the wxWidgets interface, the toolbar contains three playlist
mode buttons. They allow to enable random mode, to repeat the whole playlist or
to repeat one item.</para>

<para>In the MacOS X interface, random mode can be enabled by selecting
the <emphasis>Random</emphasis> box. A drop down menu allows you to
enable playlist and item repeat modes.</para>

</sect2>

<sect2><title>Misc</title>

<sect3><title>Search</title>

<para>You also have a search tool. Enter a search string and hit search.
The next item to match the string will be highlighted. Keep hitting Search
to cycle between all matching items.</para>

</sect3>

<sect3><title>Moving items</title>

<para>In the wxWidgets interface, the <emphasis>Up</emphasis> and
<emphasis>Down</emphasis> buttons at the bottom of the playlist window
allow you to move an item. Select an item and use these buttons to move
it.</para>

<para>In the MacOS X interface, you can move an item with the mouse,
easily using a <emphasis>Drag'n'Drop</emphasis>.</para>

</sect3>


<sect3><title>Contextual menu</title>

<para>By right-clicking an item, a contextual menu will appear, giving
access to a number of functions (play the item, disable it, delete it,
or get info on it).</para>

<para>If you ask for info, an <emphasis>item info</emphasis> dialog box will 
appear. This dialog box also allows you to change the name, the author and the 
location of the item to play.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-iteminfo.jpg" format="JPG" />
  </imageobject>
  <textobject><para>Item Info Dialog - wx Interface</para></textobject>
  <caption><para>Item Info Dialog - wx Interface</para></caption>
</mediaobject>
<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-iteminfo.jpg" format="JPG" />
  </imageobject>
  <textobject><para>Item Info Dialog - MacOS X interface</para></textobject>
  <caption><para>Item Info Dialog - MacOS X interface</para></caption>
</mediaobject>


</sect3>

</sect2>

</sect1>

<sect1><title>Hotkeys</title>

<para>Most of VLC functions are accessible using hotkeys</para>

<para>The list of the available hotkeys and their binding can be retrieved 
and altered in the preferences panel of the player. In the wxWidgets interface, 
preferences are available in the "Settings" menu, "Preferences" menu item. 
In the MacOS X interface, open the "VLC" menu, and select "Preferences". 
Select the "Hot keys" panel in the dialog. For each  function of VLC, you 
get the bound hotkey in the dropdown in the right part of the panel. Several 
boxes gives the list of modifiers for the hotkey. To trigger an action using 
 a hotkey, you need to press at the same time the keys corresponding to 
the different selected modifiers as well as the key set in the dropdown.</para>

<para>To change the binding of a hotkey, select or deselect boxes corresponding 
to the different modifiers, and change the key by using the dropdown. Select 
the <emphasis>Save</emphasis> button to apply the changes.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-hotkeys.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Hotkeys Panel - wxWidgets interface</para></textobject>
  <caption><para>The Hotkeys Panel - wxWidgets interface</para></caption>
</mediaobject>
<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-hotkeys.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The Hotkeys Panel - MacOS X interface</para></textobject>
  <caption><para>The Hotkeys Panel - MacOS X interface</para></caption>
</mediaobject>


</sect1>

<sect1><title>Using subtitles</title>

<para>VLC supports many kinds of subtitles.</para>

<sect2><title>Media with included subtitles</title>

<para>Many types of media can have embedded subtitles. VLC can read
subtitles for the following media:</para>

<itemizedlist>
<listitem><para>DVD</para></listitem>
<listitem><para>SVCD</para></listitem>
<listitem><para>OGM files</para></listitem>
<listitem><para>Matroska (MKV) files</para></listitem>
</itemizedlist>

<para>Subtitles are disabled by default. To enable them, go to
the <emphasis>Video</emphasis> menu, and to <emphasis>Subtitles
track</emphasis>. All available subtitles tracks will be listed.
Select one to get the subtitles. Depending on the media, a description
(language, for example) might be available for the track.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-select-sub.jpg" format="JPG" />
  </imageobject>
  <textobject><para>Select a subtitles track under Windows or Linux</para></textobject>
  <caption><para>Select a subtitles track under Windows or Linux</para></caption>
</mediaobject>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-select-sub.jpg" format="JPG" />
  </imageobject>
  <textobject><para>Select a subtitles track under MacOS X</para></textobject>
  <caption><para>Select a subtitles track under MacOS X</para></caption>
</mediaobject>

<para>DVD and SVCD subtitles are merely images, so you won't be able to
change anything for them. OGM and Matroska subtitles are rendered text,
so you will be able to change several options.</para>

<para>Text rendering options
can be changed in the Preferences. In the <emphasis>Modules</emphasis>
section, <emphasis>text renderer</emphasis> subsection, open the
<emphasis>freetype</emphasis> page. You can then set the font and its
size. For the font, you have to select a font file. Under Windows, they
can be found in <emphasis>C:\Windows\Fonts</emphasis>. Under MacOS X,
they are in <emphasis>/System/Library/Fonts</emphasis><!-- FIXME: Linux
-->. Size can be set either relatively or as a number of pixels.</para>

<para>You need to restart your stream for the font modifications to take
effect.</para>

</sect2>

<sect2><title>Subtitles files</title>

<para>While modern file formats like Matroska or OGM can handle
subtitles directly, older formats like AVI can't. Therefore, a number
of subtitles files formats have been created. You need two files: the
video file and the subtitles files that only contains the text of the
subtitles and timestamps.</para>

<para>VLC can handle these types of subtitles files:</para>

<itemizedlist>
<listitem><para>MicroDVD</para></listitem>
<listitem><para>SubRIP</para></listitem>
<listitem><para>SubViewer</para></listitem>
<listitem><para>SSA</para></listitem>
<listitem><para>Sami</para></listitem>
<listitem><para>Vobsub (this one is quite special: it is not made from text
but from images, which means that you can't change the fonts)</para></listitem>
</itemizedlist>

<para>To open a subtitles file, use the Advanced Open dialog
box (Menu File, Open file). Select your file by clicking on
the <emphasis>Browse</emphasis> button. Then, check the <emphasis>Subtitle
options</emphasis> checkbox and click on the Settings button.</para>


<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-sub-file.jpg" format="JPG" />
  </imageobject>
  <textobject><para>Select a subtitles file under Windows or Linux</para></textobject>
  <caption><para>Select a subtitles file under Windows or Linux</para></caption>
</mediaobject>

<para>You can then select the subtitles file by clicking the
<emphasis>Browse</emphasis> button. You can also set a few options like
character encoding, alignment and size. The delay option allows you to delay
the subtitles against the video if they are not in sync. If they are
not at the same speed, you might also want to adjust the subtitles
framerate.</para>

<note><para>For Vobsub subtitles, you need to select the
<userinput>.idx</userinput> file, not the <userinput>.sub</userinput> file</para>
<para>Encoding, alignment and size won't have any effect for Vobsub
subtitles.</para>
</note>

<para>Font can be changed as explained in the previous section.</para>

</sect2>

</sect1>

<sect1><title>Video and audio filters</title>

<para>VLC includes a system of <emphasis>filters</emphasis> that allow
you to modify the audio and video.</para>

<sect2><title>Deinterlacement and Post Processing</title>

<para>VLC is able to deinterlace a video stream using different deinterlacement 
methods. Deinterlacement can be enabled in the <emphasis>Video</emphasis> menu, 
<emphasis>Deinterlacement</emphasis> menu item. The <emphasis>Blend</emphasis> 
methods gives the best results in most cases. The <emphasis>discard</emphasis> 
method is a less resource consuming alternative.</para>

<para>On some particular streams (MPEG 4, DIVX, XVID, Sorenson, ...), some 
additional image filtering can be applied to the video before display, 
improving its quality in some cases. This can be enabled in the <emphasis>Video
</emphasis> menu, <emphasis>Post processing</emphasis> menu item. Different 
levels of post processing can be chosen here. A higher level means more 
filtering.</para>

</sect2>

<sect2><title>Video filters</title>

<para>VLC features several filters able to change the video (distortion,
brightness adjustment, motion blurring, ...).</para>

<para>With the wxWidgets interface, filters can be easily enabled using
the Extended GUI. In the Video tab, simply select the filters to enable.
Image settings can be easily adjusted.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-vfilters.jpg" format="JPG" />
  </imageobject>
  <textobject><para>Video filters selection in the wxWidgets interface</para></textobject>
  <caption><para>Video filters selection in the wxWidgets interface</para></caption>
</mediaobject>

<para>You can enable these filters through the <emphasis>Extended Controls panel</emphasis> on Mac OS X. Click on the triangle next to <emphasis>Video filters</emphasis> to select your filters or expand the <emphasis>Adjust Image</emphasis> section to change the contrast, hue, etc.</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-vfilters.jpg" format="JPG" />
  </imageobject>
  <textobject><para>Video filters selection in the Mac OS X interface</para></textobject>
  <caption><para>Video filters selection in the Mac OS X interface</para></caption>
</mediaobject>

<para>For better control, you need to go
to the preferences. To select the filters to be enabled,
go to <emphasis>Video</emphasis>, then to
<emphasis>Filters</emphasis>. In the "video filter module" box, enter
the names of the filters to enable, separated by semicommas. Filters
will be applied in the selected order. Valid names are "clone", "wall",
"transform", "adjust", "crop", "deinterlace", "distort", "motionblur"
and "logo".</para>

<para>If you want to tune the behavior of these filters, go to
<emphasis>Video, Filters, [your filter] </emphasis>. For each filter, you will
find a short description and the options</para>

</sect2>


<sect2><title>Audio filters</title>

<sect3><title>Equalizer</title>

<para>VLC features a 10-band graphical equalizer. You can display it
by activating the advanced GUI on wxWidgets or by clicking the
<emphasis>Equalizer</emphasis> button on the MacOS X interface.</para>


<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-equalizer.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The equalizer in the wxWidgets interface</para></textobject>
  <caption><para>The equalizer in the wxWidgets interface</para></caption>
</mediaobject>


<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-osx-equalizer.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The equalizer in the MacOS X interface</para></textobject>
  <caption><para>The equalizer in the MacOS X interface</para></caption>
</mediaobject>

<para>Presets are available in the Audio menu in wxWidgets, or in the
Equalizer window in the MacOS X interface</para>

</sect3>

<sect3><title>Other audio filters</title>

<para>At the moment, VLC features two other audio filters: a volume
normalizer and a filter providing sound spatialization with a headphone.
They can be enabled in the Audio tab of the extended GUI for the
wxWidgets interface and in the Audio section of the Extended Controls panel of the Mac OS X interface.</para>

<para>For better control, you need to go
to the preferences. To select the filters to be enabled,
go to <emphasis>Audio</emphasis>, then to
<emphasis>Filters</emphasis>. In the "audio filters" box, enter the
names of the filters to enable, separated by commas. Valid names are
"equalizer", "normvol" and "headphone".</para>

<para>If you want to tune the behavior of these filters, go to
<emphasis>Audio, Filters, [your filter]</emphasis>. The equalizer and headphone
filters can be tuned.</para>

</sect3>

</sect2>

</sect1>

<!--
<sect1><title>Misc</title>

<para>TODO</para>

</sect1>
-->

<sect1><title>Basic troubleshooting</title>

<note><para>This is very incomplete</para></note>

<sect2><title>File does not play, only sound or only video</title>

<para>Maybe the file you are trying to read is not fully supported. VLC
does not use the codec packs you might have installed. It comes with its own
codecs. If there is no open-source decoder for the format you are trying
to read, it won't be supported. (There is an exception, under Windows,
for codecs that use the DirectShow framework).</para>

<para>To find out, open the Messages Window (View menu) and restart your
stream. Look for error messages (red messages)</para>

<mediaobject>
  <imageobject>
    <imagedata fileref="images/play-howto/intf-wx-messages.jpg" format="JPG" />
  </imageobject>
  <textobject><para>The wxWidgets messages window</para></textobject>
  <caption><para>The wxWidgets messages window</para></caption>
</mediaobject>

<para>In this example, the file contains a IV41 video stream, a codec
that is not supported by VLC.</para>

<para>You may of course have other messages. If you post to a VideoLAN
mailing list or in the forum, please include such a log, it is very
valuable.</para>

</sect2>

<sect2><title>Weird VLC behavior ("stopped working")</title>

<para>A very common thing is a bogus preferences file. Don't hesitate to
delete it if problems appear suddenly. You will find in the FAQ details
on <ulink url="http://www.videolan.org/doc/faq/en/index.html#id2470084">how to delete your preferences file</ulink>.</para>

</sect2>

<sect2><title>Computer crashes / Video is corrupted</title>

<para>Another common problem is buggy video drivers. Try upgrading them
from the website of your video card's manufacturer.</para>

<para>Also, you can try disabling Overlay (Preferences/General/Video,
untick "Overlay video output")</para>

</sect2>

</sect1>
</chapter>