Check-in [23ca961e7b]
Overview
| Comment: | Merged file type descriptions into single help page. |
|---|---|
| Downloads: | Tarball | ZIP archive | SQL archive |
| Timelines: | family | ancestors | descendants | both | trunk |
| Files: | files | file ages | folders |
| SHA1: |
23ca961e7bd2554754d8ca8d26684a3e |
| User & Date: | mario on 2016-12-04 01:37:49 |
| Other Links: | manifest | tags |
Context
|
2016-12-04
| ||
| 15:16 | Bundle Rezlooks-dark theme for Windows. check-in: 312e95294d user: mario tags: trunk | |
| 01:37 | Merged file type descriptions into single help page. check-in: 23ca961e7b user: mario tags: trunk | |
|
2016-12-03
| ||
| 21:27 | Manual slightly restructured, icons for plugins added back in. check-in: 8147a96b12 user: mario tags: trunk | |
Changes
Modified help/config_apps.page from [4f14b73fc7] to [e53dd35fca].
| ︙ | ︙ | |||
16 17 18 19 20 21 22 |
by a generic player, like vlc.</p>
<p><media type="image" src="img/configapps.png" mime="image/png" /></p>
<p>A few common applications and invocation strings to use are:</p>
<table shade="rows" rules="rows cols">
| | | | | | < | | | 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
by a generic player, like vlc.</p>
<p><media type="image" src="img/configapps.png" mime="image/png" /></p>
<p>A few common applications and invocation strings to use are:</p>
<table shade="rows" rules="rows cols">
<tr><td><p><app>audio/*</app></p></td> <td><p><cmd>audacious</cmd></p></td> </tr>
<tr><td><p><app>audio/*</app></p></td> <td><p><cmd>xmms2 %m3u</cmd></p></td></tr>
<tr><td><p><app>audio/*</app></p></td> <td><p><cmd>amarok -l %pls</cmd></p></td></tr>
<tr><td><p><app>audio/*</app></p></td> <td><p><cmd>exaile</cmd></p></td></tr>
<tr><td><p><app>video/*</app></p></td> <td><p><cmd>mplayer %srv</cmd></p></td></tr>
<tr><td><p><app>video/*</app></p></td> <td><p><cmd>totem %u</cmd></p></td></tr>
<tr><td><p><app>*/*</app></p></td> <td><p><cmd>vlc %u</cmd></p></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>
|
| ︙ | ︙ |
Added help/glossary_files.page version [bdce36aed8].
> > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 |
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="filetypes">
<info>
<link type="guide" xref="glossary#filetypes"/>
<desc>PLS, M3U, JSON files types.</desc>
</info>
<title>File types</title>
<p>Streamtuner2 understands different playlist formats as used by various
directory services and audio players.</p>
<section>
<title>.M3U files</title>
<info><desc>MP3-URL playlist file.</desc></info>
<p>M3U files are one of the simplest playlist types. They're often used by desktop audio players.</p>
<p>The MIME type of these files is <sys>audio/x-mpegurl</sys> and often contain just a list of URLs:</p>
<code mime="audio/x-mpegurl">
#M3U
http://123.45.67.189:8222/
http://123.45.67.222:7555/
</code>
</section>
<section>
<title>.PLS files</title>
<info><desc>Playlist file format.</desc></info>
<p>Playlist files often have the extension <file>.pls</file>. It's the primary station
stream link format of SHOUTcast, and was popularized by WinAmp.</p>
<p>The MIME type of these files is <sys>audio/x-scpls</sys> and they often look like: </p>
<code mime="audio/x-scpls">
[playlist]
numberofentries=1
File1=http://123.45.67.189:8222
Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez
Length1=-1
</code>
</section>
<section>
<title>.JSON files</title>
<info><desc>JavaScript Object-Notation</desc></info>
<p>JSON is a data representation format derived from Javascript (the browser embedded
programming language for websites). It's commonly used because it provides a
nice balance between terse and exact data represantion, while still being
readable.</p>
<p>Streamtuner2 uses it to store all of its configuration and radio station data files.
The MIME type of these files is <sys>application/json</sys> and they often look like: </p>
<code mime="application/json">
[
{
"title": "Station title..",
"url": "http://1.2.3.4:8000/",
"homepage": "http://radio.org/",
},
{ "title": "second" }
]
</code>
<p>It's also the basis for JSPF, the JSON variant of XSPF.</p>
</section>
<section>
<title>.XSPF files</title>
<info><desc>Xiph Shareable Playlist File</desc></info>
<p>The Xiph foundation manages the Ogg streaming format, Vorbis and other
codecs, and introduced XML shareable playlist format "XSPF". They're
hard to look at and not very widespread. On the upside they
contain more meta information than any other playlist store.</p>
<p>As MIME type <sys>application/xspf+xml</sys> and they often look like: </p>
<code mime="application/xspf+xml"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
<trackList>
<track>
<title>Top 500 hitz station XY</title>
<annotation>Paris</annotation>
<location>http://123.24.67.189:8222</location>
<info>Pop, Rock, Future-Jazz</info>
<homepage>http://example.com/</homepage>
</track>
</trackList>
</playlist>
]]></code>
<p>A variation of this format exists as JSPF, using JSON (yay!) instead of XML.</p>
</section>
<section>
<title>Uncommon formats</title>
<p>Various other file formats are in existence, but not widely used:</p>
<list>
<item>
<title>SMIL</title>
<p>Synchronized Multimedia Integration Language is a HTML-style
audio/video/stream-link format.</p>
</item>
<item>
<title>ASX</title>
<p>Is a Windows-only format, a variation of SMIL. There's an abhorrent
number of similar formats, like .ASF and .WPL, basically doing the same
thing. Nobody knows why.</p>
</item>
<item>
<title>QTL</title>
<p>QuickTime Link files are also a variation of SMIL</p>
</item>
<item>
<title>B4S</title>
<p>.B4S is a failed WinAmp XML playlist format.</p>
</item>
<item>
<title>.desktop</title>
<p>*.desktop files can contain just one link.</p>
</item>
<item>
<title>.url</title>
<p>*.url (Internet Shortcut) files also are single-link containers.</p>
</item>
</list>
<p>For a comparison of what various audio player support, see also
<link href="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support">Playlist format support</link>
in the ST2 fossil wiki.</p>
</section>
</page>
|
Deleted help/glossary_json.page version [d64e2b8f49].
|
| < < < < < < < < < < < < < < < < < < < < < < < < < < < < |
Deleted help/glossary_m3u.page version [4384d57735].
|
| < < < < < < < < < < < < < < < < < < < < < |
Deleted help/glossary_pls.page version [cc14ff4447].
|
| < < < < < < < < < < < < < < < < < < < < < < < < < < < |
Modified help/html/config_apps.html from [deaaa03bdb] to [3f01e2f9de].
| ︙ | ︙ | |||
17 18 19 20 21 22 23 | <span class="link"><a href="configuration.html" title="Configuration / Settings dialog">configure</a></span> 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> <p class="p"><span class="media"><span class="media media-image"><img src="img/configapps.png" class="media media-inline" alt=""></span></span></p> <p class="p">A few common applications and invocation strings to use are:</p> <div class="table"><div class="inner"><div class="region"><table class="table"> <tr> | | < | < | < | < | < | | < | | < < < < < < | 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 |
<span class="link"><a href="configuration.html" title="Configuration / Settings dialog">configure</a></span> 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>
<p class="p"><span class="media"><span class="media media-image"><img src="img/configapps.png" class="media media-inline" alt=""></span></span></p>
<p class="p">A few common applications and invocation strings to use are:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr>
<td><p class="p"><span class="app">audio/*</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="cmd">audacious</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">audio/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">xmms2 %m3u</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">audio/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">amarok -l %pls</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">audio/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">exaile</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">video/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">mplayer %srv</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">video/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">totem %u</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">*/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc %u</span></p></td>
</tr>
</table></div></div></div>
<p class="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 <span class="code">pkill vlc ; vlc %u</span> instead,
which ends the previous player process and starts it anew.
For VLC there's however also the <span class="code">--one-instance</span> option, which sometimes
works better. (And sometimes not.)</p>
|
| ︙ | ︙ |
Added help/html/filetypes.html version [96d25c7c46].
> > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 |
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>File types</title>
<link rel="stylesheet" type="text/css" href="C.css">
<script type="text/javascript" src="jquery.js"></script><script type="text/javascript" src="jquery.syntax.js"></script><script type="text/javascript" src="yelp.js"></script>
</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation"><div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#footer" title="index#footer"></a> » <a class="trail" href="glossary.html" title="Glossary">Glossary</a> › <a class="trail" href="glossary.html#filetypes" title="Filetypes">Filetypes</a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">File types</span></h1></div>
<div class="region">
<div class="contents"><p class="p">Streamtuner2 understands different playlist formats as used by various
directory services and audio players.</p></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.M3U files</span></h2></div>
<div class="region"><div class="contents">
<p class="p">M3U files are one of the simplest playlist types. They're often used by desktop audio players.</p>
<p class="p">The MIME type of these files is <span class="sys">audio/x-mpegurl</span> and often contain just a list of URLs:</p>
<div class="code"><pre class="contents ">#M3U
http://123.45.67.189:8222/
http://123.45.67.222:7555/</pre></div>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.PLS files</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Playlist files often have the extension <span class="file">.pls</span>. It's the primary station
stream link format of SHOUTcast, and was popularized by WinAmp.</p>
<p class="p">The MIME type of these files is <span class="sys">audio/x-scpls</span> and they often look like: </p>
<div class="code"><pre class="contents ">[playlist]
numberofentries=1
File1=http://123.45.67.189:8222
Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez
Length1=-1</pre></div>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.JSON files</span></h2></div>
<div class="region"><div class="contents">
<p class="p">JSON is a data representation format derived from Javascript (the browser embedded
programming language for websites). It's commonly used because it provides a
nice balance between terse and exact data represantion, while still being
readable.</p>
<p class="p">Streamtuner2 uses it to store all of its configuration and radio station data files.
The MIME type of these files is <span class="sys">application/json</span> and they often look like: </p>
<div class="code"><pre class="contents ">[
{
"title": "Station title..",
"url": "http://1.2.3.4:8000/",
"homepage": "http://radio.org/",
},
{ "title": "second" }
]</pre></div>
<p class="p">It's also the basis for JSPF, the JSON variant of XSPF.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.XSPF files</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The Xiph foundation manages the Ogg streaming format, Vorbis and other
codecs, and introduced XML shareable playlist format "XSPF". They're
hard to look at and not very widespread. On the upside they
contain more meta information than any other playlist store.</p>
<p class="p">As MIME type <span class="sys">application/xspf+xml</span> and they often look like: </p>
<div class="code"><pre class="contents syntax brush-html"><?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
<trackList>
<track>
<title>Top 500 hitz station XY</title>
<annotation>Paris</annotation>
<location>http://123.24.67.189:8222</location>
<info>Pop, Rock, Future-Jazz</info>
<homepage>http://example.com/</homepage>
</track>
</trackList>
</playlist></pre></div>
<p class="p">A variation of this format exists as JSPF, using JSON (yay!) instead of XML.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Uncommon formats</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Various other file formats are in existence, but not widely used:</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list">
<div class="title title-item"><h3><span class="title">SMIL</span></h3></div>
<p class="p">Synchronized Multimedia Integration Language is a HTML-style
audio/video/stream-link format.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">ASX</span></h3></div>
<p class="p">Is a Windows-only format, a variation of SMIL. There's an abhorrent
number of similar formats, like .ASF and .WPL, basically doing the same
thing. Nobody knows why.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">QTL</span></h3></div>
<p class="p">QuickTime Link files are also a variation of SMIL</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">B4S</span></h3></div>
<p class="p">.B4S is a failed WinAmp XML playlist format.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">.desktop</span></h3></div>
<p class="p">*.desktop files can contain just one link.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">.url</span></h3></div>
<p class="p">*.url (Internet Shortcut) files also are single-link containers.</p>
</li>
</ul></div></div></div>
<p class="p">For a comparison of what various audio player support, see also
<span class="link"><a href="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support" title="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support">Playlist format support</a></span>
in the ST2 fossil wiki.</p>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul><li class="links "><a href="glossary.html#filetypes" title="Filetypes">Filetypes</a></li></ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>
|
Modified help/html/glossary.html from [c39b69f188] to [073241549e].
| ︙ | ︙ | |||
74 75 76 77 78 79 80 |
it's commonly used as quality indicator.</p></dd>
</dl></div></div></div></div>
<div id="filetypes" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Filetypes</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Besides audio formats MP3 and OGG, there are also station/streaming link files.
These are often downloaded from the directory servers, before your music player gets activated.</p>
| | < < < < | 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 |
it's commonly used as quality indicator.</p></dd>
</dl></div></div></div></div>
<div id="filetypes" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Filetypes</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Besides audio formats MP3 and OGG, there are also station/streaming link files.
These are often downloaded from the directory servers, before your music player gets activated.</p>
<div class="links topiclinks"><div class="inner"><div class="region"><div class="linkdiv "><a class="linkdiv" href="filetypes.html" title="File types"><span class="title">File types</span><span class="linkdiv-dash"> — </span><span class="desc">PLS, M3U, JSON files types.</span></a></div></div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul><li class="links "><a href="index.html#footer" title="index#footer"></a></li></ul></div>
|
| ︙ | ︙ |
Deleted help/html/json.html version [6e9d310fcb].
|
| < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < |
Deleted help/html/m3u.html version [46333877ca].
|
| < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < |
Deleted help/html/pls.html version [83f418f971].
|
| < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < |
Modified help/html/shoutcast.html from [3587de63ab] to [f759284b96].
| ︙ | ︙ | |||
21 22 23 24 25 26 27 |
<div class="region">
<div class="contents">
<p class="p">SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
station lists on shoutcast.com.
</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Station entries usually provide current playing information.</p></li>
| | | 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 |
<div class="region">
<div class="contents">
<p class="p">SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
station lists on shoutcast.com.
</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Station entries usually provide current playing information.</p></li>
<li class="list"><p class="p">Stream links are plain <span class="link"><a href="pls.html" title="pls">PLS files</a></span>.</p></li>
<li class="list"><p class="p">Genres are subcategorized, so the main groups in the category
list must be expanded to see the interesting entries.</p></li>
</ul></div></div></div>
<p class="p">Since being sold from AOL to Radionomy, the directory got cut down. There are no longer
entries for currently played songs, and homepage links are largely gone. Hencewhy the
Shoutcast channel is no longer considered a primary feature.</p>
</div>
|
| ︙ | ︙ |