# Manuale di &kmplayer;

## Introduzione

&kmplayer; è una semplice interfaccia per MPlayer, &phonon; e FFMpeg. Puoi usarlo per vedere tutti i formati video supportati da MPlayer e &phonon;, 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, 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 `~/.kde/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 `~/.kde/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 `~/.kde/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 `~/.kde/share/apps/kmplayer/intro.xml` e `~/.kde/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.

Il nome di questa configurazione del lettore è `mplayer`.

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

### Phonon

&phonon; è l'infrastruttura multimediale per l'intero ambiente &kde;, e può essere configurato nelle &systemsettings;.

Il nome di questa configurazione del lettore è `phonon`.

#### Risoluzione dei problemi

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

### Estensione del browser

Non c'è una scheda di configurazione per questo lettore nella finestra di configurazione di &kmplayer;. Tutto va configurato modificando a mano il file `~/.kde/share/config/kmplayerrc` con la configurazione dell'interfaccia per il tipo MIME. Ecco un esempio di come riprodurre Flash con l'estensione swfdec-mozilla:

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

Puoi riprodurre Flash in &kmplayer;, e puoi anche incollare il campo speciale `embed` di YouTube nella scaletta &XML;.

Per poter far leggere Flash a &kmplayer; nelle pagine HTML, devi compilare l'estensione di &kmplayer; per il fornitore di servizi per il tipo MIME `application/x-shockwave-flash` nella finestra di configurazione di &kde; Associazioni dei file.

Come nell'esempio sopra, il nome di questa configurazione del lettore è `npp`.

#### Risoluzione dei problemi

Avvia &konqueror; o &kmplayer; in una console e cerca eventuali errori di caricamento della libreria dell'estensione per il browser. Il processo avviato è chiamato `knpplayer`. Se non presenta errori, controlla l'output dell'interfaccia di cattura di &kmplayer; (Visualizza Console o Console dal menu contestuale).

### Forza un lettore di interfaccia per un tipo MIME

Per usare sempre una certa interfaccia per un particolare tipo MIME (sempre che sia stato rilevato) si deve modificare a mano il file `~/.kde/share/config/kmplayerrc`. Per esempio, per far leggere a Phonon tutti i file ogg:

    [audio/ogg]
    player=phonon

## 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 `~/.kde/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). Inoltre, ciò funziona solo sul tuo primo display (:0.0). Perciò assicurati che l'estensione videoforlinux funzioni con il 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", "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; del 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 &DBus; 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

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

Traduzione di Federico Zenith federico.zenith@member.fsf.org

&underFDL; &underGPL;
&documentation.index;