streamtuner2(1)

1streamtuner2(1)               Application manuals              streamtuner2(1)
2
3
4

NAME

6       streamtuner2 - Browser for internet radio stations
7

SYNOPSIS

9       streamtuner2 command [ channel,...  ] [ title ]
10
11

DESCRIPTION

13       Streamtuner2  is  a graphical application for browsing through internet
14       radio station directories, like: · Shoutcast · Xiph.org ·  SurfMusik  ·
15       Internet-Radio  · Jamendo · MyOggRadio · RadioBrowser · SomaFM · TuneIn
16       · Streema
17
18       It utilizes your configured audio  player  or  recording  applications,
19       which can be configured in the <F12> settings window.
20
21       It  is  written  in Python and easy to extend. And besides the grapical
22       interface, has a commandline interface. It comes with a couple of  fea‐
23       ture plugins and additional channels.
24
25

OPTIONS

27       Without any options, it starts in the graphical mode, of course.
28
29
30       help   Prints out a summary of available commands.
31
32
33       Cached data
34
35
36       stream channel title
37              Searches  for  a station with the given title. Either looks in a
38              single channel, or scans all plugins.
39
40       url channel title
41              Prints out only the streaming URL.
42
43       play [channel] title
44              Invokes the configured audio player.
45
46
47       Instantly retrieve data from directory service
48
49
50       categories channelname
51              Returns a nested JSON list of all categories/genres.
52
53       category "channelname" "Category"
54              Prints out a JSON list of the genre. Each entry constains title,
55              url and other meta information. Note that the category must have
56              the exact case.
57
58

EXAMPLES

60       streamtuner2 stream shoutcast,xiph "Top 100"
61              Searches for the term "Top 100" in the shoutcast and xiph  chan‐
62              nels, and returns all info about the first match as JSON output.
63
64       streamtuner2 play frequence3
65              Looks  for the first occourence, and starts the audio player for
66              FREQUENCE3.
67
68       streamtuner2 category tunein Jazz
69              Dumps a JSON list of all stations the named genre.
70
71
72

GRAPHICAL MODE

74       There's only one option for the graphical UI mode:
75
76       --gtk3 Loads Gtk3 via PyGI instead of Gtk2. This is implicit when  run‐
77              ning on Python3 anyway.
78
79
80       --nt   No-threading  mode avoids some UI separation, but stabilizes the
81              interface (in particular channel loading crashes  occassionally)
82              for some Gtk2/Gtk3 and Python combinations.
83
84
85       -d plugin
86              Disable  plugin from loading. Plugin names are all-lowercase and
87              sometimes short versions of the  channel  or  feature,  such  as
88              "reddit", "xiph", "favicons" or "dnd".
89
90
91       -e plugin
92              Load a plugin that isn't set by default.
93
94

OTHER OPTIONS

96       -D     Enable debug mode, which shows a lot of activity messages during
97              Streamtuner2 running - including UI changes and network requests
98              or extraction steps.
99
100
101       -V     Show streamtuner version.
102
103
104       version -v
105              Summarize all plugin versions.
106
107

FILES

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