D 2015-04-10T16:37:53.623
L player
N text/x-markdown
P cd66aaff542a4af1fb365d36879954656660d100
U mario
W 2392
<h2>Player config</h2>

See also [Configuration Apps](doc/trunk/help/html/config_apps.html).

The config dialog for player settings allows to associate different media playback apps for different audio streams. 

<img src="doc/tip/help/html/img/configapps.png" align=right style="margin:15pt; border: 5pt dashed #ddd">

  *  In practice you may want to define the same application for both.

  *  You could even edit out all but the `audio/*` fallback entry.

  *  Note that you have to specify an actual player (audacious, vlc, exaile, mplayer, totem). Playlist manager apps (banshee, rythmbox, gmusicbrowser, streamtuner2 itself) will not work.

After changing an application name, a green indicator should appear.


<h3>Placeholders</h3>

Various placeholders can be specified after the command:

<style>
  article .content table { width: 75%; margin: 5pt 15pt; }
</style>

<table>
<tr>
  <th>%m3u</th> <th> Locally (downloaded/converted) .m3u file </th>
</tr>
<tr>
  <td>%f</td> <td rowspan=3>  aliases to %m3u </td>
</tr>
<tr>
  <td>%g</td>
</tr>
<tr>
  <td>%m</td>
</tr>

<tr>
  <th>%pls</th> <th rowspan=2>Link to on-server .pls stream list (default, works with most players, and is often faster as ST2 does not need to convert the playlist)</th>
</tr>
<tr>
  <th>%url</th>
</tr>
<tr>
  <td>%u</td>  <td rowspan=3>Aliases for %pls and %url</td>
</tr>
<tr>
  <td>%r</td>
</tr>
<tr>
  <td>%l</td>
</tr>

<tr>
  <th>%srv</th>  <th>Extracted direct link to streaming server (e.g. http://example.com/stream:25078)</th>
</tr>
<tr>
  <td>%d</td>   <td rowspan=2>Aliases for %srv</td>
</tr>
<tr>
  <td>%s</td>
</tr>

<tr>
  <th>%xspf</th>  <th>Xiph shareable playlist format (for newer apps)</th>
</tr>
<tr>
  <td>%x</td>   <td>Alias for %xspf</td>
</tr>

<tr>
  <th>%jspf</th>  <th>Not widely supported</th>
</tr>
<tr>
  <th>%smil</th>  <th>Not widely supported</th>
</tr>
<tr>
  <th>%asx</th>  <th>Outdated format</th>
</tr>

</table>

If no placeholder is specified in the configuration a default %m3u is appended.


<h3>Shell syntax</h3>

The commands are mostly free-form. You can use various shell idioms. For example `pkill vlc ; vlc %url` to only have one running instance of players that would otherwise run in parallel (VLC also has an option for that, which would apply globally then).




Z 4fb5cb576453b101cd2b929a0b92536f