<sect1 id="howto-playlist">
<title
>Playlist</title>

<sect2 id="howto-playlist-builtin">
<title
>Playlist attuale</title>

<para
>&kplayer; keeps a list of files, directories, streams, tracks, titles and channels that are being played or are going to be played or have recently been played. It shows the current playlist in a drop down box on the <link linkend="parts-toolbar-playlist"
>playlist toolbar</link
>. If there are any directories on the current playlist, the drop down list shows their contents instead of the directories themselves.</para>

<para
>La <link linkend="toolbar-playlist"
>barra della playlist</link
>, il <link linkend="menu-player"
>menu <guimenu
>Lettore</guimenu
></link
> e il <link linkend="popup-playlist"
>menu a comparsa della playlist</link
>recano i comandi <guimenuitem
>Successivo</guimenuitem
> e <guimenuitem
>Precedente</guimenuitem
> che dicono a &kplayer; di riprodurre rispettivamente l'elemento successivo e precedente dall'elenco. La selezione di una voce dall'elenco a discesa nella barra la renderà la voce attiva e inizierà a riprodurla.</para>

<para
>When you ask &kplayer; to play things in any of the following ways, it wipes out the current playlist and puts the new items on it:</para>

<itemizedlist>

<listitem
><para
>any of the various <guimenuitem
>Play</guimenuitem
> commands on the <link linkend="menu-file"
><guimenu
>File</guimenu
> menu</link
> or its submenus;</para
></listitem>

<listitem
><para
><guimenuitem
>Play</guimenuitem
> or <guimenuitem
>Play Next</guimenuitem
> command from the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
>, except when you use them on items that are already on the current playlist;</para
></listitem>

<listitem
><para
>un comando equivalente da un <link linkend="popup-menus"
>menu a comparsa</link
> con un clic <mousebutton
>destro</mousebutton
></para
></listitem>

<listitem
><para
>running &kplayer; with a file or directory path or a <acronym
>URL</acronym
> from &konqueror;, from the command line, from a script, etc.;</para
></listitem>

<listitem
><para
><guilabel
>Play</guilabel
> or <guilabel
>Play Next</guilabel
> action in &konqueror;, &kicker; or any other program that supports those actions;</para
></listitem>

<listitem
><para
>dragging and dropping files and directories or a <acronym
>URL</acronym
> from &konqueror; or another program onto any part of &kplayer; except the <link linkend="parts-library"
><interface
>multimedia library</interface
></link
>.</para
></listitem>

</itemizedlist>

<para
>Esistono diversi modi per aggiungere voci alla playlist attuale:</para>

<itemizedlist>

<listitem
><para
><guimenuitem
>Queue</guimenuitem
> or <guimenuitem
>Queue Next</guimenuitem
> command on the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
> or the <link linkend="popup-library"
>library popup menu</link
> in the <interface
>multimedia library</interface
>; if you use these commands on items that are already on the current playlist, &kplayer; will move them to the end of the playlist;</para
></listitem>

<listitem
><para
><guilabel
>Queue</guilabel
> or <guilabel
>Queue Next</guilabel
> action in &konqueror;, &kicker; or any other program that supports those actions;</para
></listitem>

<listitem
><para
><menuchoice
><guisubmenu
>Add</guisubmenu
> <guimenuitem
>Files...</guimenuitem
></menuchoice
> or <menuchoice
><guisubmenu
>Add</guisubmenu
> <guimenuitem
>URL...</guimenuitem
></menuchoice
> on the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
> or the <link linkend="popup-library"
>library popup menu</link
> in the <guilabel
>Now Playing</guilabel
> section of the <interface
>multimedia library</interface
> or from the <link linkend="popup-playlist"
>playlist popup menu</link
>;</para
></listitem>

<listitem
><para
>dragging and dropping items from &konqueror; or another program or another part of the <interface
>multimedia library</interface
> into the <guilabel
>Now Playing</guilabel
> section of the library.</para
></listitem>

</itemizedlist>

<para
>&kplayer; ha alcune opzioni che controllano il comportamento della playlist:</para>

<itemizedlist>

<listitem
><para
><guilabel
>Loop</guilabel
> option tells &kplayer; to play the current playlist again from the beginning after it finishes playing it.</para
></listitem>

