Index: help/config_apps.page ================================================================== --- help/config_apps.page +++ help/config_apps.page @@ -136,29 +136,25 @@

-
+
Windows config -

There's a few gothchas when running streamtuner2 on -Windows.

 - -

You will often have to quote command paths (e.g. to - "C:/Program Files/Mozilla Firefox/firefox.exe" or - vlc.exe) in double quotes. In particular if those paths - contain spaces.

 - -

If you're using streamripper.exe it's best to put it into a directory - without spaces. For some reason quoting the full exe path will not pass on - parameters.

 - -

If you want to be extra safe, just extend your system %PATH variable - to include all relevant directories. Then just specify the basenames, like - firefox.exe for browsing, or vlc.exe as - player.

 - +

There's a few things you have to take care of when configuring players +and recording apps on Windows. Common applications and settings would be:

+ + + + + + + + +

Player config

audio/mpeg

wmplayer.exe %asx

Windows media player doesn't understand PLS or M3U files.

video/*

C:\Programs\VLC\vlc.exe %srv

VLC pretty much works alike on Windows.

url/http

"C:/Program Files/Mozilla Firefox/firefox.exe" %url

It's best to enclose paths with spaces in quotes.

url/http

iexplore.exe %url

IE is not recommended, of course.

Recording apps

audio/*

/D "C:\Programs\Streamripper" streamripper.exe %srv

Command line programs need the /D switch first, then its path enclosed in quotes and a space before the program.

+

You can avoid a few issues: if you put your executables in paths without +spaces, or set the system $PATH variable accordingly.

As reported by Oliver in the sourceforge Discussion board.
Index: help/configuration.page ================================================================== --- help/configuration.page +++ help/configuration.page @@ -105,22 +105,22 @@ Display/GUI options Display settings - Show bookmark star + ☑ Show bookmark star

Bookmarked stations will be marked with a ★ star in all other station lists / categories. That doesn't often work for the same station entry from two different channel services / tabs though.

 - Save window states + ☑ Save window states

Automatically remember window size, selected channel tab, categories, or selected station. Also keeps the width of station list columns. If disabled, you can manually save the current layout/selections via Edit Save States.

 - Update window title + ☑ Update window title

When switching channel tabs, the Streamtuner2 window title usually gets the current channel name appended (such as "- Shoutcast" or "- Xiph"). You can disable this if it looks confusing. (Requires a restart to fully take effect.)

 <link type="guide" xref="favicon">→ Favicon plugin options</link> @@ -127,58 +127,58 @@ Station loading - Prefer HTML traversing (PyQuery) over regex + ☑ Prefer HTML traversing (PyQuery) over regex

Some channels provide proper APIs to fetch station lists. Others are just websites that require scraping listings out. Most channel tabs provide two alternative methods for that. The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2 plugins often use a regex to match text. Occassionally the regex method is surprisingly more exact, because directory services often use frightful unstructured HTML. If available, both methods are tried. You can influence the order with this setting, and thus speed it up.

 - [<input>500</input>] Limit stream number + 🔟 Limit stream number

Constraints the length of station lists per category. The number of stations option is not honored by all channel plugins. Often it's not possible to load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even. For the major plugins this however limits how many scrollable entries appear in the stream lists.

 - Retain deleted stations

When enabled, keeps old station entries when + ☑ Retain deleted stations

When enabled, keeps old station entries when updating/reloading a category/genre. Services often forget stations or throws them out when inavailable. With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often at the end of the list).

 - Update favouries from freshened URLs + ☑ Update favouries from freshened URLs

Streaming URLs in bookmarked stations get renewed on category reloads/updates. This isn't very reliable, as often station titles change together with the streaming URLs.

 - Save station lists after updates + ☑ Save station lists after updates

After reloading (F5) the updated station lists are autoamtically saved. For favicon updates or drag and drop events this only happens automatically when this option is set.

 Playlist - Reuse .m3u/.pls files

When converting online station playlists, + ☑ Reuse .m3u/.pls files

When converting online station playlists, streamtuner2 creates temporary files like shoutcast.11539398391891.m3u for your audio player. It'll keep those files around in /tmp/streamtuner2 until you quit. That speeds up switching between and reconnecting to a previous station. It's in particular necessary when you use ⏭ or ⏪ directly in your player. For %pls references your player typically usues the online-only playlist files anyway. If you disable this option, then converted pls/m3u/xspf files get recreated repeatedly.

 - Forgo any playlist conversion + ☑ Forgo any playlist conversion

Per default most server playlists (be they .pls or .m3u, .xpsf) are converted. All player/recording apps receive a default %pls file normally. Set this option to disable any such placeholders from the Player tab, and avoid streamtuner2 pre-downloading any m3u/pls/xspf. Instead your audio player gets passed the literal server/playlist streaming URL then.

Note that this is only @@ -192,32 +192,32 @@ System - Temporary files

Streamtuner2 creates temporary .m3u files - for audio + 🔠 Temporary files

Streamtuner2 creates temporary .m3u files - for audio players that are configured to use %m3u files instead of %pls or %srv URLs. For archival purposes you might want to set a dedicated directory for this. In recent versions streamtuner2 will create a /tmp/streamtuner2 directory for itself. (You cannot set just `/tmp` anymore, because that will be mapped to the longer name. You can trick the old behaviour with `/tmp/.` however. Don't do that unless you have a reason).

 - Config directory + 🔠 Config directory

Is where streamtuner2 keeps its settings.json and channel caches, favicons, etc. You can't set this in the config dialog. This is just for display. Set the XDG_CONFIG_HOME environment variable to adapt.

 - Enable debug messages + ☑ Enable debug messages

If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state and processing or debug infos. Enable this only for testing, as it might slow down station rendering.

 - Disable threading

Now "threading" is a somewhat technical term. It + ☑ Disable threading

Now "threading" is a somewhat technical term. It means that an application runs different tasks internally at the same time. It's used for snappier interfaces. However, it's also difficult to get right at times. In Streamtuner2 some concurrent tasks conflict with updating the Gtk3 user interface. Which is why the application may crash even on reloading station lists or when switching between categories too quickly. This is only an issue for Python3 on Gtk3 with Index: help/html/config_apps.html ================================================================== --- help/html/config_apps.html +++ help/html/config_apps.html @@ -226,28 +226,46 @@

-
+

Windows config

-

There's a few gothchas when running streamtuner2 on -Windows.

-
    -

  • You will often have to quote command paths (e.g. to - "C:/Program Files/Mozilla Firefox/firefox.exe" or - vlc.exe) in double quotes. In particular if those paths - contain spaces.

    • -

  • If you're using streamripper.exe it's best to put it into a directory - without spaces. For some reason quoting the full exe path will not pass on - parameters.

    • -

  • If you want to be extra safe, just extend your system %PATH variable - to include all relevant directories. Then just specify the basenames, like - firefox.exe for browsing, or vlc.exe as - player.

    • -
+

There's a few things you have to take care of when configuring players +and recording apps on Windows. Common applications and settings would be:

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +

Player config

audio/mpeg

wmplayer.exe %asx

Windows media player doesn't understand PLS or M3U files.

video/*

C:\Programs\VLC\vlc.exe %srv

VLC pretty much works alike on Windows.

url/http

"C:/Program Files/Mozilla Firefox/firefox.exe" %url

It's best to enclose paths with spaces in quotes.

url/http

iexplore.exe %url

IE is not recommended, of course.

Recording apps

audio/*

/D "C:\Programs\Streamripper" streamripper.exe %srv

Command line programs need the /D switch first, then its path enclosed in quotes and a space before the program.

+

You can avoid a few issues: if you put your executables in paths without +spaces, or set the system $PATH variable accordingly.

As reported by Oliver in the sourceforge Discussion board.