Skip to content

Commit 6e2df35

Browse files
committed
- Pressing "t" in the config window will be ignored
- Updating Windows uninstall procedure and relevant docs
1 parent 54d3204 commit 6e2df35

File tree

8 files changed

+170
-68
lines changed

8 files changed

+170
-68
lines changed

README.html

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -369,6 +369,22 @@ <h2 id="update-notification">Update notification <span style="padding-left: 10px
369369
<p><strong>PyRadio</strong> will periodically (once every 10 days) check whether a new version has been released.</p>
370370
<p>If so, a notification message will be displayed, informing the user about it.</p>
371371
<h2 id="cleaning-up">Cleaning up <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></style></h2>
372+
<p>Since version 0.8.7.3 (0.8.8-beta2), it is not necessary to follow the previous procedure any more; <strong>PyRadio</strong> will search and remove any previously installed files when the “<strong>-u</strong>” (uninstall) parameter is used.</p>
373+
<p>This procedure will remove any <strong>Pyradio</strong> files installed in your system, but will leave instact <strong>PyRadio</strong> configuration files.</p>
374+
<p>Windows users notice: This procedure <strong>will not</strong> uninstall python, mplayer, or git from your system.</p>
375+
<p>Example:</p>
376+
<pre>$ devel/build_install_pyradio -u
377+
Uninstalling PyRadio
378+
** Removing executable ... done
379+
** Removing help files ... done
380+
Looking for python installed files
381+
** Removing &quot;pyradio-0.8.8-py3.8.egg&quot; ... done
382+
** Removing &quot;pyradio-0.8.6-py2.7.egg&quot; ... done
383+
** Removing &quot;pyradio-0.8.8-py3.8.egg&quot; ... done
384+
PyRadio successfully uninstalled</pre>
385+
<p>In this example, running <em>devel/build_install_pyradio -u</em> has removed <strong>PyRadio</strong> python 3.8 system wide installation files, <strong>PyRadio</strong> python 2.7 system wide installation files, and <strong>PyRadio</strong> python 3.8 user installation files, found in the system.</p>
386+
<p>I would recommend to execute <em>devel/build_install_pyradio -u</em> from time to time, and reinstall <strong>Pyradio</strong> right after its completion.</p>
387+
<h3 id="previous-cleaning-up-procedure">Previous cleaning up procedure</h3>
372388
<p>As <strong>PyRadio</strong> versions accumulate, when building from source, one may have to <em>clean up</em> old installation files.</p>
373389
<p>To do that, one has to observe the installation process in order to find out where the package is installed. The installation would complete printing the following messages (on <em>python 3.7</em>):</p>
374390
<pre>Installed /usr/lib/python3.7/site-packages/pyradio-0.7.8-py3.7.egg
@@ -384,18 +400,6 @@ <h2 id="cleaning-up">Cleaning up <span style="padding-left: 10px;"><sup style="f
384400
<p>As we see, previous versions still exist in this system: <strong>0.7.6.2</strong> and <strong>0.7.7</strong>. These files (actually directories) can safely be removed:</p>
385401
<pre>$ sudo rm -rf /usr/lib/python3.7/site-packages/pyradio-.7.6.2-py3.7.egg
386402
$ sudo rm -rf /usr/lib/python3.7/site-packages/pyradio-0.7.7-py3.7.egg</pre>
387-
<p style="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> Since version 0.8.7.3 (0.8.8-beta2), it is not necessary to follow the previous procedure any more; <strong>PyRadio</strong> will search and remove any previously installed files when the “<strong>-u</strong>” (uninstall) parameter is used.</p>
388-
<p>Example:</p>
389-
<pre>$ devel/build_install_pyradio -u
390-
Uninstalling PyRadio
391-
** Removing executable ... done
392-
** Removing help files ... done
393-
Looking for python installed files
394-
** Removing &quot;pyradio-0.8.8-py3.8.egg&quot; ... done
395-
** Removing &quot;pyradio-0.8.6-py2.7.egg&quot; ... done
396-
** Removing &quot;pyradio-0.8.8-py3.8.egg&quot; ... done
397-
PyRadio successfully uninstalled</pre>
398-
<p>In this example, running <em>devel/build_install_pyradio -u</em> has removed <strong>PyRadio</strong> python 3.8 system wide installation files, <strong>PyRadio</strong> python 2.7 system wide installation files, and <strong>PyRadio</strong> python 3.8 user installation files, found in the system.</p>
399403
<h2 id="debug-mode">Debug mode <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></style></h2>
400404
<p>Adding the “<strong>-d</strong>” option to the command line will instruct <strong>PyRadio</strong> to enter <em>Debug mode</em>, which means that it will print debug messages to a file. This file will always reside in the user’s home directory and will be named <em>pyradio.log</em>.</p>
401405
<p>In case of a bug or a glitch, please include this file to the issue you will <a target="_blank" href="https://github.com/coderholic/pyradio/issues">open at github</a>.</p>

