[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    extragear/multimedia/doc/kmplayer
From:       Koos Vriezen <koos.vriezen () xs4all ! nl>
Date:       2005-08-22 12:57:44
Message-ID: 1124715464.463640.30985.nullmailer () svn ! kde ! org
[Download RAW message or body]

SVN commit 452033 by vriezen:

Add note about special kmplayer:// urls (from a question on kde-apps)


 M  +25 -2     index.docbook  


--- trunk/extragear/multimedia/doc/kmplayer/index.docbook #452032:452033
@@ -111,7 +111,7 @@
 <para>
     &kmplayer; can play from various sources. These sources are listed in the Source \
menu.  </para>
-<section>
+<section id="tvsource">
     <title>TV</title>
     <para>
         &kmplayer; can play from TV cards using <application>MPlayer</application> \
or <acronym>XVideo</acronym> (using <application>kxvplayer</application>). Before you \
can watch TV, you have to configure which device to use and the TV channels. You can \
use the scanner from the configure dialog for this or edit the config file manually. \
@@ -154,7 +154,7 @@  See the VDR section for more information about using \
<acronym>XVideo</acronym>.  </para>
 </section>
-<section>
+<section id="vdrsource">
     <title>VDR</title>
 <para>
 To configure your VDR settings in kmplayer, see the Configure \
panel->Source->VDR->XVideo port panel. There should be ports detected, from which you \
should select one. You have to figure out what encoding you should use (eg. for \
western europe, that is PAL) and likely the correct one has a name with \
<quote>dvb</quote> in it. @@ -175,6 +175,29 @@
  Unfortunately, when ever you update your video driver, you have to reconfigure this \
setting.   </para>
 </section>
+<section id="kmplayer_url">
+    <title>Commandline</title>
+<para>
+    Internally for the sources, KMPlayer uses distinct names. At the time of
+    this writing these are "dvdnavsource", "dvdsource", "exitsource",
+    "hrefsource", "introsource", "pipesource", "tvscanner", "tvsource",
+    "urlsource", "vcdsource" and "vdrsource". When activated, they mostly
+    starts playing the list of playable items.
+</para>
+<para>
+    You can activate a particular source with a <filename>kmplayer://</filename> \
type <acronym>URL</acronym>. Just set the host part as the source name and optional \
path part as extra arguments, so for a channel for the "vdrsource" this could look \
like <filename>kmplayer://vdrsource/22 MTV 2</filename>. Eg. this script starts \
kmplayer using "dvdnavsource" and using <acronym>DCOP</acronym> to play fullscreen. + \
<programlisting> +/bin/bash
+kmplayer kmplayer://dvdnavsource/ &amp;
+PID=$!
+sleep 2
+dcop kmplayer-$PID KMediaPlayer toggleFullScreen
+    </programlisting>
+    For some sources this will not do much because they are not meant to be
+    for normal playing. For "pipesource" this is disabled because that
+    would be a bad security hole of course.
+</para>
+</section>
 </chapter>
 <chapter id="questionsanswersandtips">
     <title>Questions, Answers, and Tips</title>


[prev in list] [next in list] [prev in thread] [next in thread]