mirror of
https://github.com/mpv-player/mpv
synced 2024-12-22 23:02:37 +00:00
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@6244 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
parent
c04588fedf
commit
6f65fb8208
186
README
186
README
@ -1 +1,185 @@
|
||||
The main documentation file is DOCS/documentation.html
|
||||
|
||||
Welcome to MPlayer, the Unix movie player. MPlayer can play most standard video
|
||||
formats out of the box and almost all others with the help of external codecs.
|
||||
MPlayer currently works best from the command line, but there is a GUI with
|
||||
skin support in the alpha development stage.
|
||||
|
||||
This document is for getting you started in a few minutes. It cannot answer
|
||||
all of your questions. If you have problems, please read the documentation in
|
||||
DOCS/documentation.html. It is extensive and should answer most of your
|
||||
questions. Also read the manpage to learn how to use MPlayer.
|
||||
|
||||
To compile MPlayer with X11 support, you need to have the XFree86 development
|
||||
packages installed, for the GUI you also need the GTK development packages.
|
||||
|
||||
Before you start...
|
||||
Unless you know what are you doing, consult DOCS/video.html to see which
|
||||
driver you should get for your video card to have the best quality and video
|
||||
performance. Most cards require special drivers not included with standard X11,
|
||||
to drive the 2-D video acceleration features of your card!
|
||||
|
||||
A quick and incomplete list of recommendations:
|
||||
- ATI cards: get the GATOS drivers for X11/Xv or use vidix
|
||||
- Matrox G200/G4x0/G550: compile and use mga_vid for Linux, use vidix for BSD
|
||||
- 3dfx Voodoo3/Banshee: get XFree86 4.2.0+ for Xv or use the tdfxfb driver
|
||||
- nVidia cards: get the X11 driver from www.nvidia.com for Xv support
|
||||
Without having accelerated video, even a 800MHz P3 may be slow to play DVD!
|
||||
|
||||
___________________________________
|
||||
STEP1: Installing FFmpeg libavcodec
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
If you are using an official release, skip this step, since official releases
|
||||
always include libavcodec. To verify this check if the libavcodec subdirectory
|
||||
is empty or contains the sources!
|
||||
|
||||
The FFmpeg project provides libavcodec, a very portable MPEG4/DivX codec with
|
||||
excellent speed and quality. It is the preferred codec of MPlayer for playing
|
||||
mpeg4 and divx video. You have to get libavcodec directly from the FFmpeg CVS
|
||||
server. Use the following commands in a suitable directory outside the MPlayer
|
||||
source directory:
|
||||
|
||||
cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login
|
||||
cvs -z9 -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg co ffmpeg/libavcodec
|
||||
|
||||
When asked for a password, you can just hit enter.
|
||||
|
||||
Now, replace the empty libavcodec directory with the FFmpeg libavcodec source
|
||||
by removing the libavcodec subdirectory in the MPlayer source tree and then
|
||||
copying (symbolic linking does not suffice!) the freshly downloaded FFmpeg
|
||||
libavcodec directory back into the MPlayer source tree.
|
||||
|
||||
|
||||
______________________________
|
||||
STEP2: Installing Win32 Codecs
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
While MPlayer and libavcodec has built-in support for the most common audio
|
||||
and video formats, some others are playable only with the Win32 DLLs
|
||||
or the XAnim binary plugins. Few examples: WMV video, Divx/WMA audio, Indeo.
|
||||
This step is not mandatory, but recommended for getting MPlayer to play
|
||||
play more different file types!
|
||||
|
||||
Grab the win32 codecs package from the download page
|
||||
|
||||
http://www.mplayerhq.hu/homepage/dload.html
|
||||
|
||||
unpack it and put the contents in a directory where MPlayer will find them.
|
||||
The default directory is /usr/lib/win32/ but you can change that to something
|
||||
else by using the '--with-win32libdir=DIR' option when you run './configure' .
|
||||
|
||||
__________________________
|
||||
STEP3: Configuring MPlayer
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
MPlayer has a lot of options that get selected in this phase. Run
|
||||
|
||||
./configure
|
||||
|
||||
to configure MPlayer with the default options. The options you installed above
|
||||
should be autodetected, except GUI support, which has to be enabled separately,
|
||||
run
|
||||
|
||||
./configure --enable-gui
|
||||
|
||||
if you want to use the GUI.
|
||||
|
||||
If something does not work as expected, try
|
||||
|
||||
./configure --help
|
||||
|
||||
to see the available options and select what you need.
|
||||
|
||||
The ./configure script prints a summary of enabled and disabled options.
|
||||
If you have something installed that ./configure fails to detect, check
|
||||
the file configure.log for errors and reasons for the failure. Repeat this
|
||||
step until you are satisfied with the enabled feature set.
|
||||
|
||||
________________________
|
||||
STEP4: Compiling MPlayer
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Now you can start the compilation by typing
|
||||
|
||||
make
|
||||
|
||||
You can install MPlayer with
|
||||
|
||||
make install
|
||||
|
||||
provided that you have write permission in the installation directory.
|
||||
|
||||
If all went well, you can run MPlayer by typing 'mplayer'
|
||||
You should get a summary of the most common options and keys (help screen).
|
||||
|
||||
If you get 'unable to load shared library' or similar errors, then run
|
||||
'ldd ./mplayer' to check which libraries fail and go back to STEP 3 to fix it.
|
||||
Sometimes just running 'ldconfig' is enough.
|
||||
|
||||
NOTE: If you run Debian you can configure, compile and build a proper deb
|
||||
package with only one command:
|
||||
|
||||
fakeroot debian/rules binary
|
||||
|
||||
____________________________________________
|
||||
STEP5: Installing the onscreen display fonts
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
To enable OSD (onscreen status display) and ASCII/TEXT subtitles you need some
|
||||
fonts. Get them from our homepage:
|
||||
|
||||
http://www.mplayerhq.hu/homepage/dload.html
|
||||
|
||||
Unpack the archive and choose one of the available font sizes. Then copy the
|
||||
font files of the corresponding size into /usr/local/share/mplayer/font/
|
||||
(or whatever you set with './configure --datadir=DIR').
|
||||
|
||||
____________________________
|
||||
STEP6: Installing a GUI skin
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Please remember that the GUI is still in the alpha development stage and not
|
||||
completely finished yet. Features like playlist, preferences and equalizer
|
||||
do not work at all. Expect them for the 1.0 release
|
||||
Basic stuff like file selection and seeking works, though.
|
||||
|
||||
If you want to use the GUI you need to download a skin, since MPlayer does not
|
||||
come with a skin by default. Choose one from the download page
|
||||
|
||||
http://www.mplayerhq.hu/homepage/dload.html
|
||||
|
||||
unpack it in /usr/local/share/mplayer/Skin/. MPlayer will use the skin in
|
||||
the default/ subdirectory (/usr/local/share/mplayer/Skin/default/*) unless
|
||||
told otherwise via the '-skin' switch. You should therefore rename your
|
||||
skin subdirectory, make a suitable symbolic link or set the skin name in
|
||||
the file mplayer.conf by 'skin=skinname'.
|
||||
|
||||
__________________
|
||||
STEP7: Let's play!
|
||||
~~~~~~~~~~~~~~~~~~
|
||||
|
||||
That's it for the moment. To start playing movies, open a command line and try
|
||||
|
||||
mplayer <moviefile>
|
||||
|
||||
or for the GUI:
|
||||
|
||||
gmplayer <moviefile>
|
||||
(just 'gmplayer' is enough to use the GUI fileselector)
|
||||
|
||||
To play VCD track or DVD title, try:
|
||||
|
||||
mplayer -vcd 2 -cdrom-device /dev/hdc
|
||||
mplayer -dvd 1 -alang en -slang hu -dvd-device /dev/hdd
|
||||
|
||||
See 'mplayer -help' and 'man mplayer' for further options.
|
||||
|
||||
'mplayer -vo help' will show you the available video output drivers. Experiment
|
||||
with the '-vo' switch to see which one gives you the best performance!
|
||||
If you get very jerky playback or no sound, experiment with -ao (see -ao help)
|
||||
Note that jerky playback is caused by buggy audio drivers or too slow cpu/vga.
|
||||
With a good audio and video driver combination, one can play DVDs and 720x576
|
||||
DivX files smoothly on a Celeron 366. For slower systems, you need -framedrop.
|
||||
|
||||
Questions you may have are probably answered in the rest of the documentation.
|
||||
The place to start reading is DOCS/faq.html and DOCS/documentation.html.
|
||||
|
Loading…
Reference in New Issue
Block a user