# Manuale di &kmplayer;

## Introduzione

&kmplayer; è una semplice interfaccia per MPlayer, Xine and GStreamer e FFMpeg. Puoi usarlo per vedere tutti i formati video filmati che MPlayer, Xine o GStreamer supportano, e anche vedere DVD, VCD, TV o telecamere.

La documentazione di &kappname; non era pronta quando &kde; è stato installato su questo computer.

Se hai bisogno di aiuto, per piacere visita il sito web di KDE per aggiornamenti, o manda la tua domanda alla Mailing list utenti &kde;.

Il gruppo di &kde;

## L'interfaccia utente

La finestra dell'applicazione è composta da finestre cosiddette agganciabili. C'è sempre la finestra di vista centrale. Opzionalmente c'è anche la finestra della scaletta. Infine c'è una finestra di informazioni, che si fa vedere quando ci sono informazioni da comunicare.

### Finestra della scaletta

La finestra della scaletta ha, al momento della stesura di questo documento, cinque categorie: gli elementi attuali, Dischi ottici, Televisione Scalette persistenti e Più recenti. Quando si fa clic sul testo di una categoria, ne saranno mostrati i contenuti. Ovviamente questi dovrebbero innanzi tutto esserci, per esempio vedi le impostazioni della TV per aggiungere la categoria Televisione. La categoria Più recenti si riempirà quando si riproducono file multimediali sul tuo computer o da un URL in rete. Questa categoria può contenere fino a 60 elementi, di cui gli ultimi 50 sono raggruppati sotto Altri....

#### Categoria delle scalette persistenti

È possibile salvare le i tuoi collegamenti preferiti nel menu dei Segnalibri, ma sarebbero elementi singoli. Se vuoi creare un elenco di elementi da riprodurre in sequenza, dovresti usare la categoria delle Scalette persistenti.

Il modo più semplice di aggiungere un elemento in questo elenco è trascinarlo da Più recenti in Scalette persistenti. Come vedrai, quando lo metti lì, appare un menu a comparsa dove puoi scegliere di aggiungerlo alla scaletta o creare un nuovo gruppo. Gli elementi di massimo livello si comportano come dei segnalibri, ma gli elementi nei gruppi leggeranno tutto il gruppo in cui si trovano. Gli elementi di questa categoria si possono facilmente spostare, copiare, aggiungere a un nuovo gruppo o eliminare solo trascinandoli in un altro posto. Inoltre ci sono i comandi Elimina elemento, Sposta in alto, Sposta in basso nel menu contestuale (che si ottiene facendo clic destro su un elemento).

Ovviamente puoi aggiungere gruppi ad altri gruppi per avere una gerarchia ramificata. Quando fai clic su un elemento, il suo gruppo e tutti i suoi gruppi figli saranno copiati nella categoria attuale, e la lettura comincerà dalla posizione dell'elemento su cui si è fatto clic.

##### Formato di memorizzazione

I dati sono memorizzati in `~/.trinity/share/apps/kmplayer/playlist.xml`, e il suo formato è come un questo esempio. Vedi qui per sapere come manipolare i dati direttamente.

    <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>

Nota anche che per MPlayer si possono impostare delle opzioni personalizzane usando l'argomento `mplayeropts`. &kmplayer; cerca questa opzione andando in alto nell'albero, quindi puoi impostarla per un intero gruppo sostituendo le impostazioni di un gruppo o elemento figlio.

### Modifica diretta dei file XML

Le categorie attuali, Televisione e Scalette persistenti possono essere manipolate anche modificando il loro file XML associato. Ovviamente lo si può fare quando &kmplayer; non è in esecuzione e non sta modificando i vari file in `~/.trinity/share/apps/kmplayer/`, ma anche dall'applicazione. Basta fare clic sull'etichetta di una categoria, scegliere Visualizza e poi Modalità di modifica. Puoi anche fare clic su un ramo figlio, e allora vedrai solo i contenuti XML del ramo.

Dopo che hai modificato l'XML, fai clic su Sincronizza con scaletta e deseleziona la Modalità di modifica o fai clic su un'altra categoria.

Tutte le modifiche vengono perse se lasci la modalità di modifica o selezioni un'altro ramo senza sincronizzare con la scaletta.

A causa della pigrizia dell'autore di &kmplayer;, alcune funzionalità si possono abilitare solo attraverso modifiche del codice XML.

## Impostazioni

### Animazione introduttiva e di uscita

