updating docs

Author: s-n-g

docs/index.html

@@ -122,6 +122,7 @@ <h2 id="table-of-contents">Table of Contents <span style="padding-left: 10px;"><
 <li><a href="#specifying-a-station&#39;s-referer-url">Specifying a station’s Referer URL</a>
 <ul>
 <li><a href="#a-note-of-caution">A note of caution</a></li>
+<li><a href="#note-about-mplayer">Note about MPlayer</a></li>
 </ul></li>
 <li><a href="#extra-player-parameters">Extra Player Parameters</a>
 <ul>
@@ -1767,7 +1768,7 @@ <h3 id="changing-player-mid-session">Changing player mid-session</h3>
 <p>If <strong>recording is on</strong> while using the previously activated player, it will remain on with the newly activated one. This actually means that the recording will stop when the old player is stopped and resumed when the new player is activated (creating a new recorder file). There is just one exception to that; selecting <strong>VLC</strong> is not possible on <strong>Windows</strong>, since <strong>VLC</strong> does not support recording on this platform.</p>
 <p style="margin: 1.5em 4em 0 4em; text-indent: -2.5em;"><strong>Note:</strong> The activated player will not be saved; <strong>PyRadio</strong> will still use the player defined at its config next time it is executed.</p>
 <h3 id="specifying-a-stations-referer-url">Specifying a station’s Referer URL</h3>
-<p>Although <strong>PyRadio</strong> is meant to be a readio station player, it can also be used to listen to video stations transmitting m3u8 playlists (HTTP Live Streaming or HLS).</p>
+<p>Although <strong>PyRadio</strong> is meant to be a radio station player, it can also be used to listen to video stations transmitting m3u8 playlists (HTTP Live Streaming or HLS).</p>
 <p>The thing with these transmissions is that usually a <strong>Referer URL</strong> has to be provided so that the connection does not fail.</p>
 <p><strong>PyRadio</strong> now does support the declaration of a <strong>Referer URL</strong> for individual stations; it does it in an “anorthodox” way, but it is possible.</p>
 <p>So, let us imagine that a station called “<em>My video station</em>” has been added to a playlist. The user tries to play it but it fails; the referer URL is missing.</p>
@@ -1777,6 +1778,19 @@ <h3 id="specifying-a-stations-referer-url">Specifying a station’s Referer URL<
 <h4 id="a-note-of-caution">A note of caution</h4>
 <p>If such a file has been created for a station, please do not rename the station in the playlist manually; the “link” to the referer file will be lost.</p>
 <p>Rename the station using <strong>PyRadio</strong> rename functionality and save the playlist instead; the referer file will be renamed as well.</p>
