diff --git a/README.html b/README.html index f90892ee..5255b104 100644 --- a/README.html +++ b/README.html @@ -7,22 +7,29 @@
Command line internet radio player.
Ben Dowling - https://github.com/coderholic
PyRadio: Command line internet radio player.
Ben Dowling - https://github.com/coderholic
PyRadio: Command line internet radio player.
+Ben Dowling - https://github.com/coderholic
+[Back to Build Instructions] [Back to README]
+Go to MPlayer’s home and open the download page. Then scroll down to the Binaries section and get to the MPlayer Windows builds page. Then scroll down again until you get to the Build selection table to select an installation bundle.
+Note: I am stating here all the links, although all one has to do is get to the last one and download the MPlayer setup. This is done so that in case any of the links change in the future, the way to go will be known, having MPlayer’s home page as a starting point.
+You will end up downloading a 7z archive, which contains a directory whose name is similar to MPlayer-corei7-r38135+gb272d5b9b6.
+Note: MPlayer provides CPU type dependent builds. In case you select the wrong mplayer build, you will end up connecting to stations but having no sound. If this is the case, please do go back to the download page and get the right build for your system / CPU.
+Extract this directory to whatever place you like and rename it to mplayer.
+Here comes the tricky part…
+Move the mplayer directory to either on of the following locations:
+This is actually your “Home” directory.
+Please make a note that you will add "%USERPROFILE%\mplayer to PATH.
This is (or will be) “PyRadio’s configuration directory”.
+In case the pyradio directory does not exit, you just go ahead and create it.
+(Make a note that you will add "%APPDATA%\pyradio\mplayer to PATH)
In either case, in order to do that, open an Explorer File Manager window, and enter at its location field %USERPROFILE% or %APPDATA%.
+If you are unsure on how to do that, please refer to the following image (you can ENTER %USERPROFILE% or %APPDATA% or any other Windows System Variable this way).
+ +The final step is to add MPlayer to the PATH System Variable.
+Now, you already know the path string that has to be added (you have made a note of it in the previous step).
+There’s just one thing to say here: Windows provide a “User variable for User” and a “System variables” section in the “Environment Variables” window.
+Add the path string to the “User variables for User” section.
+In order to make the actual addition, please refer to the following image.
+ +After applying the changes you should log off and back on or restart the system, because changes done to the PATH variable will take effect the next time you log into the system.
+When you are back on, verify that you can run MPlayer; open a console (press the Win key, type cmd and press ENTER) and type “mplayer”.
+If you get something similar to the following snippet, you are all good.
+MPlayer Redxii-SVN-r38119-6.2.0 (x86_64) (C) 2000-2018 MPlayer Team +Using FFmpeg N-92801-g7efe84aebd (2018-12-25 00:44:17 +0100) +Compiled on 2018-12-25 13:55:17 EST (rev. 1) +Usage: mplayer [options] [url|path/]filename+
If mplayer was not found, you just have to go through the PATH modification procedure again.
+ + diff --git a/windows-mplayer.md b/windows-mplayer.md new file mode 100644 index 00000000..c42d4424 --- /dev/null +++ b/windows-mplayer.md @@ -0,0 +1,79 @@ +# MPlayer Installation on Windows + +**PyRadio**: Command line internet radio player. + +Ben Dowling - [https://github.com/coderholic](https://github.com/coderholic) + + +## Table of contents + +* [MPlayer installation](#mplayer-installation) + * [Adding MPlayer to the PATH](#adding-mplayer-to-the-path) + +[[Back to Build Instructions]](windows.md) [[Back to README]](README.md) + +## MPlayer installation + +Go to [MPlayer's home](http://www.mplayerhq.hu/) and open the [download](http://www.mplayerhq.hu/design7/dload.html) page. Then scroll down to the **Binaries** section and get to the [MPlayer Windows builds](http://oss.netfarm.it/mplayer/) page. Then scroll down again until you get to the **Build selection table** to select an installation bundle. + +**Note:** I am stating here all the links, although all one has to do is get to the last one and download the **MPlayer setup**. This is done so that in case any of the links change in the future, the way to go will be known, having [MPlayer's home page](http://www.mplayerhq.hu/) as a starting point. + +You will end up downloading a [7z archive](https://www.7-zip.org/), which contains a directory whose name is similar to **MPlayer-corei7-r38135+gb272d5b9b6**. + +**Note:** *MPlayer* provides CPU type dependent builds. In case you select the wrong *mplayer* build, you will end up connecting to stations but having no sound. If this is the case, please do go back to the download page and get the right build for your system / CPU. + +Extract this directory to whatever place you like and **rename** it to **mplayer**. + +Here comes the tricky part... + +Move the **mplayer** directory to either on of the following locations: + +a. **%USERPROFILE%** + + This is actually your "*Home*" directory. + + Please make a note that you will add "**%USERPROFILE%\\mplayer** to PATH. + +b. **%APPDATA%\\pyradio** + + This is (or will be) "*PyRadio's configuration directory*". + + In case the **pyradio** directory does not exit, you just go ahead and create it. + + (Make a note that you will add "**%APPDATA%\\pyradio\\mplayer** to PATH) + +In either case, in order to do that, open an **Explorer File Manager** window, and enter at its location field **%USERPROFILE%** or **%APPDATA%**. + +If you are unsure on how to do that, please refer to the following image (you can ENTER **%USERPROFILE%** or **%APPDATA%** or any other Windows System Variable this way). + +[Navigating to %APPDATA%](https://members.hellug.gr/sng/pyradio/appdata.jpg) + + +### Adding MPlayer to the PATH + +The final step is to add MPlayer to the PATH System Variable. + +Now, you already know the **path string** that has to be added (you have made a note of it in the previous step). + +There's just one thing to say here: Windows provide a "*User variable for User*" and a "*System variables*" section in the "*Environment Variables*" window. + +Add the **path string** to the "*User variables for User*" section. + +In order to make the actual addition, please refer to the following image. + +[Adding MPlayer to the PATH](https://members.hellug.gr/sng/pyradio/path.jpg) + +After applying the changes you should **log off and back on** or **restart the system**, because changes done to the PATH variable will take effect the next time you log into the system. + +When you are back on, verify that you can run **MPlayer**; open a console (press the **Win** key, type **cmd** and press **ENTER**) and type "**mplayer**". + +If you get something similar to the following snippet, you are all good. + +``` +MPlayer Redxii-SVN-r38119-6.2.0 (x86_64) (C) 2000-2018 MPlayer Team +Using FFmpeg N-92801-g7efe84aebd (2018-12-25 00:44:17 +0100) +Compiled on 2018-12-25 13:55:17 EST (rev. 1) +Usage: mplayer [options] [url|path/]filename +``` + +If **mplayer** was not found, you just have to go through the PATH modification procedure again. diff --git a/windows.html b/windows.html index 33b89242..890411ad 100644 --- a/windows.html +++ b/windows.html @@ -7,22 +7,29 @@PyRadio: Command line internet radio player.
Ben Dowling - https://github.com/coderholic
First of all, let me tell you that if you are still running Windows XP, you can just stop reading right now; it won’t happen…
-Then, due to reasons that are of no importance right now, MPlayer is the only player that can be used. Furthermore, special care has to be taken in order to be able to save the volume of the player.
+Then, due to reasons that are of no importance right now, mpv is not (yet?) supported. That leaves us with MPlayer and VLC.
+Installing MPlayer takes a couple of extra steps, and you may find that some streams (e.g. m3u8) may not be playable. Furthermore, special care has to be taken in order to be able to save the volume of the player.
+VLC is much easier to install, but song titles’ updating may not be 100% consistaent. If this is not a deal breaker for you, then just go on and use VLC as PyRadio’s player.
Other than that, you will have a fully functional PyRadio installation.
Having said that, let us proceed with the installation.
The installation consists of three (optionally four) steps:
Python 3.6.4 (v3.6.4:d48eceb, Dec 19 2017, 06:54:40) [MSC v.1900 64 bit (AMD64)] on win Type "help", "copyright", "credits" or "license" for more information. >>>-
If the command could not be found, you have to run the installation again, select “Modify” and set the “Add Python to environment varaibles” option. You can refer to the following image to see the relevant setting.
+If the command could not be found, you have to run the installation again, select “Modify” and set the “Add Python to environment variables” option. You can refer to the following image to see the relevant setting.
Python Installation Modification
Note: If you don’t have the setup file of the original Python installation, you will have to download it from Python’s Windows Downloads. In case you want to upgrade to the latest version, you must uninstall the one currently installed, beforehand.
-Go to MPlayer’s home and open the download page. Then scroll down to the Binaries section and get to the MPlayer Windows builds page. Then scroll down again until you get to the Build selection table to select an installation bundle.
-Note: I am stating here all the links, although all one has to do is get to the last one and download the MPlayer setup. This is done so that in case any of the links change in the future, the way to go will be known, having MPlayer’s home page as a starting point.
-You will end up downloading a 7z archive, which contains a directory whose name is similar to MPlayer-corei7-r38135+gb272d5b9b6.
-Note: MPlayer provides CPU type dependent builds. In case you select the wrong mplayer build, you will end up connecting to stations but having no sound. If this is the case, please do go back to the download page and get the right build for your system / CPU.
-Extract this directory to whatever place you like and rename it to mplayer.
-Here comes the tricky part…
-Move the mplayer directory to either on of the following locations:
-This is actually your “Home” directory.
-Please make a note that you will add "%USERPROFILE%\mplayer to PATH.
This is (or will be) “PyRadio’s configuration directory”.
-In case the pyradio directory does not exit, you just go ahead and create it.
-(Make a note that you will add "%APPDATA%\pyradio\mplayer to PATH)
In either case, in order to do that, open an Explorer File Manager window, and enter at its location field %USERPROFILE% or %APPDATA%.
-If you are unsure on how to do that, please refer to the following image (you can ENTER %USERPROFILE% or %APPDATA% or any other Windows System Variable this way).
- -The final step is to add MPlayer to the PATH System Variable.
-Now, you already know the path string that has to be added (you have made a note of it in the previous step).
-There’s just one thing to say here: Windows provide a “User variable for User” and a “System variables” section in the “Environment Variables” window.
-Add the path string to the “User variables for User” section.
-In order to make the actual addition, please refer to the following image.
- -After applying the changes you should log off and back on or restart the system, because changes done to the PATH variable will take effect the next time you log into the system.
-When you are back on, verify that you can run MPlayer; open a console (press the Win key, type cmd and press ENTER) and type “mplayer”.
-If you get something similar to the following snippet, you are all good.
-MPlayer Redxii-SVN-r38119-6.2.0 (x86_64) (C) 2000-2018 MPlayer Team -Using FFmpeg N-92801-g7efe84aebd (2018-12-25 00:44:17 +0100) -Compiled on 2018-12-25 13:55:17 EST (rev. 1) -Usage: mplayer [options] [url|path/]filename-
If mplayer was not found, you just have to go through the PATH modification procedure again.
+It’s time to decide which player you want to use, either MPlayer or VLC, or even both of them.
+This is what you should know before making your decision:
++ | MPlayer | +VLC | +
---|---|---|
Pros | +Fully functional | +Easy installation Plays almost all streams |
+
Cons | +Extra steps to install May not play all streams (e.g. m3u8) |
+Titles update is not consistent | +
If MPlayer is your selection, please refer to the relevant instructions.
+If VLC is your selection, just go and get it and install it as any other Windows program.
+As long as you install it to its default location (e.g “C:\Program Files\VideoLAN\VLC” or “C:\Program Files (x86)\VideoLAN\VLC”) Pyradio will be able to detect and use it.
This is an optional step, so if you do not want to install yet another program to your PC, you are free to skip it.
Having said that, why would you install Git?
diff --git a/windows.md b/windows.md index cbe35ac7..05636494 100644 --- a/windows.md +++ b/windows.md @@ -12,8 +12,9 @@ Ben Dowling - [https://github.com/coderholic](https://github.com/coderholic) * [1. Python installation](#python-installation) * [1.1 Installing Python](#installing-python) * [1.2 Verifying the installation](#verifying-the-installation) - * [2. MPlayer installation](#mplayer-installation) - * [2.1 Adding MPlayer to the PATH](#adding-mplayer-to-the-path) + * [2. Player installation](#player-installation) + * [2.1 MPlayer installation](#mplayer-installation) + * [2.2 VLC installation](#vlc-installation) * [3. Git installation (optional)](#git-installation-optional) * [4. PyRadio installation](#pyradio-installation) * [4.1 Using Git](#using-git) @@ -41,7 +42,11 @@ This page will guide you through the process of installing, updating and running First of all, let me tell you that if you are still running Windows XP, you can just stop reading right now; it won't happen... -Then, due to reasons that are of no importance right now, [MPlayer](http://www.mplayerhq.hu/design7/news.html) is the only player that can be used. Furthermore, special care has to be taken in order to be able to save the volume of the player. +Then, due to reasons that are of no importance right now, [mpv](https://mpv.io/) is not (yet?) supported. That leaves us with [MPlayer](http://www.mplayerhq.hu/design7/news.html) and [VLC](https://www.videolan.org/vlc/). + +Installing [MPlayer](http://www.mplayerhq.hu/) takes a couple of extra steps, and you may find that some streams (e.g. m3u8) may not be playable. Furthermore, special care has to be taken in order to be able to save the volume of the player. + +[VLC](https://www.videolan.org/vlc/) is much easier to install, but song titles' updating may not be 100% consistaent. If this is not a deal breaker for you, then just go on and use [VLC](https://www.videolan.org/vlc/) as **PyRadio**'s player. Other than that, you will have a fully functional **PyRadio** installation. @@ -52,7 +57,7 @@ Having said that, let us proceed with the installation. The installation consists of three (optionally four) steps: 1. **Python** installation -2. **MPlayer** installation +2. **Player** installation 3. **Git** installation (optional) 4. **PyRadio** installation @@ -81,78 +86,34 @@ Type "help", "copyright", "credits" or "license" for more information. >>> ``` -If the command could not be found, you have to run the installation again, select "*Modify*" and set the "*Add Python to environment varaibles*" option. You can refer to the following image to see the relevant setting. +If the command could not be found, you have to run the installation again, select "*Modify*" and set the "*Add Python to environment variables*" option. You can refer to the following image to see the relevant setting. [Python Installation Modification](https://members.hellug.gr/sng/pyradio/python2.jpg) - **Note:** If you don't have the setup file of the original **Python** installation, you will have to **download** it from [Python's Windows Downloads](https://www.python.org/downloads/windows/). In case you want to upgrade to the latest version, you **must uninstall** the one currently installed, beforehand. -### 2. MPlayer installation - -Go to [MPlayer's home](http://www.mplayerhq.hu/) and open the [download](http://www.mplayerhq.hu/design7/dload.html) page. Then scroll down to the **Binaries** section and get to the [MPlayer Windows builds](http://oss.netfarm.it/mplayer/) page. Then scroll down again until you get to the **Build selection table** to select an installation bundle. - -**Note:** I am stating here all the links, although all one has to do is get to the last one and download the **MPlayer setup**. This is done so that in case any of the links change in the future, the way to go will be known, having [MPlayer's home page](http://www.mplayerhq.hu/) as a starting point. - -You will end up downloading a [7z archive](https://www.7-zip.org/), which contains a directory whose name is similar to **MPlayer-corei7-r38135+gb272d5b9b6**. - -**Note:** *MPlayer* provides CPU type dependent builds. In case you select the wrong *mplayer* build, you will end up connecting to stations but having no sound. If this is the case, please do go back to the download page and get the right build for your system / CPU. - -Extract this directory to whatever place you like and **rename** it to **mplayer**. - -Here comes the tricky part... - -Move the **mplayer** directory to either on of the following locations: - -a. **%USERPROFILE%** - - This is actually your "*Home*" directory. - - Please make a note that you will add "**%USERPROFILE%\\mplayer** to PATH. +### 2. Player installation -b. **%APPDATA%\\pyradio** +It's time to decide which player you want to use, either [MPlayer](http://www.mplayerhq.hu/design7/news.html) or [VLC](https://www.videolan.org/vlc/), or even both of them. - This is (or will be) "*PyRadio's configuration directory*". +This is what you should know before making your decision: - In case the **pyradio** directory does not exit, you just go ahead and create it. +| | MPlayer | VLC | +|----------|----------------------------------------------------------------|-----------------------------------------------| +| **Pros** | Fully functional | Easy installation