# Handbok &kmplayer;

## Inledning

&kmplayer; är ett enkelt gränssnitt till Mplayer, Xine, Gstreamer och FFMpeg. Du kan använda det för att titta på alla filmfilformat som Mplayer, Xine eller Gstreamer stöder, samt titta på en dvd, vcd eller tv och kamera.

Dokumentationen för &kappname; var inte klar när &kde; installerades på den här datorn.

Om du behöver mer hjälp, titta på KDE:s hemsida för uppdateringar, eller skicka din fråga till &kde;:s e-postlista för användare.

&kde;-gruppen

## Användargränssnittet

Programfönstret består av så kallade dockningsbara fönster. Det centrala visningsfönstret finns alltid. Dessutom finns ett valfritt spellistefönster. Slutligen finns ett informationsfönster, som bara visas när det finns någon information att visa.

### Spellistefönstret

Spellistefönstret har fem kategorier när det här skrivs, aktuella objekt, Optiska skivor, Television, Bevarade spellistor och Senaste. Vid ett klick på en kategoris text visas dess innehåll under linjen. Det måste förstås finnas något innehåll, se till exempel TV-inställningar om hur man lägger till innehåll för kategorin Television. Kategorin Senaste fylls i när lokala mediafiler eller nätverkswebbadresser spelas upp. Kategorin kan innehålla 60 objekt, varav de sista 50 är under grenen Mer....

#### Kategorin Bevarade spellistor

Det är möjligt att lagra dina favoritlänkar i menyn Bokmärken, men de är enskilda objekt. Om du vill skapa en lista med objekt som spelas i tur och ordning, ska du använda kategorin Bevarade spellistor.

Det enklaste sättet att lägga till ett objekt i listan är att dra det från Senaste och släppa det på Bevarade spellistor. Som du märker, visas en meny när du släpper det, där du kan välja att lägga till det i den här listan eller skapa en ny grupp. Objekt på översta nivån beter sig som bokmärkesobjekt, men objekt i grupper spelar upp hela gruppen som de ingår i. Objekt i kategorin kan enkelt flyttas, kopieras, läggas till i en ny grupp eller tas bort, bara genom att dra objektet till en annan plats i kategorin. Dessutom finns alternativen Ta bort objekt, Flytta upp och Flytta ner i den sammanhangsberoende menyn (vid klick med höger musknapp på ett objekt).

Du kan förstås lägga till grupper i grupper för att få en djupare hierarki. Vid klick på ett objekt, kopieras dess grupp och alla undergrupper till den aktuella kategorin, och uppspelning börjar på det klickade objektets position.

##### Lagringsformat

Data lagras i `~/.trinity/share/apps/kmplayer/playlist.xml`, och dess format är som i exemplet. Titta här om hur man hanterar denna data direkt.

    <playlist>
        <group title="feeds">
            <item url="http://www.lugradio.org/episodes.rss"/>
            <item url="http://science.nasa.gov/podcast.xml"/>
            <item url="http://www.theworld.org/rss/tech.xml"/>
        </group>
        <group title="iradio">
            <group title="sunny">
                <item mplayeropts="-cache 256" url="http://www.swissgroove.ch/listen.m3u"/>
                <item url="http://www.boombasticradio.com/shoutcast/64.pls"/>
            </group>
            <group title="rainy">
                <item url="http://www.radioparadise.com/musiclinks/rp_64.m3u"/>
                <item url="http://www.woxy.com/stream/wma64.asx"/>
                <item url="http://radionigel.com/winmedia.asx"/>
                <item url="rtsp://livestreams.omroep.nl/live/vpro/vpro3voor12radioalt.rm"/>
            </group>
        </group>
    </playlist>

Observera också att egna alternativ kan ställas in med väljaren `mplayeropts` för Mplayer. &kmplayer; söker uppåt i trädet efter väljaren, så du kan ställa in den för en hel grupp och överskrida den för en undergrupp eller för ett objekt.

### Direkt XML-redigering

Kategorierna Senaste, Television och Bevarade spellistor kan också hanteras genom att redigera deras XML-lagring. Man kan förstås göra det när &kmplayer; inte kör, och redigera de olika filerna i `~/.trinity/share/apps/kmplayer/`, men också i själva programmet. Klicka helt enkelt på en kategorirubrik, välj därefter Visa och sedan Redigeringsläge. Du kan också klicka på en undergren och då ser du bara XML-innehållet för grenen.

