ADDED help/channel_reddit.page Index: help/channel_reddit.page ================================================================== --- help/channel_reddit.page +++ help/channel_reddit.page @@ -0,0 +1,120 @@ + + + + + + + Music subreddit posts + + +<media type="image" src="img/channel_reddit.png" /> Reddit +//reddit.com/r/Music + +

Reddit harbours a growing list of music-related communities. + User-contributed audio files or audio/video links can be found + across almost two hundred subreddit boards. There's always a + mix of new bands or fresh releases to be found, along with + links to all-time favourites etc.

+ + +

Around 620 subreddits are queried. That's just a selected part + though. Most others do not see as many audio posts / or are just for + discussion and news.

+

Besides youtube/mp3 files, this channel may also + list Soundcloud/Mixcloud/Bandcamp links.

+

Radioreddit.com + even provides streaming servers. Its categories are: main, random, + rock, metal, indie, electronic, hiphop, talk, festival.

+

Thumbnails are slightly larger (32x26) than regular favicons.

+

All entries also show poster name and user votes.

+
+ +

See the config options if you want to keep regular webpage posts - instead + of just showing playable content.

+ +
+ Status icons +

Station entries may contain a status icon (leftmost; where usually + the bookmarks ✩ star goes). + It's a quick indicator of what type of content is linked:

+ + + +

Directly playable entry (MP3, MP4, Youtube, MIDI)

+
+ + ▶▶ +

Walled garden (Soundcloud, Spotify, Bandcamp, Mixcloud) → playable

+
+ + ▮▮ +

Walled gardens without playback handler.

+
+ + 📄 +

Just a web-link. Those are kept with the ☒ keep all option.

+
+
+ +

Please note that Channel Reload category + tree will retrieve a differently structured list of + subreddits from the /r/music wiki.

+ +
+ + +
+ Configuration + +

There's a few options for the reddit plugin:

+ + + + <code>🔟 Number of pages to fetch </code> +

Influences how many JSON requests are made to assemble a list of + subreddit posts with playable content. (For this plugin that's + configurable, because counting streams wouldn't work as reddit + result lists vary wildly in their usable links.)

+
+ + <code>🔰 Filter walled gardens </code> +

Many music posts on reddit meanwhile point to one of Soundcloud, + Spotify, Bandcamp, Mixcloud. Those are basically just links you had + open in your browser. -- + Now those are labeled "walled gardens" here, because they're hording + user content behind a paywall/registration-wall, fiddly NIH APIs, + non-standard audio formats, web-only players and sessioning.

+

There's a few players or tools for those better-known hosters. But + smaller services fall under the radar. Which is why I think it's unfair + to provide out-of-the-box support for just those four services. + -- But anyway, you can disable filtering them, if you like. And then + configure a custom player:

+ + + + + +

audio/soundcloud

soundcli %srv

audio/spotify

sconsify %srv

audio/bandcamp

youtube-dl -g %srv

audio/mixcloud

vlc $(youtube-dl -g %srv)

+

Obviously you want to pipe youtube-dl to an actual audio player + again. VLC also supports a few services directly or via plugins.

+
+ + <code>💫 Keep all web links </code> +

Besides audio/video links, some subreddits link to album art or + are just news feeds. Enable the "keep all" option to retain them. + Such entries will open in your web browser instead of an audio player, + of course.

+
+
+ +

To utilize Soundcloud links, there's an extra url_soundcloud plugin. + It overrides the audio/soundcloud player config, and + resolves such streams to MP3 urls (session typically times out + quickly, so no bookmarking/export possible etc).

+ +
+ +
Index: help/channel_shoutcast.page ================================================================== --- help/channel_shoutcast.page +++ help/channel_shoutcast.page @@ -15,11 +15,11 @@ station lists on shoutcast.com.

Station entries usually provide current playing information.

-

Stream links are plain PLS files.

+

Stream links are plain PLS files.

Genres are subcategorized, so the main groups in the category list must be expanded to see the interesting entries.

Since being sold from AOL to Radionomy, the directory got cut down. There are no longer Index: help/glossary_files.page ================================================================== --- help/glossary_files.page +++ help/glossary_files.page @@ -10,11 +10,11 @@ File types

Streamtuner2 understands different playlist formats as used by various directory services and audio players.

-
+
.M3U files MP3-URL playlist file.

M3U files are one of the simplest playlist types. They're often used by desktop audio players.

The MIME type of these files is audio/x-mpegurl and often contain just a list of URLs:

@@ -22,11 +22,11 @@ http://123.45.67.189:8222/ http://123.45.67.222:7555/
-
+
.PLS files Playlist file format.

Playlist files often have the extension .pls. It's the primary station stream link format of SHOUTcast, and was popularized by WinAmp.

The MIME type of these files is audio/x-scpls and they often look like:

@@ -37,11 +37,11 @@ Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez Length1=-1
-
+
.JSON files JavaScript Object-Notation

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 representation, while still being @@ -59,11 +59,11 @@ ]

It's also the basis for JSPF, the JSON variant of XSPF.

-
+
.XSPF files Xiph Shareable Playlist File

The Xiph foundation manages the Ogg streaming format, Vorbis and other codecs, and introduced the "XML shareable playlist format" or "XSPF" for short. They're hard to look at and not very widespread. On the upside they