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

⌈⌋ branch:  streamtuner2


Check-in [b6b64a45f6]

Overview
Comment:Fix manual Makefile `install` rules. Update -D debug notes in README. Release as 2.1.5 (beta).
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk | 2.1.5
Files: files | file ages | folders
SHA1: b6b64a45f6abc90383a2f4d64ffbfa9bc2fb4657
User & Date: mario on 2015-04-05 22:06:07
Other Links: manifest | tags
Context
2015-04-06
18:53
Add UserAgentSwitcher plugin. (Just for experimenting really, not required.) check-in: e8c162f72a user: mario tags: trunk
2015-04-05
22:06
Fix manual Makefile `install` rules. Update -D debug notes in README. Release as 2.1.5 (beta). check-in: b6b64a45f6 user: mario tags: trunk, 2.1.5
22:04
Provide a `-D` debugging flag and a `-d shoutcast` option to disable plugins prior startup. check-in: 08b1306823 user: mario tags: trunk
Changes

Modified Makefile from [cf2c20dc2e] to [0d018ef979].

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 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
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








|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 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 -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
56
57
58
59
60
61
62


63
64

65


66
67
68
69

70
71
72
73
74
75
76
77
check:
	dpkg-deb -c streamtuner2*deb
	dpkg-deb -I streamtuner2*deb
	rpm -qpil *rpm

# manual installation
install:


	$(INST)		bin		/usr/bin/streamtuner2
	$(INST)		*.py		-d -t $(DEST)

	$(INST)		channels/	-d -t $(DEST)


	$(INST)		CREDITS		-d -t $(DEST)
	$(INST)		gtk3.*		-d -t $(DEST)
	$(INST)		help/		-d -t /usr/share/doc/streamtuner2/
	$(INST)		*.desktop	-t /usr/share/applications/

	$(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







>
>
|
|
>
|
>
>
|
<
|

>

<
<





56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

72
73
74
75


76
77
78
79
80
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
	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)		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/



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

Modified NEWS from [f894a320f4] to [8c10c52fe2].

1
2
3
4
5
6
7
8
2.1.5 (unreleased)
- 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.
|







1
2
3
4
5
6
7
8
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.

Modified README from [170fdd7788] to [fe1c20a84a].

89
90
91
92
93
94
95

























96
97
98
99
100
101
102
  · 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.



























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.








>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>







89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
  · 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.

Modified releases.json from [0241eb2385] to [d17156b65c].

10
11
12
13
14
15
16








17
18
19
20
21
22
23
        "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.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"







>
>
>
>
>
>
>
>







10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
        "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"