Index: Makefile ================================================================== --- Makefile +++ Makefile @@ -95,5 +95,6 @@ #MALLOC_CHECK_=2 PYTHONVERBOSE=2 python -B ./st2.py -D -e dev_faulthandler yelp: yelp help/index.page 2>/dev/null & + (cd help/html ; yelp-build html ..) Index: help/channel_bookmarks.page ================================================================== --- help/channel_bookmarks.page +++ help/channel_bookmarks.page @@ -40,10 +40,11 @@
Subcategories

The bookmarks tab can display other categories besides "favourite". For example the search feature creates a "search", while the "timer" and "links" plugins also display lists here.

-

However the favourite list itself can not yet be categorized - further.

 +

There's a feature plugin + to provide for favourite subcategories. You'd usually move items there per drag'n'drop. It's somewhat of a workaround, however.
Index: help/channel_liveradio.page ================================================================== --- help/channel_liveradio.page +++ help/channel_liveradio.page @@ -20,15 +20,29 @@ the station logos are utilized directly in ST2 as favicons.

Configuration + + + <code>🔠 Website to fetch from</code> +

This option allows for querying LiveRadio.UK instead. This requires + a Streamtuner2 restart however, and might not be reflected in the + channel tabs (though is in the toolbar link).

+ + + ✕ Missing options +

Future version might allow to set a language filter. Currently + there's too little content to warrant it.

+ + + ❏ General options +

Responds to the PyQuery (instead of regex) parsing main option.

+

Per default fetches 10 pages at once.

+ + -

There's an option for querying LiveRadio.UK instead. This requires - a Streamtuner2 restart however, and might not be reflected in the UI.

-

Responds to the PyQuery (instead of regex) parsing main option.

-

Per default fetches 10 pages at once.

Index: help/channel_peertube.page ================================================================== --- help/channel_peertube.page +++ help/channel_peertube.page @@ -11,34 +11,39 @@ <media type="image" src="img/channel_peertube.png" /> Peertube //joinpeertube.org/

PeerTube is a federated video hosting network. And this channel - allows you to browse /Music and other categories. It's not quite a - very rich ecosystem yet, but very international. So perhaps worth a + allows you to browse /Music and other categories. It's not a very + broad video ecosystem yet, but fairly international. So perhaps worth a lookaround.

-

The category list seeems to be uniform across most Peertube +

The category list seems to be uniform across most Peertube instances. So you only need to reload stations/videos once switching the address in the settings.

Per default you should use VLC and youtube-dl in the playback settings. Per default the faux mime type video/youtube is used for all listings. However, internally there's a lookup for - an .m3u or direct .mp4 link already. So the video/* entry should + a .m3u or direct .mp4 link already. So the video/* entry should also be populated.

Channel options. <code>🔠 Peertube server</code> -

Sets the main isntance to query video listings from. Now most +

Sets the main instance to query video listings from. Now most of the other sites will be peered, so the main server doesn't have that much influence. It changes the ordering however, and - will reveal more local videos or languages often.

+ will reveal more local videos or languages usually.

+ + + ✕ Missing options +

Future plugin versions might offer a language filter option. + Currently there's not enough content to warrant it.
Index: help/channel_radiobrowser.page ================================================================== --- help/channel_radiobrowser.page +++ help/channel_radiobrowser.page @@ -32,26 +32,32 @@ stations directly. There's a new context menu Share in Radio-Browser.

Configuration - -

Instead of browsing by genres, you can switch to languages or - countries.

- -

Note that you'll have to use Channel Reload Category Tree (F5) - again to update the category view.

- -

The API server option lets you predefine a more local cache to be used - for station list queries.

- -

And "Minimum stations to list a category" can be used to filter out - fringe/sparsely populated genres - on using Channel - Reload Category Tree (F5). Typically 15 should be okay, - or 150 if you want to see only major categories. Else the category list - would become around a thousand entries.

- + + + <code>🔠 Which category types to list</code> +

Instead of browsing by genres, you can switch to languages or + countries.

+

Note that you'll have to use Channel Reload Category Tree (F5) + again to update the category view.

+ + + <code>🔠 API server to utilize</code> +

The API server option lets you predefine a more local cache to be used + for station list queries.

+ + + <code>🔟 Minimum stations to list a category</code> +

