Most radio stations are listed with a homepage URL. Use the
Most radio stations are listed with a homepage URL. Use the
Some homepage links are guessed, because some channels (e.g. Shoutcast) don't provide them (anymore). If you play a station without homepage URL, it automatically gets googled. (The link will be visible once you reselect the genre/category.) Index: help/action_playing.page ================================================================== --- help/action_playing.page +++ help/action_playing.page @@ -11,11 +11,12 @@
Simply double click a station entry. It starts with your configured audio player.
In streamtuner2 you can configure different audio players for different audio - formats (MP3 or OGG). In the 'Apps' section of the settings dialog, you can associate a player + formats (MP3 or OGG). In the Apps section of the + settings dialog, you can associate one player with each audio file (MIME) type. Per default this is audacious, but you can use any other media player (like VLC).
Note however that some audio players will run multiple instance and won't
allow simple station switching. In such situations it might be sensible to write
Index: help/action_recording.page
==================================================================
--- help/action_recording.page
+++ help/action_recording.page
@@ -9,29 +9,33 @@
Most stations that stream MP3 or OGG music can be recorded. This is accomplished through
-the command-line tool "streamripper". If you select a station and press
Most stations that stream MP3 or OGG music can be recorded. This is
+accomplished through the command-line tool
You can configure the recording tool according to audio types again.
The
The
Format | Application |
audio/* |
To configure a default download directory, use the
You can export the currently selected stream using
-
But you can also save in .pls or .xspf or .asx or .smil format. - Note that the lower right dropdown has no effect. You have to edit the - filename field.
+The extension of the filename decides on the saved link format. Per + default a .m3u file is created, because that's what most audio players + understand.
+ + But you can also save in
It's easy to lose oversight when switching across channel tabs, - genres and internet radio stations. Therefore streamtuner2 allows - to bookmark stations to collect favoured streams in a single place.
- -Just right click a station you want to bookmark, and choose bookmark in the context - menu. Alternatively you can use the Streams entry in the application menu. Once bookmarked - you can see the station entry in the (!) "bookmarks" tab, under "favourite". That's where - they go.
+Streamtuner2 allows to bookmark favoured streams/stations.
+ Which is what the
Use the right click a stations
Once bookmarked the station is listed under
+
Entries can be removed from the bookmark list again. Use the edit menu for that.
+Entries can be removed from the bookmark list again. Use
+
Bookmarked stations are shown with a star in all other channel tabs. If you delete the - entry there, it won't remove it from the real bookmarks list.
+You can also manually adapt an entry via
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.
+However the favourite list itself can not yet be categorized + further.
Jamendo is a Creative Comments licensing oriented music distributor. It hosts audio - files for individual musicians and artists. Tracks and albums can thus be downloaded - free of charge. Yeah, imagine that.
- -The new Jamendo v3.0 is now utilized. It allows to list albums, - playlists, and individual tracks by genre. The radio list is static - (they're looping over randomized songs from each genre.)
- -Instead of favicons, streamtuner2 can fetch album or track - covers. Thus the images are a bit larger, and retrieving them all - via Channel > Load favicons... takes a while longer.
+Jamendo is a Creative Comments licensing oriented music distributor. It hosts audio +files for individual musicians and artists. Tracks and albums can thus be downloaded +free of charge. Yeah, imagine that.
+ +The new Jamendo v3.0 is now utilized. It allows to list albums, +playlists, and individual tracks by genre. The radio list is static +(they're looping over randomized songs from each genre.)
+ +Instead of favicons, streamtuner2 can fetch album or track
+covers. Thus the images are a bit larger, and retrieving them all
+via
You can switch between MP3 and Ogg Vorbis audio streams for Jamendo. + It's not honored by the radio section, but albums and tracks should be + received as Ogg when configured so.
+Album covers are downloaded in lieu of favicons. They're available + in different sizes. Use 25px if you want just favicon-sized icons.
+Currently only 1 page (of 200 entries each) of album/track lists are + fetched.
+Setting a higher value may not work.
MODPlug for XMMS
GModplay
VLC (built-in support)
See recording + configuration if you want to enable the download mode. (Audio + files are packaged up in ZIP files on MODArchive.)
MyOggRadio is an open source internet radio directory project. Since it provides its station list as JSON it's very well supported.
-Because the directory is currently still rather small,
- streamtuner2 provides the option to share radion station links. Use
- the
To help with populating the directory further,
+ streamtuner2 provides an option to share radion station links.
+ Use
The personal section is empty per default. You need to specify an user account - in the settings dialog, and actually bookmark stations in MyOggRadio web site. - Shared entries are not automatically in the MOR favorite list.
+ in the settings dialog, and actually bookmark stations in the MyOggRadio web site. + Shared entries aren't automatically in the MOR favorite list.There's also JMyOggRadioPlayer as specific frontend and player for MyOggRadio.
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 entries for currently played songs, and homepage links are largely gone. Hencewhy the Shoutcast channel is no longer considered a primary feature.
-Uses an XML parser to extract station data from within HTML <tags> of the shoutcast.com site. This is - slower, but often more reliable than regular expressions, which look for plain text markers.
-The bitrate of an audio stream determines the music quality. Many Xiph streams have simple and low quality microphone sources. To filter these out, and only leave high quality music - stations, you can therefore set this option. OGG starts to sound well with 96 kbit/s (whereas + stations, you can therefore change this option. OGG starts to sound well with 96 kbit/s (whereas MP3 often requires 148 or 192 at least).
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.
-VLC can directly play Youtube URLs. For other players the default application - setting wraps youtube-dl, which is also - used for recording.
+VLC can directly play Youtube URLs. For other players one can use
+ youtube-dl as wrapper.
+ For example
Youtube-dl is preconfigued as "recording"/download tool for this channel + tab.
+ +Of course you could also just invoke a specific YT video by
+ opening it in your web browser - click the station
You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
To apply this setting, and have new categories show up in the genre pane, use
It's not an exact map, but utilizes the search function to find channels.
Only influences the video homepage link.
+You can dobule click the channel tab to visit the channel/directory homepage.
Alternatively there is an entry in the
Opens a webbrowser with the current channels website.
Updates the genre list in the left category pane. For most channels the category list is already complete, but it might - change over time. So this option often only is used for initializing streamtuner2 + change over time. So this option is often only used for initializing streamtuner2 channels when the list is empty.
The channel menu also contains a list of available channels. Select an entry to switch into that tab.
Specifying a channel name is often optional. If you add one, it should be all-lowercase. You can also give a list, like "shoutcast,xiph" which would be searched then.
-GUI mode: There are also --gtk3 and --gtk2 command line options. Usually the right toolkit
+ There are also --gtk3 and --gtk2 command line options. Usually the right toolkit
is picked depending on Python version. But you can manually override this. There are various options for streamtuner2, available under
+There are various options for streamtuner2, available under Bookmarked stations will be marked with a ★ star in all other station lists / categories.
That doesn't often work for the same station entry from two different channel services / tabs though. Be careful. While Gtk allows to select a different theme per application, not all themes
+ Be careful. While Gtk allows to select a different theme per application, not all themes
work right away. Switching the theme might hang streamtuner2. Just restart if that happens. Automatically remember window size, selected channel tab, categories, or selected station.
@@ -152,18 +153,18 @@
Streamtuner2 creates temporary .m3u files, if an audio player is configured to use %m3u files
- instead of %pls or %srv URLs. For archival purposes, you might want to set a dedicated directory
+ Streamtuner2 creates temporary .m3u files - for audio players that are configured to use %m3u files
+ instead of %pls or %srv URLs. For archival purposes you might want to set a dedicated directory
for this. Leave this to the default /tmp else. Is where streamtuner2 keeps its settings.json and channel caches, favicons, etc.
- You can't set this in the config dialog. This is just for display. Set the XDG_CONFIG_HOME
+ Is where streamtuner2 keeps its If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state
@@ -181,13 +182,13 @@
you want to enable. You have to restart Streamtuner2 for any changes here to take effect. Each channel plugin may come with its own set of addition configuration settings
below. If you want to find out more about the short option descriptions (most settings are checkboxes),
+ If you want to find out more about the short option descriptions (most settings are checkboxes),
please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding
- *.py files. These are readable, and sometimes contain more information.
Using the global_key extension you can define a keyboard shortcut for switching within a list of favourite radio stations. Per default it uses your bookmarks list, but it can be configured to alternate in any other channel.
-This is useful if you don't want to keep the streamtuner2 window in the foreground - all the time, but still want to switch radios easily.
+This is useful if you don't want to keep streamtuner2 atop your + desktop all the time, but still want to switch radios easily.
Go into settings
keyspec | corresponds to |
Play | Starts the radio in a configured audio player |
Record | Opens a terminal window and streamripper, which cuts the radio broadcast into individual mp3 songs. |
Bookmarks | Copy radio entry over into the |
Play | Starts the radio in a configured audio player |
Record | Opens a terminal window and streamripper, which cuts the radio broadcast into individual mp3 songs. |
Bookmarks | Copy radio entry over into the |
Homepage | Most radio stations have a homepage. Open this in a web browser. |
Saving | A radio entry can be exported as .m3u or .pls file. |
Extensions | Some plugins add other features in this submenu. |
Editing | This command is in the |
Searching | You can get a radio list according to search criteria. |