Index: help/html/bookmarks.html ================================================================== --- help/html/bookmarks.html +++ help/html/bookmarks.html @@ -7,15 +7,15 @@
+♪ Streamtuner2  › Browsing channels and radio stations » Channels › Available channels »
-Streamtuner2 › Channel tabs »
+♪ Streamtuner2  › Channel tabs »

Bookmarks

Index: help/html/channels.html ================================================================== --- help/html/channels.html +++ help/html/channels.html @@ -6,11 +6,11 @@

Channels

The tabs in the main window represent the music directory @@ -54,11 +54,11 @@

Channel service homepage

-

You can dobule click the channel tab to visit the channel/directory homepage. +

You can double click the channel tab to visit the channel/directory homepage. Alternatively there is an entry in the Channel menu.

Channel menu actions

Index: help/html/cli.html ================================================================== --- help/html/cli.html +++ help/html/cli.html @@ -6,11 +6,11 @@

CLI (command line interface)

Streamtuner2 is a graphical tool. But it also has a limited commandline interface, Index: help/html/config_apps.html ================================================================== --- help/html/config_apps.html +++ help/html/config_apps.html @@ -6,11 +6,11 @@

Audio players

On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can Index: help/html/configuration.html ================================================================== --- help/html/configuration.html +++ help/html/configuration.html @@ -6,11 +6,11 @@

Configuration / Settings dialog

Index: help/html/contrib_channels.html ================================================================== --- help/html/contrib_channels.html +++ help/html/contrib_channels.html @@ -7,17 +7,17 @@

→ Contrib/Extra Channels

Index: help/html/contrib_features.html ================================================================== --- help/html/contrib_features.html +++ help/html/contrib_features.html @@ -7,15 +7,15 @@

→ Feature plugins

Extra functionality and behaviour changes are available in @@ -77,10 +77,20 @@

  • It's technically unneeded, as ST2 isn't stressful to directory websites and not blocked anywhere.

  • It's only useful as additional privacy feature really, but shouldn't be used habitually.

+
+
+

🔌 History

+

Provides the small "history" category in the bookmarks tab. The length of +which is configurable (defaults to 20).

+
+
+

🔌 Links to directory services

+

Adds a list of weblinks to other online music services in the "links" category +within the bookmarks tab.

Other feature plugins

    @@ -125,10 +135,14 @@ why this isn't a built-in feature. However, it's oft-requested anyway.

    🔌 tmp_clean_multiurl

    Strips extra space-separate URLs from station list. (Currently only required for 📻 RadioSure channel. Later ST2 versions will likely support such entries per default again).

    +
    🔌 stop_button
    +

    Adds the toolbar button to stop streamripper/fpls - same as in + streamtuner1. Has become kind of redundant due to the newer + 🔌 specbuttons plugin.

Dirble

//dirble.com/

Index: help/html/dragndrop.html ================================================================== --- help/html/dragndrop.html +++ help/html/dragndrop.html @@ -6,11 +6,11 @@

Drag'n'drop

With the DND feature plugin enabled, there's an even simpler Index: help/html/edit.html ================================================================== --- help/html/edit.html +++ help/html/edit.html @@ -7,13 +7,13 @@

Edit

Index: help/html/favicon.html ================================================================== --- help/html/favicon.html +++ help/html/favicon.html @@ -6,11 +6,11 @@

Station favicons

Per default you'll get a small logo / icon for any station @@ -25,11 +25,12 @@ or banners even. Whereas normal favicons are just 16x16 pixel images.

