NAME

       streamtuner2 - Browser for internet radio stations

SYNOPSIS

       streamtuner2 command [ channel,...  ] [ title ]

DESCRIPTION

       Streamtuner2  is  a  graphical  application  for  browsing  through internet radio station
       directories, like: • Shoutcast •  Xiph.org  •  SurfMusik  •  Internet-Radio  •  Jamendo  •
       MyOggRadio • RadioBrowser • SomaFM • TuneIn • Streema

       It  utilizes  your  configured  audio  player  or  recording  applications,  which  can be
       configured in the <F12> settings window.

       It is written in Python and easy to extend. And besides  the  grapical  interface,  has  a
       commandline interface. It comes with a couple of feature plugins and additional channels.

OPTIONS

       Without any options, it starts in the graphical mode, of course.

       help   Prints out a summary of available commands.

       Cached data

       stream channel title
              Searches  for  a station with the given title. Either looks in a single channel, or
              scans all plugins.

       url channel title
              Prints out only the streaming URL.

       play [channel] title
              Invokes the configured audio player.

       Instantly retrieve data from directory service

       categories channelname
              Returns a nested JSON list of all categories/genres.

       category "channelname" "Category"
              Prints out a JSON list of the genre. Each entry constains title, url and other meta
              information. Note that the category must have the exact case.

EXAMPLES

       streamtuner2 stream shoutcast,xiph "Top 100"
              Searches for the term "Top 100" in the shoutcast and xiph channels, and returns all
              info about the first match as JSON output.

       streamtuner2 play frequence3
              Looks for the first occourence, and starts the audio player for FREQUENCE3.

       streamtuner2 category tunein Jazz
              Dumps a JSON list of all stations the named genre.

GRAPHICAL MODE

       There's only one option for the graphical UI mode:

       --gtk3 Loads Gtk3 via PyGI instead of Gtk2. This  is  implicit  when  running  on  Python3
              anyway.

       --nt   No-threading  mode  avoids  some  UI  separation,  but stabilizes the interface (in
              particular channel loading crashes occassionally) for  some  Gtk2/Gtk3  and  Python
              combinations.

       -d plugin
              Disable  plugin  from  loading.  Plugin names are all-lowercase and sometimes short
              versions of the channel or feature, such as "reddit", "xiph", "favicons" or "dnd".

       -e plugin
              Load a plugin that isn't set by default.

OTHER OPTIONS

       -D     Enable debug mode, which shows a  lot  of  activity  messages  during  Streamtuner2
              running - including UI changes and network requests or extraction steps.

       -V     Show streamtuner version.

       version -v
              Summarize all plugin versions.

FILES

       /home/$USER/.config/streamtuner2/settings.json

SEE ALSO

       streamripper(1) audacious(1) json(5) m3u(5) pls(5)