# Requires 
# · http://fossil.include-once.org/versionnum/
# · http://fossil.include-once.org/xpm/

SHELL   := /bin/bash #(for brace expansion)
NAME    := streamtuner2
VERSION := $(shell version get:plugin st2.py || echo 2.1dev)
DEST    := /usr/share/streamtuner2
INST    := install -v
INST    := install -m 644
PACK    := xpm
DEPS    := -n $(NAME) -d python-pyquery -d python-gtk2 -d python-requests -d python-keybinder
OPTS    := -s src -u man,fixperms -f --prefix=$(DEST) --deb-compression xz --rpm-compression xz --exe-autoextract
.PHONY:  bin
all:  gtk3 #(most used)
pack: all ver docs xpm src
gtk3: gtk3.xml.gz

check:
	dpkg-deb -c streamtuner2*deb
	dpkg-deb -I streamtuner2*deb
	rpm -qpil *rpm

# manual installation
install:
	mkdir	-p				$(DEST)/channels
	mkdir	-p				/usr/share/doc/streamtuner2/help/img
	$(INST)		bin		/usr/bin/streamtuner2
	$(INST)		*.py		-d -t $(DEST)
	$(INST)		channels/	-d -t $(DEST)
	$(INST)		CREDITS		-d -t $(DEST)
	install -m 755		bin		/usr/bin/streamtuner2
	$(INST)		*py		-t $(DEST)
	$(INST)		gtk3*		-t $(DEST)
	$(INST)		channels/*py	-t $(DEST)/channels
	$(INST)		help/*page	-t /usr/share/doc/streamtuner2/help
	$(INST)		help/img/*	-t /usr/share/doc/streamtuner2/help/img
	$(INST)		CREDITS		-t $(DEST)
	$(INST)		gtk3.*		-d -t $(DEST)
	$(INST)		help/		-d -t /usr/share/doc/streamtuner2/
	$(INST)		README		-t /usr/share/doc/streamtuner2
	$(INST)		*.desktop	-t /usr/share/applications/
	$(INST)		icon.png	/usr/share/pixmaps/streamtuner2.png
	$(INST)		help/str*2.1	-t /usr/share/man/man1/
	$(INST)		icon.png	-t /usr/share/pixmaps/streamtuner2.png
	$(INST)		README		-d -t /usr/share/doc/streamtuner2/

# start locally
st2: run
run:
	./st2.py

2.1.5 (unreleased)
2.1.5 (2015-04-05)
- This is a beta release, with lots of cleanups and various bugfixes.
- Adds a self-contained PYZ package, which Python can run directly.
- Now fully utilizes the plugin meta data scheme for default settings,
  discovery, and to reduce internal complexity.
- A new channel plugin for "Radio-Browser.info" has been bundled.
- Another plugin for interfacing with "RadioTray" was introduced, to
  share bookmarks via DBUS once RadioTray implements it.

  · If you want to use another target, just edit the "bin" wrapper.
  · Optionally copy the help/ folder to /usr/share/docs/streamtuner2/
  · And the logo.png into the system pixmaps/,
    as well as the *.desktop file into /usr/share/applications/

That's pretty much what the binary packages extract to.


Startup errors
--------------

If streamtuner2 hangs at startup, you can manually enable the
debugging mode for more information.

Open a terminal window to start it. And use the `-D` flag to
enable extra output:

   streamtuner2 -D

Take note of any red error messages.

If it's just one channel plugin that hangs at startup, you
can alternatively disable it once:

   streamtuner2 -d xiph

Use [save] in the settings dialog (via F12) if you wish to
permanently disable it.

You can also manually edit the configuration file, located
in ~/.config/streamtuner2/settings.json


Hacking
-------

If you want to edit a channel plugin, just have a look into the
channels/*.py files. It's often rather easy to adapt things.

        "fossil": "http://fossil.include-once.org/streamtuner2/",
        "homepage": "http://milki.include-once.org/streamtuner2/",
        "src": "http://milki.include-once.org/streamtuner2/streamtuner2-$version.src.txz",
        "deb": "http://milki.include-once.org/streamtuner2/streamtuner2-$version.deb",
        "rpm": "http://milki.include-once.org/streamtuner2/streamtuner2-$version.rpm"
    },
    "releases": [
        {
            "version": "2.1.5",
            "state": "beta",
            "scope": "major cleanup",
            "changes": "This is a beta release, with lots of cleanups and various bugfixes. Adds a self-contained PYZ package, which Python can run directly. Now fully utilizes the plugin meta data scheme for default settings, discovery, and to reduce internal complexity. A new channel plugin for Radio-Browser.info has been bundled. Another plugin for interfacing with RadioTray was introduced, to share bookmarks via DBUS once RadioTray implements it. Notebook tabs are now on the left per default, and can be rearranged directly in the GUI. The configuration dialog now indicates the availability of selected audio players. Default audio players are now automatically configured during the first startup. Gtk properties are now utilized more over internal UI state vars. The the GtkBuilder UI file is now compressed, the Gtk2 fallback removed. The former channel icon PNGs are now embedded. Theme configuration was removed. Category retrieval became more resilient. HTTP timeouts have been added. The bookmarks tab, settings window, search dialog, stream inspector/editor have been externalized into plugins; yet remain core features. The packaging layout has been slightly restructured - to support relocatable installations (for PyZIP package). Minor fixes to youtube, internet_radio, punkcast, timer and other plugins. Help pages have been updated further, as well as CREDITS, README and general PACKAGING infos, and most plugin short descriptions. The project wiki now contains a more details on plugin APIs.",
            "download": "http://sourceforge.net/projects/streamtuner2/files/",
            "published": "2015-04-05T22:30:00+0000"
        },
        {
            "version": "2.1.4",
            "state": "stable",
            "scope": "minor feature",
            "changes": "Fixed Internet-Radio extraction. Added basic TuneIn channel. Removed Dirble and MusicGoal channels. Fix desktop and packaging infos according to Debian guidelines. Switch to fpm/xml for package building. Remove bundled requests library. Update icon and fix path to application logo. Minor documentation updates.",
            "download": "http://sourceforge.net/projects/streamtuner2/files/",
            "published": "2015-03-25T00:30:00+0000"