<listitem
><para
>L'opzione <guilabel
>Mescola</guilabel
> dispone gli elementi della playlist attuale in ordine casuale.</para>

<para
>Se è attiva anche l'opzione <guimenuitem
>Ciclo</guimenuitem
>, la playlist sarà rimescolata a ogni ciclo. Per rimescolare in qualsiasi momento, disabilita l'opzione <guimenuitem
>Mescola</guimenuitem
> e abilitala di nuovo.</para>

<para
>These two options are available on the <link linkend="toolbar-playlist"
>playlist toolbar</link
>, the <link linkend="menu-player"
><guimenu
>Player</guimenu
> menu</link
> and the <link linkend="popup-playlist"
>playlist popup menu</link
>.</para
></listitem>

<listitem
><para
><guilabel
>Allow duplicate entries on playlists</guilabel
> option lets you put more than one entry with exactly the same <acronym
>URL</acronym
> on the playlist. When this option is turned off, &kplayer; will automatically remove duplicate entries from the playlist. However, you still can put the same entry in two different folders in the <guilabel
>Now Playing</guilabel
> section of the <link linkend="parts-library"
><interface
>multimedia library</interface
></link
>, and then they both will be on the current playlist. This option also affects playlists stored in the <guilabel
>Playlists</guilabel
> section of the library, as well as folders in the <guilabel
>Recent</guilabel
> section. This option is on the <link linkend="settings-general"
><guilabel
>General</guilabel
> page</link
> in <guilabel
>&kplayer; Settings</guilabel
>.</para
></listitem>

</itemizedlist>

<para
>To remove entries from the current playlist, or to change the order of entries, open the <guilabel
>Now Playing</guilabel
> section of the <interface
>multimedia library</interface
> by choosing <menuchoice
><guimenu
>Library</guimenu
><guisubmenu
>Go</guisubmenu
> <guimenuitem
>Now Playing</guimenuitem
></menuchoice
> or <mousebutton
>right</mousebutton
> clicking the playlist drop down box on the <link linkend="parts-toolbar-playlist"
>playlist toolbar</link
> and choosing <menuchoice
><guimenuitem
>Edit</guimenuitem
></menuchoice
>. Then use the <guimenuitem
>Remove</guimenuitem
>, <guimenuitem
>Move Up</guimenuitem
> and <guimenuitem
>Move Down</guimenuitem
> commands from the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
> or the <link linkend="popup-library"
>library popup menu</link
> to edit the playlist. Clicking a column header in the <interface
>list view</interface
> resets the order of items in the current playlist folder and any expanded subfolders and sorts the folder by that column.</para>

<para
>You can save the current playlist in the <guilabel
>Playlists</guilabel
> or the <guilabel
>Collection</guilabel
> section of the <interface
>multimedia library</interface
> by <mousebutton
>right</mousebutton
> clicking the playlist drop down box on the <link linkend="parts-toolbar-playlist"
>playlist toolbar</link
> and choosing <menuchoice
><guisubmenu
>Add to</guisubmenu
> <guimenuitem
>Playlists...</guimenuitem
></menuchoice
> or <menuchoice
><guisubmenu
>Add to</guisubmenu
> <guimenuitem
>Collection...</guimenuitem
></menuchoice
> respectively. The playlist will then appear on the <guisubmenu
>Play List</guisubmenu
> submenu of the <link linkend="menu-file"
><guimenu
>File</guimenu
> menu</link
> and several <link linkend="popup-menus"
>popup menus</link
>, as well as on the <guisubmenu
>Add to</guisubmenu
> submenus of the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
> and the <link linkend="popup-library"
>library popup menu</link
>. <mousebutton
>Right</mousebutton
> clicking the playlist drop down box and choosing <menuchoice
><guisubmenu
>Add to</guisubmenu
> <guimenuitem
>an existing playlist name</guimenuitem
></menuchoice
> will add the contents of the current playlist to the existing playlist you choose.</para>

<para
>For more information on the multimedia library feature see the <link linkend="howto-library"
>Multimedia library micro-HOWTO</link
>.</para>

</sect2>

<sect2 id="howto-playlist-stored">
<title
>Playlist memorizzate</title>

