# Használat

## Parancssor

Az MPlayer egy komplex lejátszási sort használ. Először a globális opciók szerepelnek, például

    mplayer -vfm 5

majd a fájlnév után írt kapcsolók, amik csak a megadott fájlra/URL-re/bármire vonatkoznak, például:

    mplayer -vfm 5 movie1.avi movie2.avi -vfm 4

A fájlneveket/URL-eket csoportosíthatod a `{` és `}` segítségével. Ez főleg a `-loop` kapcsolóval együtt hasznos:

    mplayer { 1.avi -loop 2 2.avi } -loop 3

A fenti parancs a fájlokat ebben a sorrendben játsza le: 1, 1, 2, 1, 1, 2, 1, 1, 2.

Egy fájl lejátszása:

    mplayer [kapcsolók] [elérési út/]fájlnév

Több fájl lejátszása:

    mplayer [alapértelmezett kapcsolók] [elérési út/]fájlnév1 [fájlnév1 kapcsolói] fájlnév2 [fájlnév2 kapcsolói] ...

VCD lejátszása:

    mplayer [kapcsolók] vcd://sávszám [-cdrom-device /dev/cdrom]

DVD lejátszása:

    mplayer [kapcsolók] dvd://cím szám [-dvd-device /dev/dvd]

Lejátszás a WWW-ről:

    mplayer [kapcsolók] http://site.com/file.asf

(lejátszási listák is megadhatóak)

Lejátszás RTSP-ről:

    mplayer [kapcsolók] rtsp://server.example.com/streamName

Példák:

    mplayer -vo x11 /mnt/Films/Contact/contact2.mpg
    mplayer vcd://2 -cdrom-device /dev/hdc
    mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
    mplayer dvd://1 -dvd-device /dev/hdc
    mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi

## Vezérlés

Az MPlayer teljesen konfigurálható, parancsvezérelt, az irányítási rétegének a segítségével az MPlayert vezérelheted billentyűzettel, egérrel, joystickkal vagy távirányítóval (LIRC használatával). Olvasd el a man oldalon a használható billentyűk listáját.

### Vezérlés beállítása

Az MPlayer engedélyezi bármely billentyűhöz/gombhoz bármilyen MPlayer parancs hozzárendelését egy egyszerű konfigurációs fájl segítségével. A szintaxis egy egyszerű billentyű névből és az azt követő parancsból áll. A konfigurációs fájl alapértelmezett helye a `$HOME/.mplayer/input.conf` de ez megváltoztatható a `-input conf` kapcsoló segítségével (a relatív elérési útvonalak a `$HOME/.mplayer`-hez képest relatívak).

Az összes támogatott billentyű nevének listáját az `mplayer -input keylist` parancs írja ki, az elérhető parancsok listáját pedig az `mplayer -input cmdlist` paranccsal kapod meg.

#### Egy példa bemeneti vezérlő fájl

    ##
    ## MPlayer input control file
    ##

    RIGHT seek +10
    LEFT seek -10
    - audio_delay 0.100
    + audio_delay -0.100
    q quit
    > pt_step 1
    < pt_step -1
    ENTER pt_step 1 1

### Irányítás LIRC-ből

Linux Infrared Remote Control (Linux Infravörös Távoli Irányítás) - végy egy egyszerűen összerakható, otthon barkácsolt IR-vevőt, egy (majdnem) tetszés szerinti távirányítót és irányítsd a Linux-os gépedet vele! Bővebben a LIRC weboldalon olvashatsz erről.

Ha feltelepítetted a LIRC csomagot, a `configure` automatikusan megtalálja. Ha minden jól megy, az MPlayer egy ilyen üzenetet ír ki indításkor: "`Setting up lirc support...`". Ha valami hiba történt, tájékoztat róla. Ha semmit sem mond a LIRC-ről, akkor a támogatása nincs beforgatva. Ennyi :-)

Az MPlayer alkalmazás neve - minő meglepő - `mplayer`. Bármelyik mplayer parancsot használhatod és egyszerre több parancsot is megadhatsz egy lépésben, ha `\n` karakterrel választod el őket. Ne felejtsd el engedélyezni az ismétlés jelzőt (repeat flag) a `.lircrc` fájlban, ha van értelme (keresés, hangerő, stb.). Itt egy kivonat az én `.lircrc` fájlomból:

    begin
         button = VOLUME_PLUS
         prog = mplayer
         config = volume 1
         repeat = 1
    end

    begin
        button = VOLUME_MINUS
        prog = mplayer
        config = volume -1
        repeat = 1
    end

    begin
        button = CD_PLAY
        prog = mplayer
        config = pause
    end

    begin
        button = CD_STOP
        prog = mplayer
        config = seek 0 1\npause
    end

Ha nem tetszik a lirc-config fájl alapértelmezett elérési útvonala (`~/.lircrc`), használd a `-lircconf fájlnév` kapcsolót egy másik fájl megadásához.

### Szolga mód

A szolga mód segítségével egyszerű frontend-eket készíthetsz az MPlayerhez. Ha a `-slave` kapcsolóval futtatod az MPlayert, beolvassa az új sor karakterrel (\n) elválasztott parancsokat a standard bemenetről (stdin). A parancsok a slave.txt fájlban vannak leírva.

