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

⌈⌋ branch:  streamtuner2


Changes To FAQ

Changes to "FAQ" between 2015-05-21 20:24:58 and 2015-05-21 20:52:06

     1      1   That's not an actual FAQ. More a list of questions that came up once.
     2      2   
     3      3   
     4      4    1. <h3> Streamtuner2 doesn't start. </h3>
     5      5   
     6      6       Check the list of [dependencies](index#~Dependencies) first.
     7      7   
     8         -    Start it from a terminal instead to get more useful information. Alternatively enable the debug mode even:
            8  +    Start it from a terminal instead to get more useful information. Alternatively enable the [debug mode](wiki/debugging) even:
     9      9   
    10     10           streamtuner2 -D
    11     11   
    12     12       That'll reveal a bit more searchable error causes. (Don't google for Gtk warnings though. They're seldomly relevant. And nobody cares.)
    13     13   
    14     14    2. <h3> Channel lists keep empty. </h3>
    15     15   
    16         -    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.
           16  +    Again try to [debug](wiki/debugging) 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.
    17     17   
    18     18         * 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.
    19     19   
    20     20         * Alternatively try the <kbd>☒ PyQuery parsing</kbd> configuration setting.
    21     21   
    22     22         * Check that you haven't set the <kbd>☒ Filter bitrate</kbd> plugin to some excessively high value. If you expect to find only 192kbit/s radio stations in *all* channels, you're going to be disappointed. ;}
    23     23   
................................................................................
    32     32    4. <h3> Category lists empty, or no stations are found. </h3>
    33     33   
    34     34       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.
    35     35   
    36     36   
    37     37    5. <h3> Player doesn't start. </h3>
    38     38   
    39         -    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`
           39  +    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`](wiki/debugging)
    40     40   
    41     41   
    42     42    5. <h3> Stream recording doesn't work. </h3>
    43     43   
    44     44       This is usually a misconfiguration.
    45     45   
    46     46        1. **No window appears.**
................................................................................
    81     81   
    82     82       The "server" search is not implemented for all channels however. Only the major ones and non-static lists can actually return something.
    83     83   
    84     84    9. <h3> Crashes while switching tabs </h3>
    85     85   
    86     86       That's probably a known problem. It's just difficult to reproduce and fix still. The main issue is concurrent threads clashing with the Gtk user interface handling.
    87     87   
    88         -    If you can reproduce it (using the -D debug mode), then please send in a bug report. Otherwise, and if this happens more than once, just enable the "no-threading" mode in the settings dialog.
           88  +    If you can reproduce it (using the [<kbd>-D</kbd> debug mode](wiki/debugging)), then please send in a bug report. Otherwise, and if this happens more than once, just enable the "no-threading" mode in the settings dialog.
    89     89   
    90     90    10. <h3>Channel errors about undefined conf.* variables</h3>
    91     91   
    92         -    When upgrading from a previous ST2 version, you might encounter some plugins failing with initialization errors. If so, run streamtuner2 once with `-D` flag to have new config options applied. (Not actually seen this happening, but could be...)
           92  +    When upgrading from a previous ST2 version, you might encounter some plugins failing with initialization errors. If so, run streamtuner2 once with [<kbd>-D</kbd>](wiki/debugging) flag to have new config options applied. (Not actually seen this happening, but could be...)
    93     93   
    94     94   
    95     95   
    96     96