This option can be used to filter out fringe/sparsely populated + genres. Use Channel Reload Category Tree (F5) + to apply it to the genre list.

+

Typically 15 should be okay, or 150 if you want to see only major categories. + Else the category list would become crowded with around a thousand entries.

+ +

With RadioDroid there's a mobile version to access and play from radio-browser.info Index: help/channel_radionomy.page ================================================================== --- help/channel_radionomy.page +++ help/channel_radionomy.page @@ -36,15 +36,15 @@ 🔟 Number of pages

You can configure the number of pages it'll try (3 by default) to influence the length of station lists.

- ☑ OnAir updates + 🔰 OnAir updates

And the song title updating can be disabled (for speedier loading). Future versions of this channel plugin might poll it automatically, and keep the station list auto-updated.
Index: help/channel_somafm.page ================================================================== --- help/channel_somafm.page +++ help/channel_somafm.page @@ -17,16 +17,21 @@

SomaFM is a non-commercial and ad-free provider. It strongly depends on listener donations.
- Bitrate configuration + + + 🔟 Bitrate configuration

It provides streaming links in different audio formats. Only AAC64 is guaranteed to be available for all. Other bitrates depend on the station.

After reconfiguring the bitrate/format, you can Reload the station list to update them. - Otherwise refreshing has no effect.

+ Otherwise refreshing has no effect.

+ + + Index: help/channel_tunein.page ================================================================== --- help/channel_tunein.page +++ help/channel_tunein.page @@ -16,12 +16,17 @@ RadioTime/AIR interface for listener feedback or something. ST2 queries the OPML lists only for radio stations currently.

Configuration + + + <code>🔠 Categories </code>

You can switch between "music" and "genres" list. The genres list is basically a longer and expanded variant of "music". Use Channel Reload category tree to update them thereafter.

+ +
Index: help/channel_xiph.page ================================================================== --- help/channel_xiph.page +++ help/channel_xiph.page @@ -61,17 +61,17 @@

As new alternative, you can let ST2 directly scrape the station lists from dir.xiph.org (like it does for other channels). This is something which Xiph doesn't approve of. But the drawbacks of their alternative offerings are too severe and user-unfriendly; which is why there's this raw HTML extraction mode now.

-

The website listings contain full station homepages and a few - more extras. In this mode we can even acceess the XSPF playlist - formats directly. Both, the server search function, or browsing by - audio/video format are supported.

+

Ass of May 2020 the website listings don't contain station homepages + anymore either. So, the accessibility advantage is gone. However, + stations now list the raw streaming server url now. And extraction + is comparatively faster still.

A miximum of 100 entries get fetched in this mode however (which is 5 pages à 20 entries).

The filter-by-bitrate option is now a generic plugin.

Index: help/channel_youtube.page ================================================================== --- help/channel_youtube.page +++ help/channel_youtube.page @@ -15,15 +15,15 @@

This plugin is no longer supported or a default channel. Due to exceeded quotas, it ceased working, and Youtube/Google bothered me with inane requests for video recordings of how ST2 works (instead of simply looking at the code or investigating their own logs). Btw, the exceeded quota was unlikely due to regular ST2 usage. It's - more probable the builtin and plainly-in-sight builtin API key was - reappropriated otherwise. Hence, you would have to + more probable the builtin and plain-in-sight API key was reappropriated + otherwise. Hence, you would now have to get - your own key now, if you wanted to use this channel. Btw, - overall it's not that interesting / worth the effort IMO.

 + your own key, if you wanted to use this channel. Overall this + channel is not that interesting / worth the effort IMO.

Googles Youtube provides a quirky JSON API that makes browsing channels and genres feasible. This beta plugin provides a little overview, and usually retrieves recent video uploads.

Index: help/configuration.page ================================================================== --- help/configuration.page +++ help/configuration.page @@ -58,14 +58,16 @@

Application names are most always lowercase binary names.

 -

Double click an entry to edit it. After editing, the icon - next to the application name will be updated. If it stays green, it's - likely to work. If it turns red / into a stop symbol, then the - entered name is likely incorrect. (Only works on U*ix-systems.)

 +

Double click an entry to edit it. Press ENTER to + have the new value applied.

+

After editing, the icon next to the application name will be + updated. If it stays green, it's likely to work. If it turns red / + into a stop symbol, then the entered name is likely incorrect. (Only + works on U*ix-systems.)

