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

โŒˆโŒ‹ โŽ‡ branch:  streamtuner2


Diff

Differences From Artifact [1512d74c86]:

To Artifact [3311a1cdd3]:


1
2
3
4
5
6
7
8
9
10
11

12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27








28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43


44
45
46
47
48
49
50
51
52
53
54
55
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

81
82
83
84
85
86
87
88
89
90
91
92

This is a short summary for distribution package maintainers.
For regular end-user documentation see the help/ pages.


Structural changes in 2.1.5 (2015-04-xx)
----------------------------------------

 โ†’ There's a new `bin` script. It's a lightweight invocation
   wrapper, intended to be installed as /usr/bin/streamtuner2
   now.


 โ†’ The previous `st2.py` still exists, but is now supposed to
   reside in `/usr/share/streamtuner2/st2.py` along with all
   other modules.

 โ†’ Theoretically it's now possible to change the target path
   even (just edit `bin`).

I'd still advise to use /usr/share/streamtuner2/ as main target
directory though. It's not yet practical to extract into Python
site-package directories.

The channel PNG files still need to reside alongside the Python
modules. Later versions may complete soak the images into the
source code (meta data section) for simpicity.










Aux files
---------

 โ†’ Help files still need to go to share/docs/streamtuner2/help/
   unless you patch the source.

 โ†’ *.desktop as usual

 โ†’ and `logo.png` is the pixmap/app icon


Removed
-------

Some plugin PNGs may have been removed already.



And the streamtuner2.png logo is now source-embedded instead
(`logo.py` provides a `logo.png`).

The old `gtk2.xml` file is gone. It probably became obsolete
a long while back. The gtk3.xml is instead runtime-patched
to work with PyGTK/gtk2.


Dependencies
------------

If possible, make ST2 dependend on Python2 -or- Python3.
It's not yet practical, and probably against distro standards,
and only APT could so anyway. But if feasible...

Also, hard dependencies are meanwhile:

  - gtk (>= 2.16)
  - pygtk || python-gi
  - python-requests (>> 1.2.0)
  - python-pyquery     [though most plugins would work without]
  - and its implied python-lxml

Optional dependencies (just affects a single plugin, which
semi-gracefully disables itself):

  - python-keybinder   [for global_key]
  - python-dbus        [for radiotray]

Very optional dependencies (everything should work without):

  - python-xdg

Strongly suggest:

  - Streamripper


Suggest:

  - any audio player of course
  - youtube-dl


Lazy installation
-----------------

The new .PYZ archive bundles everything into a ZIP file. Which,
given the right shebang, could just be "installed" as literal











>













|


>
>
>
>
>
>
>
>















|
>
>

|
|
















|

|














|
>



<
|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

96
97
98
99
100
101
102
103

This is a short summary for distribution package maintainers.
For regular end-user documentation see the help/ pages.


Structural changes in 2.1.5 (2015-04-xx)
----------------------------------------

 โ†’ There's a new `bin` script. It's a lightweight invocation
   wrapper, intended to be installed as /usr/bin/streamtuner2
   now.
   Which hopefully avoids lengthy patches in the future.

 โ†’ The previous `st2.py` still exists, but is now supposed to
   reside in `/usr/share/streamtuner2/st2.py` along with all
   other modules.

 โ†’ Theoretically it's now possible to change the target path
   even (just edit `bin`).

I'd still advise to use /usr/share/streamtuner2/ as main target
directory though. It's not yet practical to extract into Python
site-package directories.

The channel PNG files still need to reside alongside the Python
modules. Later versions may completely soak the images into the
source code (meta data section) for simpicity.


Renames
-------

 ยท bookmarks, configdialog, streamedit were extracted into
   channels/ - which is why the main module got lighter.
 ยท uikit.py is the new mygtk
 

Aux files
---------

 โ†’ Help files still need to go to share/docs/streamtuner2/help/
   unless you patch the source.

 โ†’ *.desktop as usual

 โ†’ and `logo.png` is the pixmap/app icon


Removed
-------

Some plugin PNGs may have been removed already. (Embedded
binary data may violate some distro guidelines(?), but hey,
fewer files are fewer files.)

And the streamtuner2.png logo is now source-embedded instead,
the`logo.py` module provides a `logo.png` string.

The old `gtk2.xml` file is gone. It probably became obsolete
a long while back. The gtk3.xml is instead runtime-patched
to work with PyGTK/gtk2.


Dependencies
------------

If possible, make ST2 dependend on Python2 -or- Python3.
It's not yet practical, and probably against distro standards,
and only APT could so anyway. But if feasible...

Also, hard dependencies are meanwhile:

  - gtk (>= 2.16)
  - pygtk                           [or python-gi for python3]
  - python-requests (>> 1.2.0)
  - python-pyquery    [though most plugins would work without]
  - and its implied python-lxml

Optional dependencies (just affects a single plugin, which
semi-gracefully disables itself):

  - python-keybinder   [for global_key]
  - python-dbus        [for radiotray]

Very optional dependencies (everything should work without):

  - python-xdg

Strongly suggest:

  - streamripper       [or ficy/fpls etc.]
  - any audio player of course

Suggest:


  - youtube-dl   [technically not required, as VLC works without]


Lazy installation
-----------------

The new .PYZ archive bundles everything into a ZIP file. Which,
given the right shebang, could just be "installed" as literal