Internet radio browser GUI for music/video streams from various directory services.

⌈⌋ ⎇ branch:  streamtuner2


Changes To FAQ

Changes to "FAQ" between 2015-04-27 21:56:11 and 2015-04-30 01:03:48

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

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
-
+


-
+

-
+

-
+

-
+

-
+

-
-
-
+

-
+

-
+

-
+


-
+

-
+

-
+


-
+

-
+


-
+

-
+


-
+

+
-
+
+

+
+
+
+
+
+
+
+
+

+
+
+
+
+
+
+
+
-
+

-
+

+

+
-
+

-
+


-
+

-
+

-
+

That's not an actualy FAQ. More a list of questions that came up once.
That's not an actual FAQ. More a list of questions that came up once.


### Streamtuner2 doesn't start.
 1. <h3> Streamtuner2 doesn't start. </h3>

Check the list of [dependencies](index#~Dependencies) first.
    Check the list of [dependencies](index#~Dependencies) first.

Start it from a terminal instead to get more useful information. Alternatively enable the debug mode even:
    Start it from a terminal instead to get more useful information. Alternatively enable the debug mode even:

    streamtuner2 -D
        streamtuner2 -D

That'll reveal a bit more googleable error causes.
    That'll reveal a bit more searchable error causes. (Don't google for Gtk warnings though. They're seldomly relevant. And nobody cares.)

(Don't google for Gtk warnings though. Nobody cares.)

### Channel lists keep empty.
 2. <h3> Channel lists keep empty. </h3>

Again try to debug the startup first. If you're using an ancient distro package (2.0.8 is still distributed in some), then install a [newer package](http://sourceforge.net/projects/streamtuner2/files/) from the Sourceforge project page.
    Again try to debug the startup first. If you're using an ancient distro package (2.0.8 is still distributed in some), then install a [newer package](http://sourceforge.net/projects/streamtuner2/files/) from the Sourceforge project page.

Some directory services change their layout or listing details more frequently than others. So naturally ST2 won't be able to read them out forever. Look for updates.
    Some directory services change their layout or listing details more frequently than others. So naturally ST2 won't be able to read them out forever. Look for updates.

Alternatively try the [x] PyQuery parsing configuration setting.
    Alternatively try the [x] PyQuery parsing configuration setting.


### Wrong channel played.
 3. <h3> Wrong channel played. </h3>

There's a known bug in 2.0.x versions. When resorting a channel tab, the association to the actual stream data became out of order. Click F5 to reload.
    There's a known bug in 2.0.x versions. When resorting a channel tab, the association to the actual stream data became out of order. Click F5 to reload.

Better yet, use a newer version.
    Better yet, use a newer version.


### Category lists empty, or no stations are found.
 4. <h3> Category lists empty, or no stations are found. </h3>

Use "Channel &gt; Reload category tree" to update the genre list. If the directory service/website is down, you'll often get an empty list. Try again at a later time.
    Use "Channel &gt; Reload category tree" to update the genre list. If the directory service/website is down, you'll often get an empty list. Try again at a later time.


### Player doesn't start.
 5. <h3> Player doesn't start. </h3>

Please check the configuration dialog (F12). If any of the entries contain red markers, then the listed audio player isn't actually installed. You should get a similar notice on the console when running `streamtuner2 -D`
    Please check the configuration dialog (F12). If any of the entries contain red markers, then the listed audio player isn't actually installed. You should get a similar notice on the console when running `streamtuner2 -D`


### Stream recording doesn't work. No window appears or closes quickly again.
 5. <h3> Stream recording doesn't work. </h3>

    This is usually a misconfiguration.
Check that you actually have `streamripper` installed. See the configuration dialog (F12) if the listed terminal application really works. Otherwise edit it to `xterm` or `rxvt` for example.

     1. **No window appears.**

        Usually there's a terminal window coming up for recording. If it isn't, then the configuration dialog lists something like `x-terminal-emulator ...` in the recording table.

        See the configuration dialog (F12). It's likely marked with a red stop sign. In which case you'll need to use a different prefix, like `xterm` or `rxvt`, depending on what your distro has installed/available.

     2. **Window closes quickly again**

        This indicates that `streamripper` failed, or couldn't even be started.

        Append something like `; read -p WAIT` to the recording command to see its actual output.


     3. **Streamripper error message**

        If a stream cannot be played, it also cannot be recorded. Which is mostly because the radio streaming address is outdated / invalid / or just temporarily inaccessible.

        Recording may also be **blocked** server-side. In this case you might use the streamripper `-u` option to fake a different "User Agent" (a browser name). See the manual or streamripper manpage on some examples.


### Rhythmbox doesn't start playing.
 6. <h3> Rhythmbox doesn't start playing. </h3>

Rhythmbox is not so much an audio player, but more of a playlist manager (just like streamtuner2 itself). It'll often only add radios in some list, but qon't start with playback right away. It'll crash if it got feeded a XSPF playlist even (from Xiph perhaps). Use a different audio player.
    Rhythmbox is not so much an audio player, but more of a playlist manager (just like streamtuner2 itself). It'll often only add radios in some list, but won't start with playback right away. It'll crash if it got feeded a XSPF playlist even (from Xiph perhaps).

    Try `rhythmbox-client --play-uri=%pls` for the configuration. Or use a different audio player.


### RadioTray doesn't bookmark, it just plays the radio.
 7. <h3> RadioTray doesn't bookmark, it just plays the radio. </h3>

You need to apply the documented [patch](wiki/radiotray) to make that feature work. Also check the radiotray plugin options. It's perhaps just set "play". Or if it tries to "map" your radio genres, then perhaps the association is out of sync / you don't have the preconfigured categories anymore. Then set the according option to just "root" bookmarking.
    You need to apply the documented [patch](wiki/radiotray) to make that feature work. Also check the radiotray plugin options. It's perhaps just set "play". Or if it tries to "map" your radio genres, then perhaps the association is out of sync / you don't have the preconfigured categories anymore. Then set the according option to just "root" bookmarking.


### Search function finds nothing.
 8. <h3> Search function finds nothing. </h3>

The "cache" search will only uncover stations/songs, if you have browsed the according genres and channels recently.
    The "cache" search will only uncover stations/songs, if you have browsed the according genres and channels recently.

The "server" search is not implemented for all channels however. Only the major ones and non-static lists can actually return something.
    The "server" search is not implemented for all channels however. Only the major ones and non-static lists can actually return something.