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
<p>Furtermore, the pipx installation will be a fully isolated one, which means that all dependencies will be installed along with <strong>PyRadio</strong> in a virtual environment.</p>
65
65
<p>That is a one-way street to follow since the combination of macOS versions, python installation methods and player installation methods is too complex to provide a complete installation guide for <strong>PyRadio</strong>.</p>
66
66
<p><atarget="_blank" href="https://pypa.github.io/pipx/">pipx</a> provides a standardization of the whole procedure which leads to an acceptable (enjoyable even) user experience.</p>
67
-
<h2id="install-a-media-player">Install a media player <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></span></h2>
68
-
<p>First of all you will install a supported media player (<strong>MPV</strong>, <strong>MPLayer</strong> or <strong>VLC</strong>). You are free to install any one of them or even more than one. The steps to follow from now on depends entirely on you, meaning depends entirely on the media player(s) you want to install and use with <strong>PyRadio</strong>.</p>
67
+
<h2id="preparation">Preparation <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></span></h2>
68
+
<p>These are the steps required before actually installing <strong>PyRadio</strong>.</p>
69
+
<pstyle="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> The following installation instructions were performed on a freshly installed <strong>Ventura</strong> (macOS 13) system. Things may be a bit different for older macOs versions, but it will be the same for <strong>Sonoma</strong> (macOS 14).</p>
<p>Your system comes with a pre-installed version of Python, but it would be better to install the one provided by <strong>Homebrew</strong>.</p>
78
+
<pre>brew install python3</pre>
79
+
<p>This will also install “<em>Apple’s Command Line Developer Tools</em>” (if they are not already installed).</p>
80
+
<p>Then, adjust your <strong>PATH</strong>, so that the newly installed Python will be the default one.</p>
81
+
<pre>cat << END >> ~/.zshrc
82
+
export PATH=/usr/local/bin:"$PATH"
83
+
END
84
+
source ~/.zshrc</pre>
85
+
<h3id="media-player-installation">Media player installation</h3>
86
+
<p>The next step is to install a supported media player (<strong>MPV</strong>, <strong>MPLayer</strong> or <strong>VLC</strong>). You are free to install any one of them or even more than one. The steps to follow from now on depends entirely on you, meaning depends entirely on the media player(s) you want to install and use with <strong>PyRadio</strong>.</p>
69
87
<p><strong>1. VLC</strong></p>
70
-
<p><strong>VLC</strong> provides a MacOS package, so you can just go get it from <atarget="_blank" href="https://www.videolan.org/vlc/">its site</a>. This is the cleaner way and I would recommend it.</p>
88
+
<p><strong>VLC</strong> provides a macOS package, so you can just go get it from <atarget="_blank" href="https://www.videolan.org/vlc/">its site</a>. This is the cleaner way and I would recommend it.</p>
71
89
<p>If this is the player you prefer, you will have to take one more step before it can be used with <strong>PyRadio</strong>.</p>
<p><strong>MPV</strong> and <strong>MPlayer</strong> can be installed using either <atarget="_blank" href="https://brew.sh">Homebrew</a> or <atarget="_blank" href="https://www.macports.org/">MacPorts</a>. Installation info can be found at the <ahref="#installation-of-additional-package-managers">end of this page</a>.</p>
76
-
<p>After you have installed <atarget="_blank" href="https://brew.sh">Homebrew</a> or <atarget="_blank" href="https://www.macports.org/">MacPorts</a>, you can install the player of your choice.</p>
93
+
<p><strong>MPV</strong> and <strong>MPlayer</strong> can be installed using <atarget="_blank" href="https://brew.sh">Homebrew</a>.</p>
77
94
<p><strong><em>a) MPV</em></strong></p>
78
95
<pre>brew install mpv</pre>
79
-
<p>or</p>
80
-
<pre>sudo port install mpv</pre>
81
96
<p><strong><em>b) MPlayer</em></strong></p>
82
97
<pre>brew install mplayer</pre>
83
-
<p>or</p>
84
-
<pre>sudo port install MPlayer</pre>
85
-
<h2id="get-the-installation-script">Get the installation script <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></span></h2>
98
+
<h3id="get-the-installation-script">Get the installation script</h3>
<h2id="python3-installation">Python3 installation <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></span></h2>
92
-
<p>Execute:</p>
93
-
<pre>python3</pre>
94
-
<p>If this is the first time python3 is executed you will be prompted to allow the installation of “<em>Apple’s Command Line Developer Tools</em>”. Accept the installation, wait for it to complete, and reboot.</p>
95
-
<p>When the system is up again, please check for updates (open <strong>App Store</strong> and click on <strong>Updates</strong>). Install any pending update and reboot.</p>
104
+
<h2id="pyradio-installation">PyRadio installation <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></span></h2>
96
105
<p>Your system is ready now for <strong>PyRadio</strong> to be installed.</p>
<h3id="performing-the-installation">Performing the installation</h3>
113
+
<p>Execute the following command:</p>
114
+
<pre>python3 install.py</pre>
106
115
<p>Enjoy!</p>
107
-
<h2id="installation-of-additional-package-managers">Installation of Additional Package Managers <spanstyle="padding-left: 10px;"><supstyle="font-size: 50%"><ahref="#" title="Go to top of the page">Top</a></sup></span></h2>
108
-
<p>These instructions must be followed only in case you want to use <strong>MPV</strong> or <strong>MPlayer</strong> with <strong>PyRadio</strong>.</p>
109
-
<p>It goes without saying that it’s enough to install only one of these package managers.</p>
110
-
<h3id="homebrew">Homebrew</h3>
111
-
<p>To install <atarget="_blank" href="https://brew.sh">Homebrew</a> open a <strong>terminal</strong> and type:</p>
<p><atarget="_blank" href="https://www.macports.org/">MacPorts</a> provide installation packages for each MacOS version, so just get to their <atarget="_blank" href="https://www.macports.org/install.php">site</a> and get the one suitable for you.</p>
*[Installation of Additional Package Managers](#installation-of-additional-package-managers)
13
-
*[Homebrew](#homebrew)
14
-
*[MacPorts](#macports)
14
+
*[Performing the installation](#performing-the-installation)
15
15
16
16
<!-- vim-markdown-toc -->
17
17
@@ -27,14 +27,49 @@ That is a one-way street to follow since the combination of macOS versions, pyth
27
27
28
28
[pipx](https://pypa.github.io/pipx/) provides a standardization of the whole procedure which leads to an acceptable (enjoyable even) user experience.
29
29
30
+
## Preparation
30
31
31
-
## Install a media player
32
+
These are the steps required before actually installing **PyRadio**.
32
33
33
-
First of all you will install a supported media player (**MPV**, **MPLayer** or **VLC**). You are free to install any one of them or even more than one. The steps to follow from now on depends entirely on you, meaning depends entirely on the media player(s) you want to install and use with **PyRadio**.
34
+
**Note:** The following installation instructions were performed on a freshly installed **Ventura** (macOS 13) system. Things may be a bit different for older macOs versions, but it will be the same for **Sonoma** (macOS 14).
35
+
36
+
### Homebrew installation
37
+
38
+
This is the method [Homebrew](https://brew.sh) recommends, so we just go with it.
Your system comes with a pre-installed version of Python, but it would be better to install the one provided by **Homebrew**.
51
+
52
+
brew install python3
53
+
54
+
This will also install "*Apple's Command Line Developer Tools*" (if they are not already installed).
55
+
56
+
57
+
Then, adjust your **PATH**, so that the newly installed Python will be the default one.
58
+
59
+
```
60
+
cat << END >> ~/.zshrc
61
+
export PATH=/usr/local/bin:"$PATH"
62
+
END
63
+
source ~/.zshrc
64
+
```
65
+
66
+
### Media player installation
67
+
68
+
The next step is to install a supported media player (**MPV**, **MPLayer** or **VLC**). You are free to install any one of them or even more than one. The steps to follow from now on depends entirely on you, meaning depends entirely on the media player(s) you want to install and use with **PyRadio**.
34
69
35
70
**1\. VLC**
36
71
37
-
**VLC** provides a MacOS package, so you can just go get it from [its site](https://www.videolan.org/vlc/). This is the cleaner way and I would recommend it.
72
+
**VLC** provides a macOS package, so you can just go get it from [its site](https://www.videolan.org/vlc/). This is the cleaner way and I would recommend it.
38
73
39
74
If this is the player you prefer, you will have to take one more step before it can be used with **PyRadio**.
40
75
@@ -45,27 +80,17 @@ Open a terminal and type:
45
80
46
81
**2\. MPV or MPlayer**
47
82
48
-
**MPV** and **MPlayer** can be installed using either [Homebrew](https://brew.sh) or [MacPorts](https://www.macports.org/). Installation info can be found at the [end of this page](#installation-of-additional-package-managers).
49
-
50
-
After you have installed [Homebrew](https://brew.sh) or [MacPorts](https://www.macports.org/), you can install the player of your choice.
83
+
**MPV** and **MPlayer** can be installed using [Homebrew](https://brew.sh).
51
84
52
85
***a) MPV***
53
86
54
87
brew install mpv
55
88
56
-
or
57
-
58
-
sudo port install mpv
59
-
60
89
***b) MPlayer***
61
90
62
91
brew install mplayer
63
92
64
-
or
65
-
66
-
sudo port install MPlayer
67
-
68
-
## Get the installation script
93
+
### Get the installation script
69
94
70
95
Open a terminal and execute:
71
96
@@ -76,53 +101,26 @@ curl -L \
76
101
-o install.py
77
102
```
78
103
79
-
## Python3 installation
80
-
81
-
Execute:
82
-
83
-
python3
84
-
85
-
If this is the first time python3 is executed you will be prompted to allow the installation of "*Apple's Command Line Developer Tools*". Accept the installation, wait for it to complete, and reboot.
86
-
87
-
When the system is up again, please check for updates (open **App Store** and click on **Updates**). Install any pending update and reboot.
104
+
## PyRadio installation
88
105
89
106
Your system is ready now for **PyRadio** to be installed.
90
107
91
-
92
108
### Dependencies installation
93
109
94
110
Open a terminal and type:
95
111
96
-
```
97
-
python3 -m pip install requests rich pipx
98
-
python3 -m pipx ensurepath
99
-
```
100
-
101
-
Log out and log in again for the changes to take effect.
[MacPorts](https://www.macports.org/) provide installation packages for each MacOS version, so just get to their [site](https://www.macports.org/install.php) and get the one suitable for you.
0 commit comments