- version 0.9.3.11.10 - 0.9.3.12-beta10

- removing a couple of debug messages
- updating docs
- updating mpv download link (Windows)

Author: s-n-g

Changelog

@@ -1,3 +1,16 @@
+2025-05-06 s-n-g
+    * version 0.9.3.11.10 - 0.9.3.12-beta10
+    * redesigning the Station Editor
+        - adding Volume, Buffering, Force http, Profile and Referrer fields
+        - grouping URL, Icon and Referrer fields
+    * station encoding can now get a "Default" value, to leave the station's
+      encoding empty. This will make it use the default (config) encoding.
+    * all players will use the new station fields
+    * \V will toggle the use of station volume (revert to profile volume)
+    * fixing a couple of minor bugs
+    * updating mpv download link (Windows)
+    * - updating docs
+
 2025-03-21 s-n-g
     * version 0.9.3.11.9 - 0.9.3.12-beta9
     * fixing default station selection in the config window

devel/pre-commit

@@ -292,6 +292,7 @@ do
         sed -i -e '/pyradio-editor.jpg/s/src=/style="width: 600px" src=/' "$out"
         sed -i -e '/pyradio-player-selection.jpg/s/src=/style="width: 600px" src=/' "$out"
         sed -i -e '/pyradio-station-info.jpg/s/src=/style="width: 600px" src=/' "$out"
+        sed -i -e '/station-volume.png/s/src=/style="width: 512px" src=/' "$out"
     fi
     if [ "$out" = "desktop-notification.html" ];then
         sed -i -e '/pyradio-notif.jpg/s/src=/style="width: 380px" src=/' "$out"

docs/index.html

@@ -109,6 +109,10 @@ <h2 id="table-of-contents">Table of Contents <span style="padding-left: 10px;"><
 <li><a href="#mplayer">MPlayer</a></li>
 <li><a href="#vlc">VLC</a></li>
 </ul></li>
+<li><a href="#station-volume">Station volume</a>
+<ul>
+<li><a href="#how-it-works">How it Works</a></li>
+</ul></li>
 <li><a href="#buffering">Buffering</a></li>
 <li><a href="#displaying-station-info">Displaying Station Info</a></li>
 <li><a href="#copying-and-pasting---registers">Copying and pasting - Registers</a></li>
@@ -186,6 +190,19 @@ <h2 id="requirements">Requirements <span style="padding-left: 10px;"><sup style=
 <h2 id="changelog">Changelog <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
 <pre style="height: 200px;">
 
+2025-05-06 s-n-g
+    * version 0.9.3.11.10 - 0.9.3.12-beta10
+    * redesigning the Station Editor
+        - adding Volume, Buffering, Force http, Profile and Referrer fields
+        - grouping URL, Icon and Referrer fields
+    * station encoding can now get a "Default" value, to leave the station's
+      encoding empty. This will make it use the default (config) encoding.
+    * all players will use the new station fields
+    * \V will toggle the use of station volume (revert to profile volume)
+    * fixing a couple of minor bugs
+    * updating mpv download link (Windows)
+    * - updating docs
+
 2025-03-21 s-n-g
     * version 0.9.3.11.9 - 0.9.3.12-beta9
     * fixing default station selection in the config window
@@ -1672,18 +1689,20 @@ <h2 id="about-playlist-files">About Playlist files <span style="padding-left: 10
 <ul>
 <li><p>The third column will define the <strong>Encoding</strong> used by the station (more on this at <a href="#specifying-stations-encoding">Specifying stations’ encoding</a>).</p></li>
 <li><p>The fourth column will set an <strong>Icon URL</strong>, to be used when displaying <a href="#desktop-notifications">Desktop Notifications</a>.</p></li>
-<li><p>The fifth column is the <strong>Profile</strong> to be used with this station.</p></li>
+<li><p>The fifth column is the <strong>Profile</strong> to be used with this station.<br />
+<br />
+If a profile is set for the station, a “<strong>[P]</strong>” will be displayed at the left top corner of the window when the station starts playing.</p></li>
 <li><p>The sixth column will determine whether <strong>Buffering</strong> will be used (more on this at <a href="#buffering">Buffering</a>).</p></li>
 <li><p>The seventh column will determine whether the station will be forced to be using <strong>http</strong> instead of https (more on this at <a href="#player-connection-protocol">Player connection protocol</a>).</p></li>
-<li><p>The eight column defines the <strong>Volume</strong> value to be used.</p></li>
+<li><p>The eight column defines the <strong>Volume</strong> value to be used (more on this at <a href="#station-volume">Station volume</a>).</p></li>
 <li><p>The last column will define the <strong>Referer</strong> to be used (more on this at <a href="#specifying-a-stations-referer-url">Specifying a station’s Referer URL</a>).</p></li>
 </ul>
 <p>The following table presents the <strong>Station’s fields</strong> and the current level of support.</p>
 <table>
 <colgroup>
-<col style="width: 20%" />
-<col style="width: 39%" />
-<col style="width: 40%" />
+<col style="width: 24%" />
+<col style="width: 38%" />
+<col style="width: 37%" />
 </colgroup>
 <thead>
 <tr>