README.md

Lines changed: 24 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -534,6 +534,30 @@ If so, a notification message will be displayed, informing the user about it.
534534

535535
## Cleaning up
536536

537+
Since version 0.8.7.3 (0.8.8-beta2), it is not necessary to follow the previous procedure any more; **PyRadio** will search and remove any previously installed files when the "**-u**" (uninstall) parameter is used.
538+
539+
This procedure will remove any **Pyradio** files installed in your system, but will leave instact **PyRadio** configuration files.
540+
541+
Windows users notice: This procedure **will not** uninstall python, mplayer, or git from your system.
542+
543+
Example:
544+
545+
$ devel/build_install_pyradio -u
546+
Uninstalling PyRadio
547+
** Removing executable ... done
548+
** Removing help files ... done
549+
Looking for python installed files
550+
** Removing "pyradio-0.8.8-py3.8.egg" ... done
551+
** Removing "pyradio-0.8.6-py2.7.egg" ... done
552+
** Removing "pyradio-0.8.8-py3.8.egg" ... done
553+
PyRadio successfully uninstalled
554+
555+
In this example, running *devel/build_install_pyradio -u* has removed **PyRadio** python 3.8 system wide installation files, **PyRadio** python 2.7 system wide installation files, and **PyRadio** python 3.8 user installation files, found in the system.
556+
557+
I would recommend to execute *devel/build_install_pyradio -u* from time to time, and reinstall **Pyradio** right after its completion.
558+
559+
### Previous cleaning up procedure
560+
537561
As **PyRadio** versions accumulate, when building from source, one may have to *clean up* old installation files.
538562

539563
To do that, one has to observe the installation process in order to find out where the package is installed. The installation would complete printing the following messages (on *python 3.7*):
@@ -558,22 +582,6 @@ As we see, previous versions still exist in this system: **0.7.6.2** and **0.7.7
558582
$ sudo rm -rf /usr/lib/python3.7/site-packages/pyradio-.7.6.2-py3.7.egg
559583
$ sudo rm -rf /usr/lib/python3.7/site-packages/pyradio-0.7.7-py3.7.egg
560584

561-
**Note:** Since version 0.8.7.3 (0.8.8-beta2), it is not necessary to follow the previous procedure any more; **PyRadio** will search and remove any previously installed files when the "**-u**" (uninstall) parameter is used.
562-
563-
Example:
564-
565-
$ devel/build_install_pyradio -u
566-
Uninstalling PyRadio
567-
** Removing executable ... done
568-
** Removing help files ... done
569-
Looking for python installed files
570-
** Removing "pyradio-0.8.8-py3.8.egg" ... done
571-
** Removing "pyradio-0.8.6-py2.7.egg" ... done
572-
** Removing "pyradio-0.8.8-py3.8.egg" ... done
573-
PyRadio successfully uninstalled
574-
575-
In this example, running *devel/build_install_pyradio -u* has removed **PyRadio** python 3.8 system wide installation files, **PyRadio** python 2.7 system wide installation files, and **PyRadio** python 3.8 user installation files, found in the system.
576-
577585
## Debug mode
578586

579587
Adding the "**-d**" option to the command line will instruct **PyRadio** to enter *Debug mode*, which means that it will print debug messages to a file. This file will always reside in the user's home directory and will be named *pyradio.log*.

devel/build_install_pyradio.bat

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -144,11 +144,14 @@ goto :endofscript
144144

145145

