You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<h2id="requirements">Requirements <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></style></h2>
<h2id="changelog">Changelog <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></style></h2>
144
145
<prestyle="height: 200px;">
145
146
146
-
2022-03-10 s-n-g
147
+
2022-03-15 s-n-g
148
+
* version 0.8.9.15 (0.9-beta12)
149
+
* fixing "0" and "$" insertion on RadioBrowser search window
150
+
* macOS installation method updated to pip
151
+
* fixing a macOS RadioBrowser interface breakage
147
152
* Windows installation method updated to pip
148
153
* adding F7, F8, F9, F10 functionality for Windows
<h2id="table-of-contents">Table of Contents <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></style></h2>
42
42
<!-- vim-markdown-toc Marked -->
43
43
<ul>
44
+
<li><ahref="#current-state-of-the-project">Current state of the project</a>
45
+
<ul>
46
+
<li><ahref="#what-does-it-all-mean-and-why-should-you-care">What does it all mean and why should you care</a></li>
47
+
</ul></li>
44
48
<li><ahref="#preparing-for-the-installation">Preparing for the installation</a>
45
49
<ul>
50
+
<li><ahref="#linux">Linux</a>
51
+
<ul>
46
52
<li><ahref="#notice-for-python-2-users">Notice for Python 2 users</a></li>
47
-
<li><ahref="#linux">Linux</a></li>
53
+
</ul></li>
48
54
<li><ahref="#macos">macOS</a></li>
49
55
<li><ahref="#windows">Windows</a></li>
50
56
</ul></li>
51
-
<li><ahref="#performing-the-installation">Performing the installation</a>
57
+
<li><ahref="#performing-the-installation">Performing the installation</a> * <ahref="#note-for-macos-users">Note for macOS users</a>
52
58
<ul>
53
59
<li><ahref="#updating-a-pre-0.8.9-installation">Updating a pre 0.8.9 installation</a></li>
54
60
</ul></li>
55
61
</ul>
56
62
<!-- vim-markdown-toc -->
57
63
<p><ahref="README.html">[Return to main doc]</a></p>
64
+
<h2id="current-state-of-the-project">Current state of the project <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></style></h2>
65
+
<p>Starting with version <strong>0.8.9.15</strong>, <strong>PyRadio</strong> has changed its installation method from invoking <em>setup.py</em> directly to <em>pip</em> (i.e. from “<em>python setup.py install</em>” to “<em>python -m pip .</em>”). This is a must for all <strong>Python</strong> projects in order to keep up with the latest developments. For more info, please refer to “<atarget="_blank" href="https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html">Why you shouldn’t invoke setup.py directly</a>”.</p>
66
+
<h3id="what-does-it-all-mean-and-why-should-you-care">What does it all mean and why should you care</h3>
67
+
<p>Moving to the <strong>pip</strong> way of doing things has its implications:</p>
68
+
<oltype="1">
69
+
<li><strong>PyRadio</strong> will be installed as a pip package.</p></li>
70
+
<li><strong>PyRadio</strong> will no longer be installed as a system-wide package.<br/>
71
+
<br/>
72
+
This means that after installing <strong>PyRadio</strong>, it will only be available to the current user. If another user wants to use it as well, he would have to install it again.<br/>
73
+
<br/>
74
+
In other words, in order to have a <strong>Pyradio system-wide installation</strong>, your distribution has to provide a package for it.</p></li>
75
+
<li>As I’m starting the procedure to move away from <em>Python 2</em>, <strong>PyRadio</strong> will not be compatible with it on <em>macOs</em> and <em>Windows</em> (but will still be on <em>Linux</em>, at least for the time being).</p></li>
76
+
</ol>
58
77
<h2id="preparing-for-the-installation">Preparing for the installation <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></style></h2>
59
78
<p>Before installing <strong>PyRadio</strong> you have to prepare your system, so that you end up with a working installation. The process depends on the OS you are on.</p>
60
-
<h3id="notice-for-python-2-users">Notice for Python 2 users</h3>
61
-
<p>If you are still using <strong>Python 2</strong>, plase make sure “<strong>pip</strong>” is installed. Execute the following command to verify its existance:</p>
62
-
<pre>python[2] -m pip list</pre>
63
-
<p>If you get a response, you are good to go. Otherwise, use your distro package manager to install it.</p>
64
-
<p>If your distro does not provide it (some do not anymore), use the following commands to get it:</p>
<li>any one of <em>MPV</em>, <em>MPlayer</em> and/or <em>VLC</em>.</li>
76
88
</ol>
89
+
<h4id="notice-for-python-2-users">Notice for Python 2 users</h4>
90
+
<p>If you are still using <strong>Python 2</strong>, plase make sure “<strong>pip</strong>” is installed. Execute the following command to verify its existance:</p>
91
+
<pre>python[2] -m pip list</pre>
92
+
<p>If you get a response, you are good to go. Otherwise, use your distro package manager to install it.</p>
93
+
<p>If your distro does not provide it (some do not anymore), use the following commands to get it:</p>
<p>Everything else you need to install and run <strong>pyradio</strong> is available on <atarget="_blank" href="https://github.com/Homebrew/homebrew">Homebrew</a>. If you haven’t already downloaded its client, go ahead and do it.</p>
<p>Depending on your Mac OS version, you may have to install <strong>sed</strong> too:</p>
103
+
<p>Depending on your macOS version, you may have to install <strong>sed</strong> too:</p>
85
104
<pre>brew install gnu-sed --default-names</pre>
86
105
<p>Now it’s time to install a media player. You are free to install any one of them or even more than one…</p>
87
106
<p>1. <strong><em>MPV</em></strong></p>
@@ -114,6 +133,12 @@ <h2 id="performing-the-installation">Performing the installation <span style="pa
114
133
<pre>python3 install.py</pre>
115
134
<p>If for some reason you want a <strong>python 2</strong> installation, execute:</p>
116
135
<pre>python2 install.py</pre>
136
+
<h4id="note-for-macos-users">Note for macOS users</h4>
137
+
<p>This release of <strong>PyRadio</strong> has been tested on <strong>Catalina</strong> and <strong>Big Sur</strong>.</p>
138
+
<p>On <strong>Catalina</strong> the executable has been placed on a location which is not directly accessible (not in the PATH). <strong>PyRadio</strong> will try to link it to your <strong>bin</strong> folder (creating <em>~/bin/pyradio</em>), and <strong>PyRadio</strong> will be ready yo be executed, provided that this folder is in your PATH and that <strong>Homebrew</strong> default installation folders have been used during the installation of <strong>Python 3</strong>.</p>
139
+
<p>In case a different <strong>Homebrew</strong> location has been used (or a different package manager, for this matter), you can just point the installation to the correct path, using the following command (post installation):</p>
<p>so that <strong>PyRadio</strong> can find and link the executable to your <strong>bin</strong> folder.</p>
117
142
<h3id="updating-a-pre-0.8.9-installation">Updating a pre 0.8.9 installation</h3>
118
143
<p>If you are on a pre 0.8.9 release and want to update <strong>PyRadio</strong>, just follow the instructions above, but add the “<em>–force</em>” command line parameter to the installation command.</p>
Copy file name to clipboardExpand all lines: build.md
+46-11Lines changed: 46 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -7,35 +7,44 @@ Ben Dowling - [https://github.com/coderholic](https://github.com/coderholic)
7
7
## Table of Contents
8
8
<!-- vim-markdown-toc Marked -->
9
9
10
+
*[Current state of the project](#current-state-of-the-project)
11
+
*[What does it all mean and why should you care](#what-does-it-all-mean-and-why-should-you-care)
10
12
*[Preparing for the installation](#preparing-for-the-installation)
11
-
*[Notice for Python 2 users](#notice-for-python-2-users)
12
13
*[Linux](#linux)
14
+
* [Notice for Python 2 users](#notice-for-python-2-users)
13
15
*[macOS](#macos)
14
16
*[Windows](#windows)
15
17
*[Performing the installation](#performing-the-installation)
18
+
* [Note for macOS users](#note-for-macos-users)
16
19
*[Updating a pre 0.8.9 installation](#updating-a-pre-0.8.9-installation)
17
20
18
21
<!-- vim-markdown-toc -->
19
22
20
23
[[Return to main doc]](README.md)
21
24
25
+
## Current state of the project
22
26
23
-
## Preparing for the installation
27
+
Starting with version **0.8.9.15**, **PyRadio** has changed its installation method from invoking *setup.py* directly to *pip* (i.e. from "*python setup.py install*" to "*python -m pip .*"). This is a must for all **Python** projects in order to keep up with the latest developments. For more info, please refer to "[Why you shouldn't invoke setup.py directly](https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html)".
24
28
25
-
Before installing **PyRadio** you have to prepare your system, so that you end up with a working installation. The process depends on the OS you are on.
29
+
### What does it all mean and why should you care
26
30
27
-
### Notice for Python 2 users
31
+
Moving to the **pip** way of doing things has its implications:
28
32
29
-
If you are still using **Python 2**, plase make sure "**pip**" is installed. Execute the following command to verify its existance:
33
+
1.**PyRadio** will be installed as a pip package.
30
34
31
-
python[2] -m pip list
35
+
2.**PyRadio** will no longer be installed as a system-wide package. \
36
+
\
37
+
This means that after installing **PyRadio**, it will only be available to the current user. If another user wants to use it as well, he would have to install it again. \
38
+
\
39
+
In other words, in order to have a **Pyradio system-wide installation**, your distribution has to provide a package for it.
32
40
33
-
If you get a response, you are good to go. Otherwise, use your distro package manager to install it.
41
+
3. As I'm starting the procedure to move away from *Python 2*, **PyRadio** will not be compatible with it on *macOs* and *Windows* (but will still be on *Linux*, at least for the time being).
34
42
35
-
If your distro does not provide it (some do not anymore), use the following commands to get it:
Before installing **PyRadio** you have to prepare your system, so that you end up with a working installation. The process depends on the OS you are on.
47
+
39
48
40
49
### Linux
41
50
@@ -48,6 +57,19 @@ Use your distribution method to install
48
57
5.*sed*
49
58
6. any one of *MPV*, *MPlayer* and/or *VLC*.
50
59
60
+
#### Notice for Python 2 users
61
+
62
+
If you are still using **Python 2**, plase make sure "**pip**" is installed. Execute the following command to verify its existance:
63
+
64
+
python[2] -m pip list
65
+
66
+
If you get a response, you are good to go. Otherwise, use your distro package manager to install it.
67
+
68
+
If your distro does not provide it (some do not anymore), use the following commands to get it:
Depending on your Mac OS version, you may have to install **sed** too:
88
+
Depending on your macOS version, you may have to install **sed** too:
67
89
68
90
brew install gnu-sed --default-names
69
91
@@ -126,6 +148,19 @@ If for some reason you want a **python 2** installation, execute:
126
148
127
149
python2 install.py
128
150
151
+
152
+
#### Note for macOS users
153
+
154
+
This release of **PyRadio** has been tested on **Catalina** and **Big Sur**.
155
+
156
+
On **Catalina** the executable has been placed on a location which is not directly accessible (not in the PATH). **PyRadio** will try to link it to your **bin** folder (creating *~/bin/pyradio*), and **PyRadio** will be ready yo be executed, provided that this folder is in your PATH and that **Homebrew** default installation folders have been used during the installation of **Python 3**.
157
+
158
+
In case a different **Homebrew** location has been used (or a different package manager, for this matter), you can just point the installation to the correct path, using the following command (post installation):
so that **PyRadio** can find and link the executable to your **bin** folder.
163
+
129
164
### Updating a pre 0.8.9 installation
130
165
131
166
If you are on a pre 0.8.9 release and want to update **PyRadio**, just follow the instructions above, but add the "*--force*" command line parameter to the installation command.
0 commit comments