After the application name, you can optionally use a placeholder:

%pls → default format

 Index: help/contrib_features.page ================================================================== --- help/contrib_features.page +++ help/contrib_features.page @@ -232,17 +232,25 @@ Opus stations stand out. (Not all channels provide exact format information, so you'll mostly notice for Jamendo and Xiph.)

- 🔌 Win32/subprocess + 🔌 Win32/subprocess

Wraps the player/application exec() method. Instead of simple shell execution, uses the Python subprocess module or win32 API functions. This is mostly unneeded on Linux (kills a few features even), but avoids the cmd.exe popup and delay on Windows. Highly experimental at the moment.

+
+ 🔌 New favourite category +

Adds a "New favourite category..." under Station > Extensions menu, + and context menu options to copy station entries there. DND from + other channels works, if you preselect the new subcategory beforehand. + It's an afterthought/workaround for those who insist on using ST2 for + stream management.

+
Index: help/html/bookmarks.html ================================================================== --- help/html/bookmarks.html +++ help/html/bookmarks.html @@ -58,12 +58,12 @@ -

However the favourite list itself can not yet be categorized - further.

+

There's a feature plugin + to provide for favourite subcategories. You'd usually move items there per drag'n'drop. It's somewhat of a workaround, however.

Searching — Quicksearch field and Ctrl+F compound search window.
Timer — Programming recurring play and recording events.
Index: help/html/configuration.html ================================================================== --- help/html/configuration.html +++ help/html/configuration.html @@ -55,14 +55,18 @@ setting dialog simply associates an audio type with a playback application:

  • Application names are most always lowercase binary names.

    • -

  • Double click an entry to edit it. After editing, the icon - next to the application name will be updated. If it stays green, it's - likely to work. If it turns red / into a stop symbol, then the - entered name is likely incorrect. (Only works on U*ix-systems.)

    • +
  • +

    Double click an entry to edit it. Press ENTER to + have the new value applied.

    +

    After editing, the icon next to the application name will be + updated. If it stays green, it's likely to work. If it turns red / + into a stop symbol, then the entered name is likely incorrect. (Only + works on U*ix-systems.)

    +

  • After the application name, you can optionally use a placeholder:

    • %pls → default format

      • Index: help/html/contrib_features.html ================================================================== --- help/html/contrib_features.html +++ help/html/contrib_features.html @@ -243,16 +243,23 @@

      🔌 OGG Icon

      Introduces small state icons to make higher-quality Vorbis and Opus stations stand out. (Not all channels provide exact format information, so you'll mostly notice for Jamendo and Xiph.)

    -

    🔌 Win32/subprocess

    +

    🔌 Win32/subprocess

    Wraps the player/application exec() method. Instead of simple shell execution, uses the Python subprocess module or win32 API functions. This is mostly unneeded on Linux (kills a few features even), but avoids the cmd.exe popup and delay on Windows. Highly experimental at the moment.

    +
    +

    🔌 New favourite category

    +

    Adds a "New favourite category..." under Station > Extensions menu, + and context menu options to copy station entries there. DND from + other channels works, if you preselect the new subcategory beforehand. + It's an afterthought/workaround for those who insist on using ST2 for + stream management.

  • -

    ☑ OnAir updates

    +

    🔰 OnAir updates

    And the song title updating can be disabled (for speedier loading). Future versions of this channel plugin might poll it automatically, and keep the station list auto-updated.

Index: help/html/reddit.html ================================================================== --- help/html/reddit.html +++ help/html/reddit.html @@ -71,11 +71,11 @@
🔟 Number of pages to fetch

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.)

-
☑ Filter walled gardens
+
🔰 Filter walled gardens

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 @@ -105,11 +105,11 @@

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

-
☑ Keep all web links
+
💫 Keep all web links

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.

Index: help/html/somafm.html ================================================================== --- help/html/somafm.html +++ help/html/somafm.html @@ -36,18 +36,21 @@

SomaFM is a non-commercial and ad-free provider. It strongly depends on listener donations.

-

Bitrate configuration

-
+
+
+
🔟 Bitrate configuration
+

It provides streaming links in different audio formats. Only AAC64 is guaranteed to be available for all. Other bitrates depend on the station.

After reconfiguring the bitrate/format, you can Reload the station list to update them. Otherwise refreshing has no effect.

-
+ +