git.sesse.net Git - vlc/blob - README - Mac OS X.rtf

   1 {\rtf1\mac\ansicpg10000\cocoartf100
   2 {\fonttbl\f0\fswiss\fcharset77 Helvetica;\f1\fswiss\fcharset77 Helvetica-Bold;\f2\fmodern\fcharset77 Courier;
   3 }
   4 {\colortbl;\red255\green255\blue255;}
   5 \margl1440\margr1440\vieww11240\viewh10380\viewkind0
   6 \hyphauto1\hyphfactor90
   7 \pard\tx1440\tx2880\tx4320\tx5760\tx7200\qc
   8
   9 \f0\fs48 \cf0 VideoLAN Client (VLC) version 0.3\
  10 Mac OS X-specific information
  11 \fs24 \
  12 \pard\tx1440\tx2880\tx4320\tx5760\tx7200\ql\qnatural
  13 \cf0 \
  14 \
  15 \pard\tx1440\tx2880\tx4320\tx5760\tx7200\qj
  16 \cf0 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. 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.\
  17 \
  18 You may find the following frequentely asked questions useful :\
  19 \
  20
  21 \f1\b \ul 1. How do I read a DVD ? The menu item is disabled !\
  22
  23 \f0\b0 \ulnone The menu item hasn't been implemented yet, but you can access all features of VLC using the command line. First open a terminal window (Terminal.app in your Applications folder) and change to the directory where you copied VLC - for instance if you copied it to your Applications folder, type :\
  24
  25 \f2 cd /Applications\
  26
  27 \f0 \
  28 Then type :\
  29
  30 \f2 ./vlc.app/Contents/MacOS/vlc dvd:/dev/rdisk1\
  31
  32 \f0 \
  33 VLC should play your DVD. On some configurations, /dev/rdisk1 isn't the DVD drive, and you will find it as /dev/rdisk2, /dev/rdisk3, etc. YMMV\
  34 \
  35 You can access all the capabilities of VLC through the command line (since the native interface support is still very poor), such as choosing audio channel, subtitles, and titles/chapters. To view all the options available, please type :\
  36
  37 \f2 ./vlc.app/Contents/MacOS/vlc --help\
  38
  39 \f0 \
  40 For instance, if you want the audio channel #2 :\
  41
  42 \f2 ./vlc.app/Contents/MacOS/vlc --input_audio 2 dvd:/dev/rdisk1\
  43
  44 \f0 \
  45 You can view all available channels and subtitles with :\
  46
  47 \f2 ./vlc.app/Contents/MacOS/vlc --stats dvd:/dev/rdisk1\
  48
  49 \f0 \
  50 \
  51
  52 \f1\b \ul 2. How do I read a VCD ?\
  53
  54 \f0\b0 \ulnone The same way you read a DVD, except you replace
  55 \f2 dvd
  56 \f0  by
  57 \f2 vcd
  58 \f0 . Eg. :\
  59
  60 \f2 ./vlc.app/Contents/MacOS/vlc vcd:/dev/rdisk1\
  61
  62 \f0 \
  63 \
  64
  65 \f1\b \ul 3. How do I read an SVCD ?
  66 \f0\b0 \ulnone \
  67 SVCDs contain plain MPEG-2 files and do not require any specific plug-in. just copy the .vob files in the SVCD onto your hard drive, and use the "Open File" menu item in VLC (drag and drop doesn't work yet).\
  68 \
  69 \
  70
  71 \f1\b \ul 4. Audio and video are out of sync by 300 ms !\
  72
  73 \f0\b0 \ulnone This is a known issue, and we're working on it. In the meantime, launch the application with
  74 \f2 --desync\'ca300
  75 \f0  (the exact number depends on your machine), eg. :\
  76
  77 \f2 ./vlc.app/Contents/MacOS/vlc --desync 300 dvd:/dev/rdisk1\
  78
  79 \f0 \
  80 \
  81
  82 \f1\b \ul 5. The video is choppy ! It's like we're dropping frames\
  83
  84 \f0\b0 \ulnone 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.\
  85 \
  86 If VLC is slow on your G4 system, try and quit or hide all running applications. See with
  87 \f2 top
  88 \f0  in a terminal window which applications take the CPU. Minimizing the VLC controller window might help, too.\
  89 \
  90 \
  91
  92 \f1\b \ul 6. How do I play a DivX file ?\
  93
  94 \f0\b0 \ulnone VLC doesn't support DivX or OpenDivX or MPEG-4 files at present. We are working on it too, but this isn't expected to happen in the near future.\
  95 \
  96 \
  97
  98 \f1\b \ul 7. The fullscreen menu item has disappeared. This sucks !\
  99
 100 \f0\b0 \ulnone The menu item has been temporarily removed for technical reasons. It doesn't mean that the feature has been removed. To turn on fullscreen mode, just hit 'f' in the video window. To go back to windowed mode, hit 'f' again.\
 101 \
 102 \
 103 Thanks for reading this file. For additional information, subscribe to the vlc mailing list on \ul http://www.videolan.org/.\ulnone \
 104 -- \
 105 Christophe Massiot <massiot@via.ecp.fr>, 6 Apr 2002, for the VideoLAN team.}