146146
:uninstall
147-
echo === Gathering information...
147+
echo Uninstalling PyRadio
148+
echo ** Gathering information...
148149
DEL pyremove.bat 2>nul
149-
echo echo === Removing executable... >>pyremove.bat
150+
echo echo ** Removing executable... >>pyremove.bat
151+
echo echo ** Removing Desktop shortcut... >>pyremove.bat
152+
echo IF EXIST "%DESKTOP%\PyRadio.lnk" DEL "%DESKTOP%\PyRadio.lnk" 2>nul >>pyremove.bat
150153
python devel\site.py exe 2>nul >>pyremove.bat
151-
echo echo === Removing Python files... >>pyremove.bat
154+
REM echo echo ** Removing Python files... >>pyremove.bat
152155
python devel\site.py 2>nul >dirs
153156
python2 devel\site.py 2>nul >>dirs
154157
python3 devel\site.py 2>nul >>dirs
@@ -157,20 +160,17 @@ python2 -m site --user-site 2>nul >>dirs
157160
python3 -m site --user-site 2>nul >>dirs
158161
python devel\windirs.py
159162
echo DEL dirs >>pyremove.bat
160-
echo echo === Removing Desktop shortcut... >>pyremove.bat
161-
echo IF EXIST "%DESKTOP%\PyRadio.lnk" DEL "%DESKTOP%\PyRadio.lnk" 2>nul >>pyremove.bat
163+
echo echo Pyradio successfully uninstalled! >>pyremove.bat
162164

163165
echo echo. >>pyremove.bat
164-
echo echo ********************************************************** >>pyremove.bat
165-
echo echo * >>pyremove.bat
166-
echo echo * Pyradio successfully uninstalled! >>pyremove.bat
167-
echo echo * >>pyremove.bat
168-
echo echo * PyRadio has not uninstalled MPlayer, Python and/or Git. >>pyremove.bat
169-
echo echo * You will have to manually uninstall them. >>pyremove.bat
170-
echo echo * >>pyremove.bat
171-
echo echo * PyRadio user files are left instact. You can find them >>pyremove.bat
172-
echo echo * at %APPDATA%\pyradio >>pyremove.bat
173-
echo echo * >>pyremove.bat
166+
echo echo ********************************************************* >>pyremove.bat
167+
echo echo. >>pyremove.bat
168+
echo echo PyRadio has not uninstalled MPlayer, Python and/or Git. >>pyremove.bat
169+
echo echo You will have to manually uninstall them. >>pyremove.bat
170+
echo echo. >>pyremove.bat
171+
echo echo PyRadio user files are left instact. You can find them at >>pyremove.bat
172+
echo echo %APPDATA%\pyradio >>pyremove.bat
173+
echo echo. >>pyremove.bat
174174
echo echo ********************************************************** >>pyremove.bat
175175
echo echo. >>pyremove.bat
176176
REM copy pyremove.bat con

devel/windirs.py

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
import sys
22
import glob
3-
from os.path import sep
3+
from os.path import sep, basename
44

55
def show_python_dirs():
66
import site
@@ -33,5 +33,7 @@ def show_python_dirs():
3333
pydirs = glob.glob(a_dir + sep + 'pyradio*egg')
3434
if pydirs:
3535
with open("pyremove.bat", "a") as f:
36+
f.write('echo Looking for python installed files...\n')
3637
for a_dir in pydirs:
38+
f.write('echo ** "{}"\n'.format(basename(a_dir)))
3739
f.write('RD /S /Q "{}"\n'.format(a_dir))

pyradio.1

Lines changed: 26 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -630,7 +630,33 @@ If for any reason \fBpyradio\fR always starts in \fIlocked mode\fR, one can \fBu
630630
If so, a notification message will be displayed, informing the user about it.
631631

632632
.SH CLEANING UP
633+
633634
.PP
635+
Since version 0.8.7.3 (0.8.8-beta2), it is not necessary to follow the previous procedure any more; \fBpyradio\fR will search and remove any previously installed files when the "\fB-u\fR" (uninstall) parameter is used.
636+
637+
This procedure will remove any \fBpyradio\fR files installed in your system, but will leave instact \fBpyradio\fR configuration files.
638+
639+
Windows users notice: This procedure \fBwill not\fR uninstall python, mplayer, or git from your system.
640+
641+
Example:
642+
643+
\fI$ \fBdevel/build_install_pyradio -u\fI
644+
Uninstalling PyRadio
645+
** Removing executable ... done
646+
** Removing help files ... done
647+
Looking for python installed files
648+
** Removing "pyradio-\fB0.8.8-py3.8\fI.egg" ... done
649+
** Removing "pyradio-\fB0.8.6-py2.7\fI.egg" ... done
650+
** Removing "pyradio-\fB0.8.8-py3.8\fI.egg" ... done
651+
PyRadio successfully uninstalled\fR
652+
653+
In this example, running \fIdevel/build_install_pyradio -u\fR has removed \fBpyradio\fR python 3.8 system wide installation files, \fBpyradio\fR python 2.7 system wide installation files, and \fBpyradio\fR python 3.8 user installation files, found in the system.
654+
655+
I would recommend to execute \fBdevel/build_install_pyradio -u\fR from time to time, and reinstall \fBpyradio\fR right after its completion.
656+
657+
.PP
658+
\fBPREVIOUS CLEANING UP PROCEDURE\fR
659+
634660
As \fBpyradio\fR versions accumulate, when building from source, one may have to \fIclean up\fR old installation files.
635661

