VLC media player, version 0.7
Mac OS X-specific information

Welcome to the VideoLAN Client! VLC media player is a multi-purpose multimedia tool. It can play DVDs, VCDs or read a stream from the network. It plays DivX/MPEG-4 files (and many other files) and is unaffected by the dreaded .avi bug which can cause choppy sound when playing DivX in QuickTime Player. You can also stream content to the network or a file. But above all it is the ONLY media player on Mac OS X, which has support for multi-channel sound-output.
For a full list of features visit: http://www.videolan.org/vlc/features.html

VLC media player was originally developed for GNU/Linux systems, but has been ported to numerous operating systems, including Mac OS X and Win32. Though there probably are bugs, we are always working hard to improve VLC media player and if you think you can help us in any way, please drop us a line: http://www.videolan.org/support/lists.html
http://forum.videolan.org/

The following frequently asked questions are answered below :
1. How do I install ?
2. How do I use VLC media player ?
3. How do I read a CD/(S)VCD/DVD ?
4. The video is choppy! It's like we're dropping frames.
5. How do I remove VLC media player ?
6. Where can I find an older version for Mac OS 9 ?
7. How do I change the size of the video window ?
8. I think I found a bug. What should I do ?
9. Support for files with subtitles.
10. What do all the options in the preferences do ?
11. How do i get fullscreen video on my other monitor ?
12. Multiple sound-devices and multi-channel sound?

1. How do I install ?
When you download VLC media player, you will end up with a VLC-0.7.x.dmg file. Double-click, 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 the directory Applications on your main harddrive.

2. How do I use VLC media player ?
To use VLC media player, you will need to open the application first and then from the "File" menu open the file or disk, you would like to view. Double-clicking a file will result in QuickTime Player trying to open it. If you prefer you can change this by selecting your file and choosing "Get Info" from the "File" menu of the Finder. In the "Open With" section you can select VLC and if you check the checkbox, then all files of the type you have selected will be opened in VLC media player if you double-click them from that moment on.

3. How do I read a CD/(S)VCD/DVD ?
To view a (S)VCD, DVD or Audio CD, you will need to choose "Open Disc" from the "File" menu. Choose your disk type and then choose the drive in which you inserted the disk. VLC media player is currently unable to read SVCD directly from the drive. Some SVCDs can be read if you tell VLC they're VCDs, in the "Open Disc" dialog.

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 the frames. Though there is some room for improvement, don't ever expect VLC to be able to decode MPEG-2 streams or high resolution DivX on a low-end G3 machine.

If you experience problems playing DivX/Xvid then you can try the following:
- Open the preferences.
- Now go to the Modules part of the preferences.
- Select decoder and then 'ffmpeg'
- Enable 'hurry up' -> click 'Save'

If VLC media player is slow on your G4 system, try to quit or hide all running applications. See with top -u in a terminal window which applications take the CPU. 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. How do I remove VLC media player ?
Simply drag VLC from the place where you had installed it, to the Trash.

6. 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 effort to port VLC. We do not plan to do it, because we prefer to focus on creating a very good Mac OS X application. So please don't ask.

7. How do I change the size of the video window ?
Grab the bottom-right corner of the video window and drag the window to its desired size. You can also set half, normal and double sizes from the Video menu.

8. I think I found a bug. What should I do ?
First try resetting your preferences by clicking "Reset All" in the preferences dialog. If this doesn't work then you can report the exact conditions under which the bug/crash occurred back to the VLC team. For more information on bugreporting please read http://www.videolan.org/support/bug-reporting.html

9. Support for files with subtitles.
- VLC will autodected subtitle files when they are in the same directory as your movie and contain the movie name.
- DVD and autodectected subtitles  can be enabled trough the Controls->Subtitles menu-item.
- Only MicroDVD, SubRIP, SSA1-4. SAMI and vplayer subtitle files are supported at the moment. (so not VobSub [.idx AND .sub file])
- You cannot change anything about DVD subtitles.
- You can add any subtitle files to a video file via the Open.. dialog.
- A text-encoding is automatically chosen, but for some people this can be incorrect. You can change it in Preferences -> Modules ->  decoder -> subsdec
- Text subtitles are by default centered. If you want them to be aligned left or right you can change this in Preferences -> Modules ->  decoder -> subsdec
- For Arabic, Hebrew and Japanese etc, you need to select a font compatible with these languages. You can change the default font in Preferences -> Modules ->  text-renderer -> freetype
- You can change the fontsize in Preferences -> Modules ->  text-renderer -> freetype
- You cannot change the font color or the thickness of the outlines.

10. What do all the options in the preferences do ?
Hold your mouse still on top of an option for just over a second and a ToolTip will come up explaining what the option does. Be very careful with the Advanced options. Changing an option in the wrong value (usually selecting a module by hand instead of letting it be selected automatically) can cause VLC to no longer start. In this case you will need to remove the preference file located in your HOME -> Library -> Preferences -> VLC.

11. How do I get fullscreen video on my other monitor ? 
If you want to use your second screen for fullscreen playback, then look at the Video->Screen menuitem. You can set this option permanently by going into the Preferences and choosing Modules -> video output -> macosx -> video device (You will need to choose "Show Advanced options" first).

12. Multiple sound-devices and multi-channel sound? 
Look at the Audio->Device menuitem. You can set this option permanently by going into the Preferences and choosing Modules -> audio output -> coreaudio -> audio device (You will need to choose "Show Advanced options" first).
- AC3 over SPDIF with M-Audio Sonica Theater does not work. This is most likely a driver bug which has been reported to M-Audio.
- Many problems might still exist. Multiple channel audio support is pretty new on Mac OS X and there are many bugs in the system software, the device drivers and probably in VLC media player as well.
- Someone with CoreAudio knowledge is very much invited to assist is in fixing all the bugs that linger in this area.

Thanks for reading this file. For additional information, subscribe to the VLC mailing list on http://www.videolan.org/support/lists.html.
-- 
Christophe Massiot <massiot@via.ecp.fr> and
Derk-Jan Hartman <thedj@users.sourceforge.net> for the VideoLAN team.
$Id: README.MacOSX.rtf,v 1.24 2003/12/23 00:23:31 hartman Exp $