È possibile disattivare l'animazione di avvio e di uscita modificando `~/.trinity/share/config/kmplayerrc` e cambiando

    [General Options]
      No Intro=0

questa opzione a '1'. Se l'opzione non c'è, basta aggiungerla.

È anche possibile impostare un'animazione alternativa. KMPlayer cercherà rispettivamente `~/.trinity/share/apps/kmplayer/intro.xml` e `~/.trinity/share/apps/kmplayer/exit.xml`. Il formato deve essere un file XML supportato.

L'animazione di avvio non deve essere breve, perché terminerà automaticamente quando viene aperta un'altra sorgente. Ovviamente ciò sarebbe un po' fastidioso per l'animazione di uscita, ma l'utente può sempre terminare l'applicazione due volte.

Un semplice esempio di introduzione, che mostra le tue foto preferite, potrebbe essere:

    <smil>
      <body>
        <img dur="indefinite" src="file:///home/pippo/mamma.png" fit="meet"/>
      </body>
    </smil>

Nel pacchetto sorgente di KMPlayer, nella cartella `tests/`, ci sono degli esempi di SMIL supportati da KMPlayer.

## I lettori

&kmplayer; usa dei programmi esterni per la lettura dei file.

### MPlayer

C'è una scheda di configurazione per MPlayer nella finestra di configurazione di &kmplayer;. Qui puoi impostare il percorso di MPlayer e le dimensioni della sua cache per i flussi di rete, tra le altre cose.

#### Risoluzione dei problemi

Il modo migliore di risolvere i problemi legati a questo lettore è avviare &kmplayer; da una console. Avvia un filmato con &kmplayer; e guarda la riga di comando esatta che viene usata per avviare MPlayer nella console. Ora copia e incolla in un'altra console, rimuovi le o opzioni '-wid 12344', e fallo partire. Probabilmente si tratta solo di scegliere i parametri giusti per -ao/-vo. Assicurati anche che MPlayer non parta con un'interfaccia grafica.

Un altro strumento per risolvere i problemi è il pulsante Console nella barra degli strumenti di &kmplayer;. Qui puoi vedere l'output di MPlayer.

### Xine

Quando &kmplayer; è configurato per supportare Xine, ci sarà una scheda relativa per la configurazione di Xine nella finestra di configurazione di &kmplayer;. Qui puoi impostare varie opzioni. Queste sono recuperate dinamicamente dalla libreria di Xine. Usa l'aiuto contestuale per avere informazioni su cosa fanno le opzioni (cioè fai clic sul punto interrogativo sulla barra del titolo della finestra e fai clic su un'opzione).

Le opzioni vengono salvate in `.kde/share/apps/kmplayer/xine_config` come file di testo.

#### Risoluzione dei problemi

Fondamentalmente la risoluzione dei problemi funziona come per MPlayer, con il nome di applicazione `kxineplayer`.

### GStreamer

Non c'è nessuna scheda di configurazione per GStreamer nella finestra di configurazione di &kmplayer;. Le opzioni comuni per i dispositivi come i DVD vengono usate secondo opportunità.

#### Risoluzione dei problemi

Fondamentalmente la risoluzione dei problemi funziona come per MPlayer, con il nome di applicazione `kgstplayer`.

## Le sorgenti riproducibili

&kmplayer; può riprodurre diverse sorgenti. Queste sono elencate nel menu Sorgente.

### TV

&kmplayer; può usare le schede TV usando MPlayer o XVideo (usando kxvplayer). Prima di poter vedere la TV, devi configurare quale dispositivo usare e i canali televisivi. Puoi usare il programma di scansione dalla finestra di configurazione, oppure puoi configurare il file manualmente.

Il file di configurazione per le impostazioni della TV è un file XML, posizionato a `~/.trinity/share/apps/kmplayer/tv.xml`. Vedi qui per la manipolazione diretta di questi dati. Il formato XML è come in questo esempio:

    <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>

Nota che gli elementi input con dei canali dovrebbero avere l'attributo tuner impostato a 1.

XVideo usa solo gli attributi xvport e xvenc, e possono essere impostati manualmente solo modificando questo file. I valori di questi attributi possono essere recuperati usando kxvplayer in un'applicazione di terminale come &konsole;. Per ogni porta, kxvplayer scriverà delle righe come le seguenti, e si possono impostare i numeri per gli attributi di cui si è parlato.

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