636662
To do that, one has to observe the installation process in order to find out where the package is installed. The installation would complete printing the following messages (on \fIpython 3.7\fR):
@@ -668,23 +694,6 @@ As we see, previous versions still exist in this system: \fB0.7.6.2\fR and \fB0.
668694
\fI$ \fBsudo rm -rf /usr/lib/python3.7/site-packages/pyradio-\fI0.7.7\fB-py3.7.egg
669695

670696

671-
.IP \fBNote:
672-
Since version 0.8.7.3 (0.8.8-beta2), it is not necessary to follow the previous procedure any more; \fBpyradio\fR will search and remove any previously installed files when the "\fB-u\fR" (uninstall) parameter is used.
673-
674-
Example:
675-
676-
\fI$ \fBdevel/build_install_pyradio -u\fI
677-
Uninstalling PyRadio
678-
** Removing executable ... done
679-
** Removing help files ... done
680-
Looking for python installed files
681-
** Removing "pyradio-\fB0.8.8-py3.8\fI.egg" ... done
682-
** Removing "pyradio-\fB0.8.6-py2.7\fI.egg" ... done
683-
** Removing "pyradio-\fB0.8.8-py3.8\fI.egg" ... done
684-
PyRadio successfully uninstalled\fR
685-
686-
In this example, running \fIdevel/build_install_pyradio -u\fR has removed \fBpyradio\fR python 3.8 system wide installation files, \fBpyradio\fR python 2.7 system wide installation files, and \fBpyradio\fR python 3.8 user installation files, found in the system.
687-
688697
.SH DEBUG MODE
689698
.PP
690699
Adding the \fB-d\fR option to the command line will instruct \fBpyradio\fR to enter \fBDebug mode\fR, which means that it will print debug messages to a file. This file will always reside in the user's home directory and will be named \fIpyradio.log\fR.

pyradio/radio.py

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3373,7 +3373,8 @@ def keypress(self, char):
33733373
self.ws.ADD_STATION_MODE, self.ws.THEME_MODE,
33743374
self.ws.RENAME_PLAYLIST_MODE, self.ws.NEW_PLAYLIST_MODE) and \
33753375
self.ws.operation_mode not in self.ws.PASSIVE_WINDOWS and \
3376-
not self.is_search_mode(self.ws.operation_mode):
3376+
not self.is_search_mode(self.ws.operation_mode) and \
3377+
self.ws.window_mode not in (self.ws.CONFIG_MODE, ):
33773378
self._update_status_bar_right()
33783379
self._config_win = None
33793380
self.theme_forced_selection = None

windows.html

