Internet radio browser GUI for music/video streams from various directory services.

⌈⌋ ⎇ branch:  streamtuner2


config_apps.page at [1c1c57d655]

File help/config_apps.page artifact e50bfca5a3 part of check-in 1c1c57d655


<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="config_apps">

<info>
	<link type="guide" xref="configuration#apps"/>
	<desc>Common applications to use as players.</desc>
</info>

	<title>Audio players</title>

	<p>On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can
	configure most of them as target application. Mostly it makes sense to use a single
	application for all audio formats. But at least the */* media type should be handled
	by a generic player, like vlc.</p>

	<table shade="rows" rules="rows cols">
		<tr><td><app>Audacious</app></td>     <td><cmd>audacious %m3u</cmd></td>  <td>audio</td></tr>
		<tr><td><app>XMMS2</td>               <td><cmd>xmms2 %m3u</cmd></td>      <td>audio</td></tr>
		<tr><td><app>Amarok</app></td>        <td><cmd>amarok -l %pls</cmd></td>  <td>audio</td></tr>
		<tr><td><app>Exaile</app></td>        <td><cmd>exaile %m3u</cmd></td>     <td>audio</td></tr>
		<tr><td><app>Amarok</app></td>        <td><cmd>amarok -l %pls</cmd></td>  <td>audio</td></tr>
		<tr><td><app>mplayer</app></td>       <td><cmd>mplayer %srv</cmd></td>    <td>console</td></tr>
		<tr><td><app>VLC</app></td>           <td><cmd>vlc %u</cmd></td>          <td>video/*</td></tr>
		<tr><td><app>Totem</app></td>         <td><cmd>totem %u</cmd></td>        <td>video/*</td></tr>
		<tr><td><app>Media Player</app></td>  <td><cmd>mplayer2.exe %pls</cmd></td>  <td>Win32</td></tr>
	</table>

	<p>Some audio players open a second instance when you actually want to switch radios.
	In this case it's a common workaround to write <code>pkill vlc ; vlc %u</code> instead,
	which ends the previous player process and starts it anew.
        For VLC there's however also the <code>--one-instance</code> option, which sometimes
        works better. (And sometimes not.)</p>

	<p>Some applications, like Rhythmbox or Banshee, are primarily audio browsers, not players,
        and cannot be invoked with a play URL by other apps. This makes them less suitable for use with
	streamtuner2.</p>

	<section id="abbr">
	<title>URL placeholders</title>

	<p>Any listed application can be invoked with a different kind of
	URL or filename.be invoked with a play URL by other apps.  Which to
	use often depends on the application.</p>

	<table shade="rows" rules="rows cols">
		<tr><td>Placeholder</td><td>Alternatives</td><td>URL/Filename type</td></tr>
		<tr><td>%m3u</td><td>%f %g %m</td><td>Provides a local .m3u file for the streaming station</td></tr>
		<tr><td>%pls</td><td>%url %u %r</td><td>Either a remote .pls resource, or a local .pls file (if converted)</td></tr>
		<tr><td>%srv</td><td>%d %s</td><td>Direct link to first streaming address, e.g. http://72.5.9.33:7500</td></tr>
	</table>

	<p>You sould preferrably use the long forms. Most audio players like
	%m3u most, while streamripper needs %srv for recording.</p>

	</section>

</page>