Downloaded image files are meanwhile all sanitized (internally converted to ensure they're really image files). Albeit that's not strictly necessary for modern Gtk versions. (But better safe than sorry). -Images are kept in the ~/.config/streamtuner2/icons directory. +Images are kept in the ~/.config/streamtuner2/icons directory +(or below %APPDATA%\ on Windows).

Configuration options

Index: help/html/filtermusic.html ================================================================== --- help/html/filtermusic.html +++ help/html/filtermusic.html @@ -7,15 +7,15 @@

filtermusic

//filtermusic.net/

@@ -33,11 +33,11 @@ listen to most popular stations.

Configuration

-

Like the 📻 Xiph plugin this channel provides +

Like the 📻 Xiph plugin this channel provides three fetch modes:

Global_key

Using the global_key extension you can define a keyboard shortcut for switching within Index: help/html/glossary.html ================================================================== --- help/html/glossary.html +++ help/html/glossary.html @@ -6,11 +6,11 @@

+♪ Streamtuner2  ›  »

Glossary

Channel
Index: help/html/homepage.html ================================================================== --- help/html/homepage.html +++ help/html/homepage.html @@ -7,13 +7,13 @@

Radio homepages

Index: help/html/img/logo.png ================================================================== --- help/html/img/logo.png +++ help/html/img/logo.png cannot compute difference between binary files Index: help/html/index.html ================================================================== --- help/html/index.html +++ help/html/index.html @@ -1,34 +1,30 @@ -Streamtuner2 +♪ Streamtuner2
-

Streamtuner2

+

♪ Streamtuner2

-
-
-

♪ Streamtuner2

-
-

Streamtuner2 shows internet radio stations for easy browsing, playing, recording.

- -
-
+

Streamtuner2 shows internet radio stations for easy browsing, playing, recording.

Channel tabs

Index: help/html/internet_radio_org_uk.html ================================================================== --- help/html/internet_radio_org_uk.html +++ help/html/internet_radio_org_uk.html @@ -7,15 +7,15 @@

Internet-Radio

//internet-radio.com/

@@ -24,11 +24,11 @@

Internet-Radio.com is a broad alternative to Shoutcast.

  • It has regained station homepages for most entries again.

  • Genres are similiar to Shoutcast.

  • -
  • Updating station lists is comperatively fast.

  • +
  • Updating station lists is comparatively fast.

  • Uses HTML extraction (regex or pyquery) internally.

Configuration

Index: help/html/introduction.html ================================================================== --- help/html/introduction.html +++ help/html/introduction.html @@ -6,16 +6,16 @@

Introduction

-

Streamtuner2 is a simple browser for internet radios. It aquires its radio lists +

Streamtuner2 is a simple browser for internet radios. It acquires its radio lists from various directory services. These are represented as "channel" tabs in the main window. The category/genre lists are in the left pane, and associated stations right to them.

@@ -92,14 +92,14 @@
Index: help/html/jamendo.html ================================================================== --- help/html/jamendo.html +++ help/html/jamendo.html @@ -7,24 +7,24 @@

Jamendo

//jamendo.com/

-

Jamendo is a Creative Comments licensing oriented music distributor. It +

Jamendo is a Creative Commons licensing oriented music distributor. It hosts audio files for individual musicians and artists. It allows to list albums, playlists, and individual tracks by genre.

  • The new Jamendo v3.0 is now utilized, which is JSON based and easy to extract.

  • Its radio list is static. It loops over randomized songs from each genre.

  • Index: help/html/json.html ================================================================== --- help/html/json.html +++ help/html/json.html @@ -6,11 +6,11 @@
    +♪ Streamtuner2  ›  » Glossary › Filetypes »

JSON files

JSON is a data representation format derived from Javascript (the browser embedded Index: help/html/m3u.html ================================================================== --- help/html/m3u.html +++ help/html/m3u.html @@ -6,11 +6,11 @@

+♪ Streamtuner2  ›  » Glossary › Filetypes »

.M3U files

M3U files also contain playlists, like .pls files. They're often used by desktop audio players.

Index: help/html/modarchive.html ================================================================== --- help/html/modarchive.html +++ help/html/modarchive.html @@ -7,13 +7,13 @@

The MOD Archive

//modarchive.org/

Index: help/html/myoggradio.html ================================================================== --- help/html/myoggradio.html +++ help/html/myoggradio.html @@ -7,15 +7,15 @@

MyOggRadio

//myoggradio.org/

@@ -27,18 +27,18 @@

Since it provides its station list as JSON it's very well supported.

Sharing is caring

To help with populating the directory further, - streamtuner2 provides an option to share radion station links. + streamtuner2 provides an option to share radio station links. Use the Station ▸ Share on MyOggRadio... context menu entry to upload a selected radio (e.g. from your bookmarks).

Personal

-

The personal section is empty per default. You need to specify an user account +

The personal section is empty per default. You need to specify a user account in the settings dialog, and actually bookmark stations in the MyOggRadio web site. Shared entries aren't automatically in the personal list.

MyOggRadio also has a neat cross-platform player: JMyOggRadioPlayer.

Index: help/html/playing.html ================================================================== --- help/html/playing.html +++ help/html/playing.html @@ -7,15 +7,15 @@

Playing

Index: help/html/pls.html ================================================================== --- help/html/pls.html +++ help/html/pls.html @@ -6,11 +6,11 @@
+♪ Streamtuner2  ›  » Glossary › Filetypes »

.PLS files

Playlist files often have the extension .pls

Index: help/html/pluginmanager2.html ================================================================== --- help/html/pluginmanager2.html +++ help/html/pluginmanager2.html @@ -6,11 +6,11 @@

Plugin Manager 2 - 📦 Add

For updating or installing new plugins (extra channels or @@ -58,13 +58,14 @@

User plugins

-

Downloaded plugins are stored in ~/.config/streamtuner2/plugins. +

Downloaded plugins are stored in ~/.config/streamtuner2/plugins/. To remove them, delete the individual *.py files there manually. But keep the __init__.py stub.

+

On Windows they're stored in %APPDATA%\streamtuner2\plugins\.

Core plugins (those which are installed system-wide) can often also be updated. The user-saved plugin will take precedence after a restart. However the version number in PluginManager2 still shows the system-installed/older version Index: help/html/radiobrowser.html ================================================================== --- help/html/radiobrowser.html +++ help/html/radiobrowser.html @@ -7,15 +7,15 @@

Radio-Browser

//radio-browser.info/

@@ -25,29 +25,29 @@

Radio-Browser is an ambitious community project. It collects as many public internet radio stations as possible. It's free to use, has a well documented API, with a simple JSON interface.

It's now the backend in many open source music players:

    -
  • Rhytmbox (for which it was originally intended)

  • +
  • Rhythmbox (for which it was originally intended)

  • Streamtuner2 (obviously)

  • RadioDroid (Android)

  • DreamBox plugin

  • Musicbox (Android)

  • Gradio

  • Kodi/XBMC

-

Since v0.3 / streamtuner2.2.0 you can now also share your favorite +

Since v0.3 (in streamtuner2 2.2.0) you can now also share your favorite 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 catogory view.

+ again to update the category view.

With RadioDroid Index: help/html/radionomy.html ================================================================== --- help/html/radionomy.html +++ help/html/radionomy.html @@ -7,15 +7,15 @@

Radionomy

//radionomy.com/

Index: help/html/recording.html ================================================================== --- help/html/recording.html +++ help/html/recording.html @@ -7,15 +7,15 @@

Recording

Index: help/html/reddit.html ================================================================== --- help/html/reddit.html +++ help/html/reddit.html @@ -7,15 +7,15 @@

Reddit

//reddit.com/r/Music

@@ -42,15 +42,16 @@ of just showing playable content.

Status icons

-

Channel entries contain a custom status icon leftmost (to the genre). -It's quick indicator of what type of content is linked:

+

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)

+

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

▶▶

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

▮▮

Walled gardens without playback handler.

📄
Index: help/html/reloading.html ================================================================== --- help/html/reloading.html +++ help/html/reloading.html @@ -6,11 +6,11 @@

Reloading

Station information can get stale. Especially Shoutcast invalidates old information Index: help/html/saving.html ================================================================== --- help/html/saving.html +++ help/html/saving.html @@ -7,13 +7,13 @@

Saving

Index: help/html/search.html ================================================================== --- help/html/search.html +++ help/html/search.html @@ -7,17 +7,17 @@

Searching

There are two search functions.

Index: help/html/shoutcast.html ================================================================== --- help/html/shoutcast.html +++ help/html/shoutcast.html @@ -7,13 +7,13 @@

Shoutcast

//shoutcast.com/

Index: help/html/somafm.html ================================================================== --- help/html/somafm.html +++ help/html/somafm.html @@ -7,15 +7,15 @@

SomaFM

//somafm.com/

Index: help/html/specbuttons.html ================================================================== --- help/html/specbuttons.html +++ help/html/specbuttons.html @@ -6,11 +6,11 @@

Special extra/mini buttons

Using the specbuttons plugin, you can define additional Index: help/html/streams.html ================================================================== --- help/html/streams.html +++ help/html/streams.html @@ -6,11 +6,11 @@

Streams / Stations

Radio stations are listed in the right pane. Usually they have a title and a Index: help/html/surfmusik.html ================================================================== --- help/html/surfmusik.html +++ help/html/surfmusik.html @@ -7,15 +7,15 @@

SurfMusic

//surfmusic.de/

Index: help/html/technical.html ================================================================== --- help/html/technical.html +++ help/html/technical.html @@ -6,11 +6,11 @@
+♪ Streamtuner2  ›  »

Technical information

@@ -39,11 +39,12 @@

Configuration files

-
+
+
/home/$USER/.config/streamtuner2/

Corresponds to the XDG_CONFIG_HOME setting. All ST2 configuration settings are contained within here and are in JSON format.

~/.config/streamtuner2/settings.json

General runtime options, plugin settings, and configured audio players.

@@ -57,11 +58,15 @@

JSON files for stream lists in each channel.

~/.config/streamtuner2/icons/*.png

Holds downloaded favicons for station homepages.

~/.config/streamtuner2/plugins/*.py

Contain downloaded contrib/ plugins.

-
+
+

On Windows the ~/.config/ directory is called + %APPDATA% instead. The paths in there are equally + structured.

+

Installation spread

/usr/bin/streamtuner2
Index: help/html/timer.html ================================================================== --- help/html/timer.html +++ help/html/timer.html @@ -7,29 +7,30 @@

Timer

You can programm play/recording events with the timer plugin. Simply select a station - and choose Station ▸ Extensions ▸ Add timer.... + and choose Station ▸ Add timer.... A small popup will ask for a data/time string. If you press OK the station - and the programmed time will be stored in the bookmarks channel in the "timer" category.

+ and the programmed time will be stored in the bookmarks channel in the "timer" category. + Please take note of the required text format.

Timer

Note that streamtuner2 must be running for the programmed timer events to work. (In a future version there might be the option to have it handled by the system cron daemon.)

@@ -42,21 +43,21 @@

For example "Mon,Tue,Wed" will make the event occour on the first three days of each week, while just "Fri" would limit it to Fridays.

A clock range of "18:00-20:00" would start the event at 18 o'clock and last it two hours. Note that for "play" events, the end time is irrelevant, since streamtuner2 can't kill your audio player anyway.

-

The end time is only important, if you replace "play" with the word "record" +

The end time is only important if you replace "play" with the word "record" in the timer event string. This runs streamripper instead and limits the recording time.

Editing events

You can remove entries from the "timer" list again. Use the normal Edit ▸ Delete for that. It's also possible to modify the date+time strings by editing the stream info and the specification in the "playing" field.

-

However, such changes don't take effect until you restart streamtuner2. The timer +

However, such edits don't take effect until you restart streamtuner2. The timer events are only scheduled when adding a new event, or on starting streamtuner2.

TuneIn

//tunein.com/

Index: help/html/ubuntuusersm.html ================================================================== --- help/html/ubuntuusersm.html +++ help/html/ubuntuusersm.html @@ -7,13 +7,13 @@

UbuntuUsers

//ubuntuusers.de/

Index: help/html/xiph.html ================================================================== --- help/html/xiph.html +++ help/html/xiph.html @@ -7,15 +7,15 @@

Xiph.org

//dir.xiph.org/

Index: help/html/youtube.html ================================================================== --- help/html/youtube.html +++ help/html/youtube.html @@ -7,15 +7,15 @@

Youtube

//youtube.com/

Index: help/technical.page ================================================================== --- help/technical.page +++ help/technical.page @@ -66,10 +66,13 @@ <file>~/.config/streamtuner2/plugins/*.py</file>

Contain downloaded contrib/ plugins.

+

On Windows the ~/.config/ directory is called + %APPDATA% instead. The paths in there are equally + structured.

Installation spread