@@ -1715,8 +1734,8 @@ <h2 id="about-playlist-files">About Playlist files <span style="padding-left: 10
 </tr>
 <tr>
 <td>Profile</td>
-<td><strong>No</strong></td>
-<td><strong>No</strong></td>
+<td>0.9.3.11.10</td>
+<td>0.9.3.11.10</td>
 </tr>
 <tr>
 <td>Buffering</td>
@@ -1726,17 +1745,17 @@ <h2 id="about-playlist-files">About Playlist files <span style="padding-left: 10
 <tr>
 <td>Force HTTP</td>
 <td>0.9.3.11.6</td>
-<td><strong>No</strong></td>
+<td>0.9.3.11.10</td>
 </tr>
 <tr>
 <td>Volume</td>
-<td><strong>No</strong> for <em>MPV</em> and <em>MPlayer</em></td>
+<td>0.9.3.11.10</td>
 <td>0.9.3.11.5</td>
 </tr>
 <tr>
 <td>Referer URL</td>
 <td>&lt;0.9.3.11.5</td>
-<td><strong>No</strong><br>Using a referer file</td>
+<td>0.9.3.11.10</td>
 </tr>
 </tbody>
 </table>
@@ -2056,6 +2075,22 @@ <h3 id="vlc">VLC</h3>
 <p>In the past, <strong>VLC</strong> would just use any volume setting it had saved from a previous execution, but now it is possible to save the volume it will use when executed by <strong>PyRadio</strong>.</p>
 <p>This means that <strong>VLC</strong> will start and connect to a station, use whatever volume level it’s stored for it and then <strong>PyRadio</strong> will reset the volume to the desired one (as saved within <strong>PyRadio</strong>).</p>
 <p>The volume will be saved is a file called <em>vlc.conf</em> and reside withing the <em>data</em> directory, inside <strong>PyRadio</strong>’s configuration folder.</p>
+<h2 id="station-volume">Station volume <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
+<p>Stations in a playlist can come from various sources, each with its own default volume level. This often results in inconsistent playback volume, forcing the user to adjust <strong>PyRadio</strong>’s volume every time a new station starts.</p>
+<p>While using a volume normalization tool could solve this, it may not always be desirable or feasible.</p>
+<p><strong>PyRadio</strong> offers a better alternative: <em>station volume</em>.</p>
+<p>With this feature, each station can have a specific volume value saved along with its name and URL. When the station is played, that volume is automatically applied.</p>
+<p>Though the user needs to manually set and save the ideal volume for each station (based on their own audio setup), this provides a consistent and reliable solution over time.</p>
+<p>To set a station’s volume, start playing it, adjust the volume to the desired level, and press “<strong>\v</strong>”. This will silently save the updated volume to the playlist on disk.</p>
+<p>If you want to temporarily ignore all station volume settings, press “<strong>\V</strong>”. This will disable volume overrides for the current session only; the setting will reset the next time <strong>PyRadio</strong> is launched.</p>
+<p>When a station’s volume setting is active, a “<strong>[V]</strong>” indicator appears in the top-left corner of the window. If station volume has been disabled, you’ll see “<strong>[v]</strong>” instead. This is illustrated in the image below:</p>
+<p><a href="https://members.hellug.gr/sng/pyradio/station-volume.png" target="_blank"><img style="width: 512px" src="https://members.hellug.gr/sng/pyradio/station-volume.png" alt="PyRadio Station Volume" /></a></p>
+
+<h3 id="how-it-works">How it Works</h3>
+<p>Both <strong>MPV</strong> and <strong>MPlayer</strong> use <em>profiles</em> to configure playback options.</p>
+<p>When station volume is enabled, <strong>PyRadio</strong> creates a temporary profile named <strong>pyradio-volume</strong> by copying the selected base profile. It then updates the volume field in this profile to match the station’s saved volume. This custom profile is then used to launch the player.</p>
+<p>Naturally, this means the player’s user configuration file must be read, parsed, modified, and saved — which may introduce a slight delay, particularly on slower systems.</p>
+<p><strong>VLC</strong>, on the other hand, does not support profiles. In this case, <strong>PyRadio</strong> simply applies the station’s volume directly, overriding the global volume setting.</p>
 <h2 id="buffering">Buffering <span style="padding-left: 10px;"><sup style="font-size: 50%"><a href="#" title="Go to top of the page">Top</a></sup></span></h2>
 <p><strong>PyRadio</strong> provides stream buffering options for all supported players.</p>
 <p>Please refer to this document for more info: <a href="buffering.html">PyRadio Buffering</a>.</p>

docs/index.md