Efter du har redigerat en del XML, klicka på Synkronisera med spellista och avmarkera antingen alternativet Redigeringsläge eller klicka på en annan kategori.

Alla ändringar går förlorade om du lämnar redigeringsläge eller väljer en annan gren utan att synkronisera med spellistan.

På grund av lättja hos &kmplayer;s upphovsmän, kan vissa funktioner bara aktiveras genom att redigera XML.

## Inställningar

### Animering vid start och avslutning

Att inaktivera start- och slutanimeringen kan utföras genom att redigera `~/.trinity/share/config/kmplayerrc` och ändra

    [General Options]
      No Intro=0

ovanstående alternativ till '1'. Lägg bara till alternativet om det inte redan finns där.

Det är också möjligt att ange alternativa animeringar. &kmplayer; tittar på `~/.trinity/share/apps/kmplayer/intro.xml` och `~/.trinity/share/apps/kmplayer/exit.xml`. Formatet måste vara en XML-fil som stöds.

Den inledande animeringen behöver inte vara kort, eftersom den automatiskt slutar när en annan källa öppnas. Det skulle förstås vara något irriterande för slutanimeringen, men användaren kan alltid avsluta programmet två gånger.

Ett enkelt exempel på en inledning, som visar ditt favoritfoto skulle kunna vara

    <smil>
      <body>
        <img dur="indefinite" src="///home/användare/mamma.gif" fit="meet"/>
      </body>
    </smil>

I &kmplayer;s källkodspaket, under `tests/` finns några exempel på SMIL som &kmplayer; stöder.

## Uppspelningsgränssnitten

&kmplayer; använder externa program för att utföra själva uppspelningen.

### Mplayer

Det finns en inställningsflik för Mplayer i &kmplayer;s inställnigsdialogruta. Där kan man bland annat ställa in sökvägen till Mplayer och dess cachestorlek för nätverksströmmar.

Spelarens inställningsnamn är `mplayer`.

#### Felsökning

Det bästa sättet att felsöka i gränssnittet är att starta &kmplayer; från ett terminalprogram som konsole. Starta därefter en film med Kmplayer och se exakt den kommandorad som används för att starta Mplayer i terminalprogrammet. Kopiera och tdelistra nu in den i ett annat terminalprogram, ta bort väljaren '-wid 12344' och spela den. Troligen är det bara att välja rätt parametrar för -ao och -vo. Försäkra dig också om att Mplayer inte är förinställt att starta med ett grafiskt gränssnitt.

Ett annat felsökningsverktyg är knappen 'Terminal' i Kmplayers verktygsrad. Där kan du se utmatningen från Mplayer.

### Xine

När &kmplayer; är konfigurerad med stöd för Xine, finns det inställningsflikar för Xine i &kmplayer;s inställningsdialogruta. Där kan du ställa in diverse alternativ. Alternativen hämtas dynamiskt från Xines bibliotek. Använd den sammanhangsberoende hjälpen för att få information om vad alternativen gör (dvs. klicka på frågetecknet i dialogrutans namnlist och klicka därefter på ett alternativ).

Spelarens inställningsnamn är `xine`.

Alternativen sparas i `.kde/share/apps/kmplayer/xine_config` som ett textdokument.

#### Felsökning

Huvudsakligen samma sätt att felsöka som för Mplayer, men med programnamnet `kxineplayer`.

### Gstreamer

Det finns ingen inställningsflik för Gstreamer i &kmplayer;s inställningsdialogruta. De vanliga alternativen för t.ex. dvd-enheter används när det passar.

Spelarens inställningsnamn är `gstreamer`.

#### Felsökning

Huvudsakligen samma sätt att felsöka som för Mplayer, men med programnamnet `kgstplayer`.

### Insticksprogram för bläddring