## Hálózati és pipe-os stream-elés

Az MPlayer HTTP, FTP, MMS vagy RTSP/RTP protokoll segítségével le tud játszani fájlokat hálózatról is.

A lejátszáshoz egyszerűen csak be kell írni az URL-t a parancssorba. Az MPlayer figyeli a `http_proxy` környezeti változót is, és használja a proxy-t, ha van. Azonban így is megadhatod a proxy-t:

    mplayer http_proxy://proxy.micorsops.com:3128/http://micorsops.com:80/stream.asf

Az MPlayer tud olvasni a standard bemenetről (stdin) is (nem nevesített pipe). Ezt például FTP-ről történő lejátszásnál tudod használni:

    wget ftp://micorsops.com/something.avi -O - | mplayer -

Tanácsos megadni a `-cache` kapcsolót, ha hálózatról játszol le:

    wget ftp://micorsops.com/something.avi -O - | mplayer -cache 8192 -

## Távoli stream-ek

A távoli stream-ek segítségévela legtöbb MPlayer által ismert stream típust elérheted egy távoli hoszt segítségével is. A fő célja ennek, hogy direkt módon használhasd egy másik számítógép CD vagy DVD meghajtóját hálózaton keresztül (feltéve, hogy megvan a megfelelő sávszélesség). Letöltési oldalon pár stream típus (jelenleg a TV és az MF) nem használhatóak távolról, mert a demuxer szintjén vannak implementálva. Ez sajnálatos az MF esetében, de a TV stream-hez úgyis eszeveszettül nagy sávszélesség kellene.

### A szerver fordítása

Miután lefordítottad az MPlayert, menj a `TOOLS/netstream` könyvtárba és add ki a make parancsot a szerver bináris elkészítéséhez. Ezután a netstream binárist bemásolhatod a megfelelő helyre (általában `/usr/local/bin` Linuxon).

### Távoli stream-ek használata

Először el kell indítanod a szervert azon a gépen, amit távolról el akarsz érni. Jelenleg a szerver nagyon kezdetleges és nincs parancssori kapcsolója, csak írd be a `netstream` parancsot. Ezután például le tudod játszani a szerverben lévő VCD második sávját:

    mplayer -cache 5000 mpst://servername/vcd://2

A szerveren lévő fájlokat is elérheted:

    mplayer -cache 5000 mpst://servername//usr/local/movies/lol.avi

Figyelj arra, hogy ha egy elérési útvonal nem / jellel kezdődik, akkor az a szerver futási helyéhez képest lesz relatív. A `-cache` kapcsoló nem szükséges, de nagyon ajánlott.

Vigyázz, a jelenlegi szerver semennyire sem biztonságos. Tehát ne panaszkodj a számos exploit miatt, ami esetleg kihasználhatja ezt. Inkább küldj néhány (jó) javítást, hogy jobb legyen vagy kezd el írni a saját szervered.

## Edit Decision Lists (EDL)

Az edit decision list (EDL) rendszer segítségével automatikusan kihagyhatsz vagy elnémíthatsz részeket videókban a lejátszás alatt, egy film specifikus EDL konfigurációs fájl segítségével.

Ez azoknak hasznos, akik "család-barát" módban szeretnének filmet nézni. Ki tudsz vágni bármilyen erőszakos, káromkodós, Jar-Jar Binks-es jelenetet egy filmből, a saját igényeidnek megfelelően. Mindemellett más felhasználási módok is vannak, például automatikusan átlépni a videó fájlokban lévő reklámokat.

Az EDL fájl formátuma eléggé egyszerű. Majd ha az EDL rendszer elér egy bizonyos fejlettségi szintet, egy XML alapú fájl formátum lesz implementálva valószínűleg (megtartva a kompatibilitást visszafelé, a régi EDL formátumokkal).

Az EDL bejegyzések maximális száma a jelenlegi EDL változatban 1000. Ha esetleg neked több kellene, változtasd meg a #define MAX_EDL_ENTRIES sort az `edl.h` fájlban.

### EDL fájl használata

Add meg a `-edl <fájlnév>` kapcsolót, amikor indítod az MPlayert, a videóhoz használni kívánt EDL fájl nevével.

### EDL fájl készítése

A jelenlegi EDL fájl formátum:

    [kezdés másodperce] [befejezés másodperce] [akció]

A másodpercek lebegőpontos számok, az akció pedig vagy `0` a kihagyáshoz vagy `1` az elnémításhoz. Például:

    5.3   7.1    0
    15    16.7   1
    420   422    0

Ez az 5.3 másodperctől a 7.1 másodpercig kihagyja a videót, majd 15 másodpercnél leveszi a hangot, 16.7 másodpercnél visszateszi és a 420. és 422. másodperc között ismét kihagy a videóból. Ezek az akciók akkor hajtódnak végre, amikor a lejátszás időzítője eléri a fájlban megadott időket.

Ha készíteni akarsz egy EDL fájl, amit utána szerkeszthetsz, használd a `-edlout <fájlnév>` kapcsolót. Lejátszás közben, ha meg akarod jelölni az előző két másodpercet kihagyásra, nyomd meg az i billentyűt. A megfelelő bejegyzés bekerül a fájlba erre az időszakra. Ezután kézzel tetszőlegesen beigazíthatod az EDL fájlt.