@@ -50,6 +50,8 @@ Command line internet radio player.
     * [MPV](#mpv)
     * [MPlayer](#mplayer)
     * [VLC](#vlc)
+* [Station volume](#station-volume)
+    * [How it Works](#how-it-works)
 * [Buffering](#buffering)
 * [Displaying Station Info](#displaying-station-info)
 * [Copying and pasting - Registers](#copying-and-pasting---registers)
@@ -424,29 +426,31 @@ Optionally, a number of more columns can be used.
 
 - The fourth column will set an **Icon URL**, to be used when displaying [Desktop Notifications](#desktop-notifications).
 
-- The fifth column is the **Profile** to be used with this station.
+- The fifth column is the **Profile** to be used with this station. \
+\
+If a profile is set for the station, a "**[P]**" will be displayed at the left top corner of the window when the station starts playing.
 
 - The sixth column will determine whether **Buffering** will be used (more on this at [Buffering](#buffering)).
 
 - The seventh column will determine whether the station will be forced to be using **http** instead of https (more on this at [Player connection protocol](#player-connection-protocol)).
 
-- The eight column defines the **Volume** value to be used.
+- The eight column defines the **Volume** value to be used (more on this at [Station volume](#station-volume)).
 
 - The last column will define the **Referer** to be used (more on this at [Specifying a station's Referer URL](#specifying-a-stations-referer-url)).
 
 The following table presents the **Station's fields** and the current level of support.
 
-| Station Field   | Takes Effect in Playlist       | Customizable in Program         |
-|-----------------|--------------------------------|---------------------------------|
-| Name            | <0.9.3.11.5                    | <0.9.3.11.5                     |
-| URL             | <0.9.3.11.5                    | <0.9.3.11.5                     |
-| Encoding        | <0.9.3.11.5                    | <0.9.3.11.5                     |
-| Icon            | <0.9.3.11.5                    | <0.9.3.11.5                     |
-| Profile         | **No**                         | **No**                          |
-| Buffering       | 0.9.3.11.8                     | 0.9.3.11.8                      |
-| Force HTTP      | 0.9.3.11.6                     | **No**                          |
-| Volume          | **No** for *MPV* and *MPlayer* | 0.9.3.11.5                      |
-| Referer URL     | <0.9.3.11.5                    | **No**<br>Using a referer file  |
+| Station Field   | Takes Effect in Playlist  | Customizable in Program  |
+|-----------------|---------------------------|--------------------------|
+| Name            | <0.9.3.11.5               | <0.9.3.11.5              |
+| URL             | <0.9.3.11.5               | <0.9.3.11.5              |
+| Encoding        | <0.9.3.11.5               | <0.9.3.11.5              |
+| Icon            | <0.9.3.11.5               | <0.9.3.11.5              |
+| Profile         | 0.9.3.11.10               | 0.9.3.11.10              |
+| Buffering       | 0.9.3.11.8                | 0.9.3.11.8               |
+| Force HTTP      | 0.9.3.11.6                | 0.9.3.11.10              |
+| Volume          | 0.9.3.11.10               | 0.9.3.11.5               |
+| Referer URL     | <0.9.3.11.5               | 0.9.3.11.10              |
 
 
 **PyRadio** will by default load the user's stations file (e.g. *~/.config/pyradio/stations.csv*) to read the stations from. If this file is not found, it will be created and populated with a default set of stations.
@@ -915,6 +919,36 @@ This means that **VLC** will start and connect to a station, use whatever volume
 
 The volume will be saved is a file called *vlc.conf* and reside withing the *data* directory, inside **PyRadio**'s configuration folder.
 
+## Station volume
+
+Stations in a playlist can come from various sources, each with its own default volume level. This often results in inconsistent playback volume, forcing the user to adjust **PyRadio**'s volume every time a new station starts.
+
+While using a volume normalization tool could solve this, it may not always be desirable or feasible.
+
+**PyRadio** offers a better alternative: *station volume*.
+
+With this feature, each station can have a specific volume value saved along with its name and URL. When the station is played, that volume is automatically applied.
+
+Though the user needs to manually set and save the ideal volume for each station (based on their own audio setup), this provides a consistent and reliable solution over time.
+
+To set a station’s volume, start playing it, adjust the volume to the desired level, and press "**\\v**". This will silently save the updated volume to the playlist on disk.
+
+If you want to temporarily ignore all station volume settings, press "**\\V**". This will disable volume overrides for the current session only; the setting will reset the next time **PyRadio** is launched.
+
+When a station’s volume setting is active, a "**[V]**" indicator appears in the top-left corner of the window. If station volume has been disabled, you’ll see "**[v]**" instead. This is illustrated in the image below:
+
+![PyRadio Station Volume](https://members.hellug.gr/sng/pyradio/station-volume.png)
+
+### How it Works
+
+Both **MPV** and **MPlayer** use *profiles* to configure playback options.
+
+When station volume is enabled, **PyRadio** creates a temporary profile named **pyradio-volume** by copying the selected base profile. It then updates the volume field in this profile to match the station’s saved volume. This custom profile is then used to launch the player.
+
+Naturally, this means the player’s user configuration file must be read, parsed, modified, and saved — which may introduce a slight delay, particularly on slower systems.
+
+**VLC**, on the other hand, does not support profiles. In this case, **PyRadio** simply applies the station’s volume directly, overriding the global volume setting.
+
 ## Buffering
 
 **PyRadio** provides stream buffering options for all supported players.