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

⌈⌋ ⎇ branch:  streamtuner2


Artifact [b16ffda724]

Artifact b16ffda7240dff197e192ac84321013534a76ace:

Wiki page [windows] by Oliver on 2017-01-01 20:09:26.
D 2017-01-01T20:09:26.475
L windows
N text/x-markdown
P fc00d895e9236783e6b8f8272cb93d096e255982
U Oliver
W 4819
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. 

### Installation

#### 0install

Simplest option to run Streamtuner2 is 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

With the new **.pyz** package it's even easier to use Streamtuner2 however. So that's now the recommended approach. Simply copy it to any folder and start it 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.)


#### Exe "installer" <img src="raw/3890706faa120d8fa8ed57846e87bdb91dfcb300?m=image/png" width=50% height=50% align=right>



The available **.exe** installer is a self-extracting ZIP. It'll unpack to Unix-style paths `/usr/bin/` and `/usr/share/streamtuner2`. It can be installed in any root path meanwhile.
<br><br><br>
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>
<img src="raw/27cf539e34a03474b07114dff249f8a348b35942??m=image/png" width=50% height=50% align=right>
<br>
You still need to configure your audio player (VLC recommended, but WMplayer works) of course.

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. 


### 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. 


### 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 90afb2985d2b6651d16a86e6577bb8e9