Release v4.3: speak status line (Tolk) + Logging tab with housekeeping

- New screen-reader hotkey "Speak the RemSound status information" (issue #13):
  reads the status line aloud through the active screen reader via Tolk, fires from
  anywhere (system-wide), unset by default. Built behind an IScreenReaderOutput seam
  so a future build can swap Tolk for Prism on Windows 10+ without touching callers.
  Tolk DLLs vendored under tolk/ and shipped next to the exe.
- New Logging tab in Preferences: Enable logs + Write logs now moved there, plus
  opt-in startup "warn if logs folder exceeds N MB" and "delete logs older than N days",
  and a "Delete all logs" button (Yes/No confirm). New LogMaintenance helper + AppConfig
  settings drive it.
- Manual (readme.html + regenerated MANUAL.md), About changelog and RELEASE_NOTES
  updated in plain English; csproj <Version> bumped to 4.3.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Ednunp
2026-06-19 13:09:06 +01:00
co-authored by Claude Opus 4.8
parent 034a7de632
commit fd5c31740a
20 changed files with 783 additions and 26 deletions
+23 -4
View File
@@ -740,7 +740,7 @@ Audient USB Audio ASIO Driver &mdash; Pair 3 (channels 5/6): Loop-back 1 (L) / L
<tr><td>Alt+S</td><td>Focus the Connection status read-out</td></tr>
</table>
<p>(The logging controls &mdash; Enable logs and Write logs now &mdash; are in the Preferences dialog; reach it via Options &rarr; Preferences or Ctrl+P, then use Alt+L / Alt+W within the dialog.)</p>
<p>(The logging controls &mdash; Enable logs, Write logs now and the log-folder housekeeping &mdash; are on the Logging tab of the Preferences dialog; reach it via Options &rarr; Preferences or Ctrl+P, then use Alt+L / Alt+W within the dialog.)</p>
<h3>Audio inputs and outputs tab</h3>
<table>
@@ -826,6 +826,7 @@ Audient USB Audio ASIO Driver &mdash; Pair 3 (channels 5/6): Loop-back 1 (L) / L
<tr><td>Send Windows global volume up to peers</td><td>Tell every connected peer to nudge their <em>Windows</em> volume up by one step (about 2%, the same as their keyboard volume key). This affects every app on the receiving computer, not just RemSound. Hold the hotkey down for bigger jumps. See <a href="#remote-control">Remote control</a>.</td><td>Unset</td></tr>
<tr><td>Send Windows global volume down to peers</td><td>The same, but lowering.</td><td>Unset</td></tr>
<tr><td>Send Windows global mute toggle to peers</td><td>Tell every connected peer to toggle their Windows mute.</td><td>Unset</td></tr>
<tr><td>Speak the RemSound status information</td><td>Read the whole status line out loud through your screen reader &mdash; the connection time, how many peers you have, whether sound is flowing, and how healthy the link is &mdash; from anywhere, even with RemSound in the tray. Just for screen-reader users; see <a href="#speak-status">Hearing the status on demand</a> below.</td><td>Unset</td></tr>
</table>
<p>You can change any of these to whatever combination you prefer. Each accepts modifiers (Ctrl, Shift, Alt) plus one ordinary key.</p>
@@ -836,6 +837,14 @@ Audient USB Audio ASIO Driver &mdash; Pair 3 (channels 5/6): Loop-back 1 (L) / L
<p>If RemSound was minimised to the system tray when you pressed the hotkey, it switches the profile and <strong>stays in the tray</strong> &mdash; the window doesn't jump up in front of whatever you're doing. So you can change profiles mid-task without losing your place.</p>
<h3 id="speak-status">Hearing the RemSound status on demand</h3>
<p>The main window has a <strong>status line</strong> that updates every second with how long you've been connected, how many peers you have, whether sound is flowing, and how healthy the connection is. Normally your screen reader reads it like any other text &mdash; but now and then, for reasons that have nothing to do with RemSound, a screen reader loses sight of it and says there's nothing there.</p>
<p>This hotkey is the cure. Give <strong>Speak the RemSound status information</strong> a key in the Keyboard shortcuts dialog, and from then on pressing it reads the whole status line out loud, wherever you are &mdash; even when RemSound is tucked away in the tray or another program is in front. It's unset to start with, so the key is yours to choose.</p>
<p>This one is just for screen-reader users: it talks straight through your screen reader. It works with the screen readers RemSound's speech helper supports &mdash; <strong>NVDA</strong>, JAWS, Window-Eyes, System Access, SuperNova and ZoomText &mdash; and falls back to Windows' own built-in speech if none of those is running. If you don't use a screen reader, just leave this one unset.</p>
<h3>Your screen reader reads out the hotkeys</h3>
<p>Once a hotkey is set, your screen reader reads it out whenever you land on the menu item or control it's tied to &mdash; for example, moving onto <strong>File &rarr; Open profile</strong> announces &ldquo;Ctrl+O&rdquo;, and a control with a global hotkey announces &ldquo;press [your key] anywhere&rdquo;. So you can learn and confirm your shortcuts just by arrowing around the window, without coming back to this dialog.</p>
@@ -1010,7 +1019,7 @@ Use whatever key combinations you prefer (for example Ctrl+Shift+Up / Ctrl+Shift
<h3>Settings in Preferences</h3>
<p>Open <strong>Options &rarr; Preferences</strong> (or Ctrl+P). The update settings sit just above the logging row:</p>
<p>Open <strong>Options &rarr; Preferences</strong> (or Ctrl+P) and go to the <strong>Update settings</strong> tab:</p>
<table>
<tr><th>Setting</th><th>Shortcut</th><th>What it does</th></tr>
@@ -1135,7 +1144,7 @@ Use whatever key combinations you prefer (for example Ctrl+Shift+Up / Ctrl+Shift
<h2 id="logs">21. Logs and diagnostics</h2>
<p>If logging is turned on (the <strong>Enable logs</strong> checkbox in the Preferences dialog &mdash; Options &rarr; Preferences, or Ctrl+P &mdash; on by default), RemSound writes a log file each session into a <code>logs</code> folder inside <strong>user settings and logs</strong> &mdash; the same folder your settings and profiles live in. One file per launch.</p>
<p>Everything to do with logging lives on its own <strong>Logging</strong> tab in the Preferences dialog (Options &rarr; Preferences, or Ctrl+P). If logging is turned on (the <strong>Enable logs</strong> checkbox there, on by default), RemSound writes a log file each session into a <code>logs</code> folder inside <strong>user settings and logs</strong> &mdash; the same folder your settings and profiles live in. One file per launch.</p>
<p>The file contains two kinds of rows:</p>
@@ -1145,7 +1154,17 @@ Use whatever key combinations you prefer (for example Ctrl+Shift+Up / Ctrl+Shift
<tr><td>SNAP</td><td>One-second snapshots of running figures: codec, latency target, how much sound is buffered, packets sent, packets received, drop-outs, drops, and peer round-trip times.</td></tr>
</table>
<p>The <strong>Write logs now</strong> button in the Preferences dialog (Alt+W within that dialog) writes a &ldquo;user requested write logs now&rdquo; marker into the log, so you can find that moment in the file afterwards.</p>
<p>The <strong>Write logs now</strong> button on the Logging tab (Alt+W within the dialog) writes a &ldquo;user requested write logs now&rdquo; marker into the log, so you can find that moment in the file afterwards.</p>
<h3>Keeping the logs folder tidy</h3>
<p>Log files are small, but if you leave logging on for months they add up. The <strong>Logging</strong> tab has three ways to keep the folder under control, all switched off to begin with so nothing is ever deleted unless you ask for it:</p>
<ul>
<li><strong>Warn at startup if the logs folder is larger than&hellip; megabytes</strong> (Alt+S) &mdash; tick this and pick a size, and the next time RemSound starts it checks the folder and pops up a friendly notice if it has grown past that size. It only warns; it never deletes anything itself. The size box (Alt+M) starts at 100 megabytes and stays greyed out until you tick the box.</li>
<li><strong>Delete logs older than&hellip; days old</strong> (Alt+D) &mdash; tick this and pick a number of days, from 1 to 30, and each time RemSound starts it quietly clears out any log older than that. The log it's writing right now is never touched. The days box (Alt+Y) starts at 14 and stays greyed out until you tick the box.</li>
<li><strong>Delete all logs</strong> (Alt+A) &mdash; a button that clears out every log file in one go. It asks you to confirm first, Yes or No, then tells you how many it removed. Again, the log RemSound is writing right now is kept; everything else goes.</li>
</ul>
<p>Logs are plain text and can be opened in any text editor, or in a spreadsheet. The most useful figures when something feels wrong:</p>
<ul>