VideoLAN Client (VLC) version 0.4
Mac OS X-specific information

Welcome to the VideoLAN Client ! VLC is a multi-purpose mutimedia tool : it can play DVDs and VCDs, or read a stream from the network. It also supports DivX/MPEG-4 files and is unaffected by the dreaded .avi bug which can cause choppy sound when playing DivX in Quicktime. VLC has originally been developed for GNU/Linux systems, but has been ported to numerous operating systems, including Mac OS X and Win32. The Mac OS X port is a bit young and immature, as you will notice, and there are many caveats. We are working hard to improve it, and if you think you can help us in any way, please drop us a line.

IMPORTANT NOTE

VLC is NOT compatible with QuickTime 6 Preview. At this point, we suspect a bug in QuickTime 6 Preview. Known workaround are :
- switch the screen depth to thousands of colors ;
- downgrade to QuickTime 5 (see http://docs.info.apple.com/article.html?artnum=120084)

Please do NOT report any problem with QuickTime 6 Preview. Use it at your own risks. Any report involving QuickTime 6 Preview will be deleted.

You may find the following frequentely asked questions useful :

1. How do I install ?
When you download VLC, you will end up with a vlc-0.4.1.dmg file. Doubleclick, or drop it on the application Disk Copy, to open this file. An icon will now appear on your Desktop, right beside your drive(s). Open it and drag the vlc application from the resulting window to the place where you want to install it. Most often this is /Applications.

2. How do use VLC?
To use VLC, you will need to open the application first and then from the "File" menu open the file or disk, you would like to view. Doubleclicking a file will result in Quicktime trying to open it and Quicktime can not benefit from the advantages VLC brings.

3. How do I read an SVCD ?
VLC is currently unable to read SVCD directly from the drive. SVCDs contain plain MPEG-2 files which can be directly read. Just copy the .dat files in the SVCD onto your hard drive, and use the "Open File" menu item in VLC (drag and drop doesn't work yet).

4. The video is choppy ! It's like we're dropping frames
That's the normal behavior when the CPU isn't fast enough to decode all frames. Though there is some room for improvement, do never expect VLC to be able to decode MPEG-2 streams on a low-end G3 machine. Apple DVD player uses specific hardware accelerations from the video board of those systems, and we currently lack documentation to do the same. If you think you have information which might help us, please contact us, otherwise please don't complain about this.

If VLC is slow on your G4 system, try and quit or hide all running applications. See with top -u in a terminal window which applications take the CPU. Minimizing the VLC controller window might help, too. Be aware of bouncing icons in the dock. Bounces seriously effect the performance of VLC. The same goes for any time interval process (Checking mail every 2 minutes).

5. I only get a black picture !
Are you sure you do not have QuickTime 6 Preview installed ?.

6. How do I hide the mouse cursor ?
Just double-click on the movie.

7. How do remove VLC ?
Simply drag VLC from the place where you have installed it, to the Trash.

8. Where can I find an older version for Mac OS 9 ?
There is no version for Mac OS 9. VLC is originally a UNIX application and has never been ported to Mac OS 9. Considering the amount of differences between Mac OS 9 and modern systems, it would require a tremendous work to port VLC. We do not plan to do it. So please don't ask.

9. How do I enable deinterlacing ?
You must select the "Deinterlace" menu item before opening any file. If the item is selected while reading a file, nothing will happen. This is a known issue, please do not report it.

Thanks for reading this file. For additional information, subscribe to the vlc mailing list on http://www.videolan.org/.
-- 
Christophe Massiot <massiot@via.ecp.fr>, for the VideoLAN team.
$Id: README.MacOSX.rtf,v 1.6 2002/06/19 22:47:14 massiot Exp $