D 2017-01-01T20:35:41.024
L player
N text/x-markdown
P ecd9729221611d51882bd90cfa4f72492bc1c4bb
U Oliver
W 3268
<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, rhythmbox, gmusicbrowser, streamtuner2 itself) will not work.
After changing an application name, a green indicator should appear.
This however does not apply to Windows. The automatic application detection is not supported on this platform.<br><br>
Note also that on <b>Windows</b> any path containing spaces must be enclosed in double quotes (<i>"P:\\Mozilla Firefox\\firefox.exe"</i>, e.g) (which is of course not an audio player, but can also be configured on this settings page). You may also consider to add any path to your audio/video player application or preferred internet browser to the %Path% environment variable.
<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).<br><br>
Notes for <b>Windows</b>: Shell commands are invoked using the Windows <i>Start</i> command. If they are targeting a non-GUI-application like streamripper.exe the syntax is:
/D ["][Path-to-streamripper]["] streamripper.exe %srv [parameters for streamripper.exe]
For killing an application (GUI or not) use e.g.
Taskkill.exe /IM streamripper.exe
Z 6b5631ecee4e50bddb40ad73c9a36a9e