Lines changed: 35 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ <h2 id="table-of-contents">Table of contents <span style="padding-left: 10px;"><
5858
<li><a href="#updating-with-git">5.1 Updating with Git</a></li>
5959
<li><a href="#updating-without-git">5.2 Updating without Git</a></li>
6060
</ul></li>
61+
<li><a href="#uninstalling-pyradio-or-cleaning-up">6. Uninstalling Pyradio (or Cleaning up)</a></li>
6162
</ul></li>
6263
<li><a href="build.html">Back</a></li>
6364
<li><a href="README.html">Back to README</a></li>
@@ -149,19 +150,20 @@ <h3 id="pyradio-installation">4. PyRadio installation <span style="padding-left:
149150
<p>You are ready to install <strong>PyRadio</strong>!</p>
150151
<p>So here’s how you do it:</p>
151152
<h4 id="using-git">4.1 Using Git</h4>
152-
<p>If you have Git installed, you open a console (press the <strong>Win</strong> key, type <strong>cmd</strong> and press <strong>ENTER</strong>) and type:</p>
153+
<p>If you have Git installed, you open a console (press the <strong>Win</strong> key, type <strong>cmd</strong> and press <strong>ENTER</strong> or if you are on Windows 10, use <strong>Run it as Administrator</strong> as you can see in the following image).</p>
154+
<p><a target="_blank" href="https://members.hellug.gr/sng/pyradio/run-as-admin.jpg">Run as Administrator</a></p>
155+
<p>Then type:</p>
153156
<pre>git clone https://github.com/coderholic/pyradio.git
154157
cd pyradio
155158
devel\build_install_pyradio</pre>
156159
<h4 id="not-using-git">4.2 Not using Git</h4>
157160
<p>Go to <a target="_blank" href="https://github.com/coderholic/pyradio/releases">PyRadio’s Releases page</a> and download the latest release (either a zip or a tar.gz file).</p>
158161
<p>Extract this file to your “<em>Home</em>” directory (“<strong>C:\Users\[Your User Name]</strong>” or “<strong>%USERPROFILE%</strong>) - you will get a directory whose name is similar to”<strong>pyradio-0.7.9</strong>".</p>
159162
<p>I will use this name for the following examples; you will have to use the actual name of directory you got from the extraction.</p>
160-
<p>Finally, open a console (press the <strong>Win</strong> key, type <strong>cmd</strong> and press <strong>ENTER</strong> or if you are on Windows 10, use <strong>Run it as Administrator</strong> as you can see in the following image)</p>
163+
<p>Finally, open a console (press the <strong>Win</strong> key, type <strong>cmd</strong> and press <strong>ENTER</strong> or if you are on Windows 10, use <strong>Run it as Administrator</strong> as you can see in the following image).</p>
161164
<p><a target="_blank" href="https://members.hellug.gr/sng/pyradio/run-as-admin.jpg">Run as Administrator</a></p>
162165
<p>Then type:</p>
163166
<pre>cd pyradio-0.7.9
164-
cd pyradio
165167
devel\build_install_pyradio</pre>
166168
<h4 id="final-steps">4.3 Final steps</h4>
167169
<p>If the installation is successful, you will get something similar to the following snippet:</p>
@@ -199,5 +201,35 @@ <h4 id="updating-with-git">5.1 Updating with Git</h4>
199201
devel\build_install_pyradio</pre>
200202
<h4 id="updating-without-git">5.2 Updating without Git</h4>
201203
<p>The procedure is the same as installing, so please follow the <a href="#not-using-git">relevant instructions</a>.</p>
204+
<h3 id="uninstalling-pyradio-or-cleaning-up">6. Uninstalling Pyradio (or Cleaning up) <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></style></h3>
205+
<p>To uninstall <strong>PyRadio</strong> you will have to use the “<strong>-u</strong>” (uninstall) parameter.</p>
206+
<p>This procedure will remove any <strong>Pyradio</strong> files installed in your system, but will leave instact <strong>PyRadio</strong> configuration files or uninstall python, mplayer, or git from your system.</p>
207+
<p>To uninstall <strong>PyRadio</strong> open a console (press the <strong>Win</strong> key, type <strong>cmd</strong> and press <strong>ENTER</strong> or if you are on Windows 10, use <strong>Run it as Administrator</strong> as you can see in the following image).</p>
208+
<p><a target="_blank" href="https://members.hellug.gr/sng/pyradio/run-as-admin.jpg">Run as Administrator</a></p>
209+
<p>Then navigate to the previously downloaded <strong>Pyradio</strong> setup folder, and execute <em>devel\build_install_pyradio -u</em>.</p>
210+
<p>Example:</p>
211+
<pre>C:\Users\spiros\pyradio&gt;devel\build_install_pyradio -u
212+
Uninstalling PyRadio
213+
** Gathering information...
214+
** Removing executable...
215+
** Removing Desktop shortcut...
216+
Looking for python installed files...
217+
** &quot;pyradio-0.8.8-py3.7.egg&quot;
218+
** &quot;pyradio-0.7.9-py3.7.egg&quot;
219+
** &quot;pyradio-0.6.3-py3.7.egg&quot;
220+
Pyradio successfully uninstalled!
221+
222+
*********************************************************
223+
224+
PyRadio has not uninstalled MPlayer, Python and/or Git.
225+
You will have to manually uninstall them.
226+
227+
PyRadio user files are left instact. You can find them at
228+
C:\Users\spiros\AppData\Roaming\pyradio
229+
230+
**********************************************************</pre>
231+
<p>In this example, running <em>devel\build_install_pyradio -u</em> has removed <strong>PyRadio</strong> python 3.7 installation files.</p>
232+
<p>The script has detected (and removed) version <em>8.8</em> (probably the current or previous version), along with verisons <em>7.9</em> and <em>6.3</em> (older versions previously installed).</p>
233+
<p>I would recommend to execute <em>devel\build_install_pyradio -u</em> from time to time, and reinstall <strong>PyRadio</strong> right after its completion.</p>
202234
</body>
203235
</html>

0 commit comments

Comments
 (0)