Anche gli attributi di altezza e larghezza sono ignorati dal lettore XVideo. Questo lettore ottiene le dimensioni dal server X. Una delle cose carine di XVideo è che la scala è fatta dall'hardware, dalla scheda video, quindi è possibile avere il supporto a schermo intero senza uso di CPU e senza cambio di risoluzione del tuo monitor. Inoltre, non ci sarà un noioso sfarfallio quando un'altra finestra si sovrapporrà a questa finestra video.

Vedi la sezione VDR per maggiori informazioni sull'uso di XVideo.

### VDR

Per configurare le tue impostazioni VDR in kmplayer, vedi il pannello Configura pannello->Sorgente->VDR->Porta XVideo. Ci dovrebbero essere le porte rilevate, tra cui dovresti sceglierne una. Devi decidere quale codifica usare (per esempio PAL per l'europa occidentale), e probabilmente quella giusta ha un nome contenente dvb.

Per esempio, io ho una scheda TV, una scheda DVB-S e una webcam nel mio sistema. Con questi, ho tre porte nelle mie impostazioni. La prima è un lungo elenco di voci NTSC(-JP)/PAL(-M)/SECAM, tutte riguardo a un television/composite/svideo (la mia scheda TV). La seconda contiene NTSC-dvb/PAL-dvb/SECAM-dvb (la mia scheda DVB-S). Infine, la terza contiene solo ntsc/pal (probabilmente la mia webcam). Quindi dovrei configurare la seconda porta (basta selezionarla) e la seconda voce (PAL-dvb).

Siccome il supporto VDR di &kmplayer; può usare solo XVideo, XVideo deve ovviamente funzionare (credo che per i dispositivi video, questo modo di visualizzazione funzioni solo in Linux). Ciò funziona solo sul tuo primo schermo (:0.0). Perciò assicurati che l'estensione videoforlinux funzioni nel server X. Per il server XFree86, nel suo file di configurazione (`/etc/X11/XF86Config`), dovrebbe esserci

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

Sfortunatamente, quando aggiorni il tuo driver video, devi riconfigurare questa impostazione.

### Riga di comando

Internamente, KMPlayer usa diversi nomi per le sorgenti. Al momento della scrittura questi erano "dvdnavsource", "dvdsource", "exitsource", "hrefsource", "introsource", "pipesource", "tvscanner", "tvsource", "urlsource", "vcdsource" e "vdrsource". Quando attivi, cominciano a riprodurre l'elenco di elementi riproducibili.

Puoi attivare una sorgente particolare con un URL di tipo `kmplayer://`. Basta impostare la parte host come il nome della sorgente e la parte del percorso opzionale come argomenti aggiuntivi; quindi per un canale per "vdrsource" potrebbe essere: `kmplayer://vdrsource/22 MTV 2`. Per esempio, questo script avvia KMPlayer usando "dvdnavsource" e usando DCOP per riprodurre a schermo intero.

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

Per alcune sorgenti ciò non farà molto, perché non sono fatte per la riproduzione normale. Per "pipesource" questo è disattivato perché sarebbe una pericolosa falla nella sicurezza.

## Domande, risposte e suggerimenti

## Domande frequenti

Xine si avvia lentamente, perché deve fare benchmark della mia CPU in continuazione?

Nota che la risposta sotto è obsoleta. kxineplayer salva automaticamente l'ultimo valore, quindi solo xine farà il test della CPU solo la prima volta.

L'interfaccia di &kmplayer; per Xine, kxineplayer, usa `~/.trinity/share/apps/kmplayer/xine_config` per la sua configurazione. Le impostazioni di Xine si trovano nella finestra di configurazione Opzioni generali|Xine (Se cambi un'opzione qui e la salvi, anche `~/.trinity/share/apps/kmplayer/xine_config` conterrà delle spiegazioni). Il benchmarking della CPU è causato dall'opzione `misc.memcpy_method` impostata a `probe`. Per vedere quale versione di memcpy funziona più velocemente per te, attiva Mostra output della console dal menu Visualizza, e guarda i risultati di questo benchmark quando riproduci qualcosa con Xine. Configura `misc.memcpy_method` con il metodo con il tempo più basso.

Ci sono trucchi per rendere il mio CDROM meno rumoroso quando sto riproducendo qualcosa (non VCD://)?

Certo, prova `hdparm -E 8 /dev/cdrom` come root dopo aver montato il dispositivo. Assicurati di controllare bene che `/dev/cdrom` punti al tuo dispositivo CDROM.

## Riconoscimenti e licenza

&kmplayer; copyright 2002,2003 Koos Vriezen

&underFDL; &underGPL;
&documentation.index;