+<h4 id="note-about-mplayer">Note about MPlayer</h4>
+<p>This will unfortunately not work with <strong>MPlayer</strong>.</p>
+<p>It seems it will not use the <strong>Referer</strong> provided, as shown in the following part of the command execution output:</p>
+<pre>[tcp @ 0x7f4a42c7fa60]Successfully connected to XX.XX.XXX.XX port 443
+[https @ 0x7f4a42c7fa60]request: GET /live/XXXXXXXX.m3u8 HTTP/1.1
+User-Agent: Lavf/60.16.100
+Accept: */*
+Range: bytes=0-
+Connection: close
+Host: XXXXXX-XXXXXXXXX.XXXXXX.XXX.XXX.XX
+Icy-MetaData: 1
+
+[https @ 0x7f4a42c7fa60]HTTP error 403 Forbidden</pre>
 <h3 id="extra-player-parameters">Extra Player Parameters</h3>
 <p>All three supported players can accept a significant number of “<em>command line options</em>”, which are well documented and accessible through man pages (on linux and MacOs) or the documentation (on Windows).</p>
 <p><strong>PyRadio</strong> uses some of these parameters in order to execute and communicate with the players. In particular, the following parameters are in use <strong>by default</strong>:</p>

docs/index.md

@@ -84,6 +84,7 @@ To ensure the correct operation, please take these actions:
     * [Changing player mid-session](#changing-player-mid-session)
     * [Specifying a station's Referer URL](#specifying-a-station's-referer-url)
         * [A note of caution](#a-note-of-caution)
+        * [Note about MPlayer](#note-about-mplayer)
     * [Extra Player Parameters](#extra-player-parameters)
         * [Using the Configuration Window](#using-the-configuration-window)
 * [Player connection protocol](#player-connection-protocol)
@@ -751,7 +752,7 @@ If **recording is on** while using the previously activated player, it will rema
 
 ### Specifying a station's Referer URL
 
-Although **PyRadio** is meant to be a readio station player, it can also be used to listen to video stations transmitting m3u8 playlists (HTTP Live Streaming or HLS).
+Although **PyRadio** is meant to be a radio station player, it can also be used to listen to video stations transmitting m3u8 playlists (HTTP Live Streaming or HLS).
 
 The thing with these transmissions is that usually a **Referer URL** has to be provided so that the connection does not fail.
 
@@ -771,6 +772,25 @@ If such a file has been created for a station, please do not rename the station
 
 Rename the station using **PyRadio** rename functionality and save the playlist instead; the referer file will be renamed as well.
 
+#### Note about MPlayer
+
+This will unfortunately not work with **MPlayer**.
+
+It seems it will not use the **Referer** provided, as shown in the following part of the command execution output:
+
+```
+[tcp @ 0x7f4a42c7fa60]Successfully connected to XX.XX.XXX.XX port 443
+[https @ 0x7f4a42c7fa60]request: GET /live/XXXXXXXX.m3u8 HTTP/1.1
+User-Agent: Lavf/60.16.100
+Accept: */*
+Range: bytes=0-
+Connection: close
+Host: XXXXXX-XXXXXXXXX.XXXXXX.XXX.XXX.XX
+Icy-MetaData: 1
+
+[https @ 0x7f4a42c7fa60]HTTP error 403 Forbidden
+```
+
 ### Extra Player Parameters
 
 All three supported players can accept a significant number of "*command line options*", which are well documented and accessible through man pages (on linux and MacOs) or the documentation (on Windows).

docs/pyradio.1

@@ -843,7 +843,7 @@ The activated player will not be saved; **PyRadio** will still use the player de
 
 .SH Specifying a station's Referer URL
 
-Although \fBpyradio\fR is meant to be a readio station player, it can also be used to listen to video stations transmitting m3u8 playlists (HTTP Live Streaming or HLS).
+Although \fBpyradio\fR is meant to be a radio station player, it can also be used to listen to video stations transmitting m3u8 playlists (HTTP Live Streaming or HLS).
 
 The thing with these transmissions is that usually a \fBReferer URL\fR has to be provided so that the connection does not fail.
 
@@ -866,6 +866,31 @@ If such a file has been created for a station, please do not rename the station
 Rename the station using \fBpyradio\fR rename functionality and save the playlist instead; the referer file will be renamed as well.
 .RE
 
+\fBNote\fR
+.RS 2
+
+This will unfortunately not work with \fBMPlayer\fR.
+
+It seems it will not use the \fIReferer\fR provided, as shown in the following part of the command execution output:
+
+\fI[tcp @ 0x7f4a42c7fa60]Successfully connected to XX.XX.XXX.XX port 443
+.br
+[https @ 0x7f4a42c7fa60]request: GET /live/XXXXXXXX.m3u8 HTTP/1.1
+.br
+\fBUser-Agent: Lavf/60.16.100\fI
+.br
+Accept: */*
+.br
+Range: bytes=0-
+.br
+Connection: close
+.br
+Host: XXXXXX-XXXXXXXXX.XXXXXX.XXX.XXX.XX
+.br
+Icy-MetaData: 1
+
+[https @ 0x7f4a42c7fa60]\fBHTTP error 403 Forbidden\fR
+.RE
 
 
 .SH Extra Player Parameters

pyradio/radio.py

@@ -233,6 +233,7 @@ def _update_selection(self):
             self._win.refresh()
 
     def keypress(self, char):
+        # select player keypress
         if char in (
             ord('j'), curses.KEY_DOWN,
             ord('k'), curses.KEY_UP
@@ -6190,6 +6191,9 @@ def keypress(self, char):
             elif char in range(48, 58) or char in range(97, 123):
                 self._cnf.register_to_open = chr(char).lower()
                 self._update_status_bar_right(status_suffix='')
+            # elif char == ord('*'):
+            #     # open favorites
+            #     self._update_status_bar_right(status_suffix='')
             else:
                 self._update_status_bar_right(status_suffix='')
                 return