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

⌈⌋ ⎇ branch:  streamtuner2


Artifact [90ad6016ef]

Artifact 90ad6016ef638bf048ba99302856c5ef31618f1f:

Wiki page [windows] by mario on 2017-01-02 18:41:39.
D 2017-01-02T18:41:39.593
L windows
N text/x-markdown
P e896f47fc0d97fdb4efb8dc025b77a0ed6e5e39c
U mario
W 5060
Streamtuner2 also runs on Windows XP and above. <img src="raw/fe3e57c8ddf61ece40db7ccca9815956abf1de12?m=image/png" width=25% height=25% align=right>
Since version 2.2.0 it is an officially supported platform.

Streamtuner2 requires a working Python installation first. That includes:

  * Python with Gtk bindings,
  * the requests, pyquery, Python PIL and LXML packages.

For manual Python installation see below. 

### EXE/SFX installer <img src="raw/3890706faa120d8fa8ed57846e87bdb91dfcb300?m=image/png" width=50% height=50% align=right style="margin-left: 15pt">

The available **.exe** installer is a self-extracting ZIP. It'll unpack to Unix-style paths `/usr/bin/` and `/usr/share/streamtuner2` per default. However, it's relocatable, and can be installed in any base path meanwhile.

After unpacking it runs a neat post-install script for Windows 7 and above since version 2.2.0 which will download and set up all required dependencies (Python 2.7 + Gtk2) as well as the Start Menu. So it's rather convenient to set up now.

You can also install Streamripper and Python Mutagen from the script, if desired (they are not required for running Streamtuner2).
<br>
You still need to configure your audio player (VLC recommended, but WMplayer works) of course.

<br clear=all>
<img src="raw/27cf539e34a03474b07114dff249f8a348b35942??m=image/png" width=50% height=50% align=right style="margin-left: 15pt">
The installer is a Windows Powershell V2.0 script, so most likely it will not 
execute on Windows XP, although Powershell can also be installed on Windows XP. It wasn't tested on this platform however.
You should a consider a manual installation of Python 2.7 on Windows XP therefore. After doing so you can just run the EXE installer for installation of the Streamtuner2 files. No Start Menu entries will be created in this case however. 


### Alternatives

There are other options to run Streamtuner2 on Windows though:

#### 0install

It's rather simple to run Streamtuner2 per **0install** feed:

  * [http://fossil.include-once.org/streamtuner2/doc/trunk/dev/0-st2.xml](http://fossil.include-once.org/streamtuner2/doc/trunk/dev/0-st2.xml)

Ought to work for Windows, MacOS and BSD/Linux systems.


#### PYZ package

While the new **.pyz** package is a very convient way to deplay Streamtuner2. It just needs copying to any folder and can be started with:

        python streamtuner2.pyz

Or rename it to have a **.pyzw** extension, in case your setup already picks that up.

Again, you need a working Python+Gtk setup first.


### Configuration

Basically the configuration resembles the configuration on BSD/Linux. However there are some differences with respect to path names and utility programs which are not fully reflected in the help files. Please see the respective documentation on the other Wiki pages, namely [Player configuration](http://fossil.include-once.org/streamtuner2/wiki?name=player). 


### Python setup

There are probably modern Python distributions for Windows. No idea. It's definitely not something that should be handled on a per-application basis and with PyInstaller embellishments.


#### Manual installation of Python 2.7

[Oliver found](https://sourceforge.net/p/streamtuner2/discussion/1173108/thread/2a060ed4/?limit=25) a dependable recommendation for using Python 2 in [this discussion about PyGtk and PyGObject:]
(http://stackoverflow.com/questions/12981137/gi-repository-windows)

It may be outdated, since it's from the year 2012.

 * So I built my environment for Windows 7 with the following components:
 * Install python-2.7.13.msi from https://www.python.org/ftp/python/2.7.13/
 (should be 32-Bit according to README in http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.24/)
 * Install pygtk-all-in-one-2.24.2.win32-py2.7.msi from http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.24/
 * Install Python requests via <i>easy_install.exe requests</i> from the Python scripts path
 * Install lxml-2.3.win32-py2.7.exe from https://pypi.python.org/pypi/lxml/2.3
 * Install pyquery-1.2.17-py2.py3-none-any.whl from https://pypi.python.org/pypi/pyquery/1.2.17 via <i>pip install [Path]pyquery-1.2.17-py2.py3-none-any.whl</i> 
 * Install PIL-1.1.7.win32-py2.7.exe from http://www.pythonware.com/products/pil/
 * Optionally install Python Mutagen for ID3 support for the local file browser plugin via <i>pip install mutagen</i> from the Python scripts path

This setup has been verified for running Streamtuner2 on Windows XP, Windows 7 and Windows 10.

You should however avoid installing Python 2.7 into the <i>%ProgramFiles(x86)%</i> folder of Windows. It's recommended to use the suggested <i>C:\\Python27</i> folder instead. If you install Python into any Windows <i>ProgramFiles</i> folder you will not be able to apply a custom Gtk2 theme from within Streamtuner2 due to file system access restrictions.

#### Manual installation of Python 3.4

Python 3.4 and the newer PyGI (Gtk3) might also work meanwhile.

Z 6bd07582d20f73f9604e1554dc62e9da