kmplayer/tests/chapter2.txt

0001 Chapter 2. The user interface
0002
0003  The application window is made of so called dockable windows. There is always the central view window. Optional there is the playlist window. And finally there is an info window, that just shows itself when some information is there to been shown.
0004
0005 Playlist window
0006
0007  The playlist window has as of this writing five categories, current item(s), Optical Disks, Television, Persistent Playlists and Most Recent. When clicked on a category's text, it will show the contents below this line. Of course there has to be contents, eg. see TV settings for adding content for the Television category. The Most Recent category will fill itself when playing locale media files or network Urls. This category can hold 60 items of which the last 50 are under the More .. branch.
0008
0009 Persisent Playlists category
0010
0011  It's possible to store your favorite links in the Bookmark menu, but those are single items. If you want to create a list of items that play after each other, than you should use the Persistent Playlists category.
0012  The easiest way to add an item in this list is to drag it from Most Recent and drop it on Persistent Playlists. As you will see, when dropped, a pop-up menu appears where you can choose to add to this list or create a new group. Top level items behave like a bookmark item, but items in groups will play the whole group wherein they reside. Items in this category can easily be moved, copied, added to a new group or deleted just by dragging this item to another place in this category. Additionally there are Delete item, Move up and Move down items in the context menu (when clicking with the right mouse button on an item).
0013  Of course you can add groups to groups to get a deeper hierarchy. When clicked on an item, its group and all its child groups will be copied to the current category and playings starts at the clicked item position.
0014 Storage format
0015  The data is stored in ~/.kde/share/apps/kmplayer/playlist.xml, and its format is like this example. See here for manipulating this data directly.
0016
0017 <playlist>
0018     <group title="feeds">
0019         <item url="http://www.lugradio.org/episodes.rss"/>
0020         <item url="http://science.nasa.gov/podcast.xml"/>
0021         <item url="http://www.theworld.org/rss/tech.xml"/>
0022     </group>
0023     <group title="iradio">
0024         <group title="sunny">
0025             <item mplayeropts="-cache 256" url="http://www.swissgroove.ch/listen.m3u"/>
0026             <item url="http://www.boombasticradio.com/shoutcast/64.pls"/>
0027         </group>
0028         <group title="rainy">
0029             <item url="http://www.radioparadise.com/musiclinks/rp_64.m3u"/>
0030             <item url="http://www.woxy.com/stream/wma64.asx"/>
0031             <item url="http://radionigel.com/winmedia.asx"/>
0032             <item url="rtsp://livestreams.omroep.nl/live/vpro/vpro3voor12radioalt.rm"/>
0033         </group>
0034     </group>
0035 </playlist>
0036
0037  Also note that for MPlayer custom options can be set using the mplayeropts argument. Kmplayer searches for this option upwards in the tree, so you can set it for a whole group and override it for a child group or item.