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

⌈⌋ ⎇ branch:  streamtuner2


Artifact [9e369eee07]

Artifact 9e369eee071d41b3c3dab13cdc83a28288775057:

Wiki page [player] by Oliver on 2017-01-23 19:38:39.
D 2017-01-23T19:38:39.991
L player
N text/x-markdown
P 667fa441de3f1942dc4546c6f7b3f8ac94b01e8a
U Oliver
W 4559
<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 %pls 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



<h3>Configuration samples for selected Windows players</h3>

While for the common players on Linux no special config options are needed there are differences when using players on the Windows platform. The following table is a non-representative selection of some.

<table>
<tr>
  <th>VLC Media Player</th> <th> [Path]\vlc.exe --one-instance </th>
</tr>
<tr>
  <td></td><td>You can omit the <I>--one-instance</I> parameter if you set <I>Allow only one instance</I> in the VLC preferences.<br>(Applies likewise to the Linux version of VLC)</td>
</tr>
<tr>
  <th>Windows Media Player</th> <th> [Path]\wmplayer.exe %asx </th>
</tr>
<tr>
  <td></td><td>The <I>Path</I> parameter is usually not needed </td>
</tr>
<tr>
  <th>Media Player Classic</th> <th> /D [Path] mpc-hc64.exe<br> /D [Path] mpc-hc.exe  </th>
</tr>
<tr>
  <td></td><td>In order to reuse any open MP Classic instance set <I>Use the same player for each media file</I> in the player's options. </td>
</tr>
<tr>
  <th>AIMP3</th> <th> [Path]\aimp.exe /ADD_PLAY "%pls"</th>
</tr>
<tr>
  <td></td><td>The <I>%pls</I> placeholder must be given enclosed in double quotes.<br> Some stations therefore will not play. </td>
</tr>
<tr>
  <th>foobar2000</th> <th> [Path]\foobar2000.exe</th>
</tr>
</table>

Z 650eb2ecc45ddce87c322cd6e78ca4b2