<para
>To create a new playlist and store it in the <guilabel
>Playlists</guilabel
> section of the <link linkend="parts-library"
><interface
>multimedia library</interface
></link
>, select the multimedia you want to put on it in another section of the library, choose <menuchoice
><guisubmenu
>Add to</guisubmenu
> <guimenuitem
>New Playlist...</guimenuitem
></menuchoice
> from the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
> or the <link linkend="popup-library"
>library popup menu</link
>, and enter the name of the new playlist. If the multimedia is already stored in a folder, you can use the <menuchoice
><guisubmenu
>Add to</guisubmenu
> <guimenuitem
>Playlists</guimenuitem
></menuchoice
> command instead. These commands are also available on the <guisubmenu
>Actions</guisubmenu
> submenu of the <mousebutton
>right</mousebutton
> click popup menu in &konqueror;, &kicker; and other programs.</para>

<para
>The playlists you create in the <guilabel
>Playlists</guilabel
> section will appear on the <guisubmenu
>Play List</guisubmenu
> submenu of the <link linkend="menu-file"
><guimenu
>File</guimenu
> menu</link
> and several <link linkend="popup-menus"
>popup menus</link
> that lets you play a list by choosing it from the menu, as well as on the <guisubmenu
>Add to</guisubmenu
> submenu of the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
> and the <link linkend="popup-library"
>library popup menu</link
> that allows you add more multimedia to an existing playlist. The <guilabel
>Maximum entries on playlist menus</guilabel
> option on the <link linkend="settings-general"
><guilabel
>General</guilabel
> page</link
> of <guilabel
>&kplayer; Settings</guilabel
> gives the maximum number of playlists that will be included on the submenus.</para>

<para
>Just like with the current playlist, you can edit a playlist stored in the <guilabel
>Playlists</guilabel
> section by opening the list in the <interface
>multimedia library</interface
> and using commands from the <link linkend="menu-library"
><guimenu
>Library</guimenu
> menu</link
> and the <link linkend="popup-library"
>library popup menu</link
>, or add more items to it by dragging and dropping them onto the playlist or any of its subfolders.</para>

<para
>Per ulteriori dettagli vedere il <link linkend="howto-library"
>micro-HOWTO Raccolta multimediale</link
>.</para>

</sect2>

<sect2 id="howto-playlist-files">
<title
>File di playlist</title>

<para
><link linkend="howto-installation-mplayer"
>&mplayer;</link
> attualmente non può rilevare e riprodurre automaticamente i file di playlist come <literal
>m3u</literal
>, <literal
>pls</literal
>, <literal
>asx</literal
>, <literal
>ram</literal
> e così via. &kplayer; deve passare un'opzione speciale a &mplayer; per fargli riprodurre correttamente un file di playlist.</para>

<para
>&kplayer; cerca di rilevare i file di playlist dall'estensione. A volte, però,  un file di playlist non avrà un'estensione, o un file che non è di playlist ne avrà l'estensione. In questi casi la riproduzione non riuscirà. Puoi andare alla <link linkend="properties"
>pagina Generale</link
> delle <guilabel
>Proprietà dei file</guilabel
> e impostare correttamente l'opzione <guilabel
>Playlist</guilabel
>. &kplayer; memorizzerà l'opzione e la userà la prossima volta che riproduci lo stesso file o <acronym
>URL</acronym
>.</para>

<para
>Se impostare l'opzione <guilabel
>Playlist</guilabel
> non aiuta, dovrai estrarre manualmente il percorso o <acronym
>URL</acronym
> dal file e incollarlo nella finestra <guilabel
>Riproduci URL</guilabel
> che puoi aprire dal menu <guimenu
>File</guimenu
> o dalla finestra <guilabel
>Aggiungi URL</guilabel
> che si ottiene facendo clic con il tasto <mousebutton
>destro</mousebutton
> del mouse sulla <link linkend="toolbar-playlist"
>barra della playlist</link
> e scegliendo <menuchoice
><guisubmenu
>Aggiungi</guisubmenu
> <guimenuitem
>URL...</guimenuitem
></menuchoice
>.</para>

<para
>Le estensioni delle playlist riconosciute da &kplayer; sono <literal
>ram</literal
>, <literal
>rpm</literal
>, <literal
>smi</literal
>, <literal
>smil</literal
>, <literal
>asx</literal
>, <literal
>m3u</literal
>, <literal
>pls</literal
> e <literal
>strm</literal
>.</para>

</sect2>

</sect1>