Det finns ingen inställningsflik för spelaren i &kmplayer;s inställningsdialogruta. Allting måste ställas in genom att redigera `~/.trinity/share/config/kmplayerrc` för hand, liksom vid inställning av uppspelningsgränssnitt per Mime-typ. Här är ett exempel på hur man kan få Flash att spelas upp med insticksprogrammet swfdec-mozilla:

    [application/x-shockwave-flash]
    player=npp
    plugin=/usr/lib/mozilla/plugins/libswfdecmozilla.so

Du kan spela upp Flash inne i &kmplayer;. I själva verket kan du till och med tdelistra in det särskilda fältet `embed` för YouTube i spellistans XML.

För att låta &kmplayer; spela upp Flash på HTML-sidor, ska du ställa in &kmplayer;-insticksprogrammet att vara den tjänst som tillhandahåller Mime-typen `application/x-shockwave-flash` i KDE:s inställningsdialogruta Filbindningar.

Som i föregående exempel, är spelarens inställningsnamn `npp`.

#### Felsökning

Starta Konqueror eller &kmplayer; i ett terminalprogram och titta efter fel när biblioteket för insticksprogrammet för bläddring laddas. Processen som startas kallas `knpplayer`. Om det inte finns några fel, kontrollera uppspelningsgränssnittets utmatning inne i &kmplayer; (Visa Terminal, eller Terminal i den sammanhangsberoende menyn).

### Tvinga uppspelningsgränssnitt för en viss Mime-typ

Att ändra inställningen så att ett givet gränssnitt alltid används för en viss Mime-typ (naturligtvis enbart om den har detekterats) kan göras genom att redigera filen `~/.trinity/share/config/kmplayerrc` för hand. För att till exempel låta Xine spela upp alla ogg-filer:

    [audio/ogg]
    player=xine

## Källor som kan spelas upp

&kmplayer; kan spela upp olika källor. Dessa källor listas i menyn Källa.

### Tv

&kmplayer; kan spela från tv-kort med Mplayer eller Xvideo (med användning av kxvplayer). Innan du kan titta på tv måste du ställa in vilken enhet som ska användas, och tv-kanalerna. Du kan använda sökfunktionen i inställningsdialogrutan för detta, eller redigera inställningsfilen för hand.

Inställningsfilen för tv-inställningarna är en XML-fil, med namnet `~/.trinity/share/apps/kmplayer/tv.xml`. Titta här om hur man hanterar denna data direkt. XML-formatet är som följande exempel:

    <tvdevices>
        <device path="/dev/video0" width="320" height="240" name="BT878 video (Hauppauge (bt878))" audio=""
                  minwidth="48" minheight="32" maxwidth="924" maxheight="576" playback="0" xvport="240">
            <input name="Television" id="0" tuner="1" norm="PAL" xvenc="0">
                <channel name="Ned1" frequency="21600"/>
                <channel name="VCR" frequency="59490"/>
            </input>
            <input name="Composite1" id="1" xvenc="7"/>
            <input name="S-Video" id="2" xvenc="14"/>
            <input name="Composite3" id="3"/>
        </device>
        <device path="/dev/video1" width="640" height="480" name="Philips 740 webcam" audio=""
                  minwidth="160" minheight="120" maxwidth="640" maxheight="480" playback="1">
            <input name="Webcam" id="0"/>
        </device>
    </tvdevices>

Observera att elementen input som har kanaler, ska ha egenskapen tuner inställd till 1.

Xvideo använder bara egenskaperna xvport och xvenc och kan bara ställas in genom att redigera filen för hand. Värden för de två egenskaperna kan hämtas genom att köra kxvplayer i ett terminalfönster som konsole. För varje port skriver kxvplayer ut rader som visas nedan, och värdena kan ställas in för de nämnda egenskaperna.

        xvport 240
        ....
        encoding: 0 PAL-television
        encoding: 1 NTSC-television
        encoding: 2 SECAM-television
        ....

Dessutom ignoreras egenskaperna bredd och höjd av Xvideo-spelaren. Spelaren hämtar storlekarna från X-servern. En av de trevliga sakerna med Xvideo är att skalning görs i hårdvara av videokortet, vilket ger stöd för fullskärmsvisning utan processoranvändning och utan att ändra bildskärmens upplösning. Dessutom uppstår inget irriterande flimmer när ett annat fönster överlappar videofönstret.

Se avsnittet VDR för mer information om att använda Xvideo.

