1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
.\" (many thanks to the manpage howto!)
.\"
.TH streamtuner2 1 "2015-04-02" "2.1.4" "Application manuals"
.SH NAME
streamtuner2 \- Browser for internet radio stations
.SH SYNOPSIS
.B streamtuner2
.I command
[
.BI channel ,...
] [
.IB title
]
.SH DESCRIPTION
Streamtuner2 is a graphical application for browsing through internet
radio station directories, like:
.2c
.R "\(bu Shoutcast"
.R "\(bu Xiph.org"
.R "\(bu SurfMusik"
.R "\(bu Internet-Radio"
.R "\(bu Jamendo"
.R "\(bu MyOggRadio"
.R "\(bu RadioBrowser"
.R "\(bu SomaFM"
.R "\(bu TuneIn"
.R "\(bu Streema"
.1c
.PP
It utilizes your configured audio player or recording applications, which
can be configured in the
.BR "<F12>"
settings window.
It is written in
.IR 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.
.SH OPTIONS
Without any options, it starts in the graphical mode, of course.
.TP
.BI help
Prints out a summary of available commands.
.PP
.B Cached data
.TP
.BI stream " channel title"
Searches for a station with the given title. Either looks in a single
channel, or scans all plugins.
.TP
.BI url " channel title"
Prints out only the streaming URL.
.TP
.BI play " " [ channel ] " title"
Invokes the configured audio player.
.PP
.B Instantly retrieve data from directory service
.TP
.BI categories " channelname"
Returns a nested JSON list of all categories/genres.
.TP
.BI 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.
.SH EXAMPLES
.TP
.BI 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.
.TP
.BI streamtuner2 " play frequence3"
Looks for the first occourence, and starts the audio player for FREQUENCE3.
.TP
.BI streamtuner2 " category tunein Jazz"
Dumps a JSON list of all stations the named genre.
.SH GRAPHICAL MODE
There's only one option for the graphical UI mode:
.TP
.BI --gtk3
Loads Gtk3 via PyGI instead of Gtk2. This is implicit when running on Python3
anyway.
.TP
.BI --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.
.TP
.BI -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".
.TP
.BI -e " plugin"
Load a plugin that isn't set by default.
.SH OTHER OPTIONS
.TP
.BI -D
Enable debug mode, which shows a lot of activity messages during
Streamtuner2 running - including UI changes and network requests or
extraction steps.
.TP
.BI -V
Show streamtuner version.
.TP
.BI version " -v"
Summarize all plugin versions.
.SH FILES
.IR /home/ $USER /.config/streamtuner2/settings.json
.SH "SEE ALSO"
.BR streamripper (1)
.BR audacious (1)
.BR json (5)
.BR m3u (5)
.BR pls (5)
|