### VDR

För att ställa in VDR-inställningar i Kmplayer, använd inställningsrutan Källa -> VDR -> Xvideo port. Det ska finnas detekterade portar, där du ska välja en. Du måste räkna ut vilken kodning du ska använda (i västeuropa är det t.ex. PAL) och troligen har den rätta ett namn som innehåller dvb.

Jag har till exempel ett tv-kort, ett DVB-S kort och en webbkamera inkopplade i mitt system. Med dessa har mina inställningar tre portar. Den första har en lång lista med NTSC(-JP)/PAL(-M)/SECAM-poster som alla innehåller något med television/composite/svideo (mitt tv-kort). Den andra har NTSC-dvb/PAL-dvb/SECAM-dvb (mitt DVB-S kort). Den tredje har slutligen bara ntsc/pal (troligen min webbkamera). Därför ska jag ställa in (bara genom att markera den) den andra porten och andra posten (PAL-dvb).

Eftersom VDR-stöd i Kmplayer bara kan använda Xvideo, måste förstås Xvideo fungera (och jag tror att detta sätt att titta på videoenheter bara fungerar med Linux). Detta fungerar också bara på den första skärmen (:0.0). Försäkra dig alltså om att utökningen videoforlinux fungerar med X-servern. För XFree86-servern, ska följande finnas i inställningsfilen (`/etc/X11/XF86Config`):

    Section "Module"
         ....
         Load    "v4l"
    EndSection

Tyvärr måste du ställa in det här alternativet igen så fort du uppdaterar din videodrivrutin.

### Kommandorad

Internt använder &kmplayer; distinkta namn för källor. När det här skrivs är de "dvdnavsource", "dvdsource", "exitsource", "hrefsource", "introsource", "pipesource", "tvscanner", "tvsource", "urlsource", "vcdsource" och "vdrsource". När de aktiveras börjar de oftast spela listan med spelbara objekt.

Du kan aktivera en viss källa med webbadressen `kmplayer://`. Ange bara värddatordelen som källans namn och den valfria delen som extra argument, vilket skulle kunna se ut som `kmplayer://vdrsource/22 MTV 2` för en kanal från "vdrsource". Till exempel startar följande skript Kmplayer med "dvdnavsource" och använder DCOP för att spela upp med fullskärmsläge.

    /bin/bash
    kmplayer kmplayer://dvdnavsource/ &
    PID=$!
    sleep 2
    dcop kmplayer-$PID KMediaPlayer toggleFullScreen

Det gör inte mycket för vissa källor, eftersom de inte är avsedda för normal uppspelning. Det är inaktiverat för "pipesource", eftersom det naturligtvis skulle vara ett allvarligt säkerhetshål.

## Frågor, svar och tips

## Vanliga frågor

Xine startar långsamt, varför måste det mäta min processorprestanda hela tiden?

Observera att svaret nedan är föråldrat. kxineplayer sparar den automatiskt i det senaste värdet, så xine gör bara processortesten första gången.

Gränssnittet till Xine i &kmplayer;, kxineplayer, använder `~/.trinity/share/apps/kmplayer/xine_config` för sina inställningar. Inställningar för Xine finns i inställningsdialogrutan General Options|Xine. (Om du ändrar ett alternativ här och sparar det, innehåller `~/.trinity/share/apps/kmplayer/xine_config` också en del förklaringar). Mätningen av processorprestanda orsakas av att alternativet `misc.memcpy_method` är inställt till `probe`. För att ta reda på vilken version av minneskopiering som är snabbast för dig, aktivera Visa terminalutmatning i menyn Visa och titta på resultatet av mätningen när du spelar någonting med Xine. Ställ in `misc.memcpy_method` till metoden med kortast tid.

Några tips för att göra cdrom-enheten tystare när den används för uppspelning (inte VCD://)?

Visst, prova `hdparm -E 8 /dev/cdrom` som systemadministratör, efter att ha monterat enheten. Men försäkra dig om att du dubbelkollar att `/dev/cdrom` pekar på cdrom-enheten.

## Tack till och licenser

&kmplayer; copyright 2002, 2003 Koos Vriezen

&underFDL; &underGPL;
&documentation.index;