agentvibes 5.7.4 → 5.7.6

package/.claude/hooks/play-tts-ssh-remote.sh

@@ -17,6 +17,7 @@ set -euo pipefail
 TEXT="${1:-}"
 VOICE="${2:-en_US-lessac-medium}"
 AGENT_NAME="${3:-default}"
+AGENT_PROFILE_FILE="${4:-}"
 
 # LLM identity — forwarded to the remote so it can look up its own
 # audio-effects.cfg llm:<name> row for voice, reverb, music, pretext, engine.
@@ -150,12 +151,23 @@ SOX_EFFECTS=""
 BG_FILE=""
 BG_VOLUME="0.10"
 
-EFFECTS_CFG="$PROJECT_ROOT/.claude/config/audio-effects.cfg"
+# Use CLAUDE_PROJECT_DIR (injected via --project-dir by play-tts.sh) so the
+# agent-name / default row is read from the user's project, not the package.
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" && -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
+  EFFECTS_CFG="$CLAUDE_PROJECT_DIR/.claude/config/audio-effects.cfg"
+else
+  EFFECTS_CFG="$PROJECT_ROOT/.claude/config/audio-effects.cfg"
+fi
 if [[ -f "$EFFECTS_CFG" ]]; then
-  CONFIG_LINE=$(grep "^${AGENT_NAME}|" "$EFFECTS_CFG" 2>/dev/null || \
-                grep "^default|" "$EFFECTS_CFG" 2>/dev/null || true)
+  # awk exact field-1 match — no regex injection risk from AGENT_NAME
+  CONFIG_LINE=$(awk -F'|' -v k="${AGENT_NAME}" '$1==k{print;exit}' "$EFFECTS_CFG" 2>/dev/null || true)
+  [[ -z "$CONFIG_LINE" ]] && \
+    CONFIG_LINE=$(awk -F'|' '$1=="default"{print;exit}' "$EFFECTS_CFG" 2>/dev/null || true)
   if [[ -n "$CONFIG_LINE" ]]; then
     IFS='|' read -r _ SOX_EFFECTS BG_FILE BG_VOLUME <<< "$CONFIG_LINE"
+    SOX_EFFECTS="${SOX_EFFECTS## }"; SOX_EFFECTS="${SOX_EFFECTS%% }"
+    BG_FILE="${BG_FILE## }"; BG_FILE="${BG_FILE%% }"
+    BG_VOLUME="${BG_VOLUME## }"; BG_VOLUME="${BG_VOLUME%% }"
   fi
 fi
 
@@ -171,14 +183,18 @@ LLM_REVERB=""
 LLM_BG_FILE=""
 LLM_BG_VOLUME=""
 
-# Build config search path: CLAUDE_PROJECT_DIR first (the actual user project,
-# even when hooks run from the package dir), then PROJECT_ROOT (may be the
-# same or the package dir), then global home fallback.
+# Build config search path for LLM-specific row lookup.
+# Priority: CLAUDE_PROJECT_DIR (real user project) → global HOME fallback.
+# PROJECT_ROOT is intentionally excluded when CLAUDE_PROJECT_DIR is set and
+# different — prevents the AgentVibes package's own audio-effects.cfg from
+# bleeding into a user project that doesn't define its own llm: row.
 _llm_cfg_paths=()
 if [[ -n "${CLAUDE_PROJECT_DIR:-}" && "$CLAUDE_PROJECT_DIR" != "$PROJECT_ROOT" ]]; then
   _llm_cfg_paths+=("$CLAUDE_PROJECT_DIR/.claude/config/audio-effects.cfg")
+else
+  _llm_cfg_paths+=("$PROJECT_ROOT/.claude/config/audio-effects.cfg")
 fi
-_llm_cfg_paths+=("$PROJECT_ROOT/.claude/config/audio-effects.cfg" "$HOME/.claude/config/audio-effects.cfg")
+_llm_cfg_paths+=("$HOME/.claude/config/audio-effects.cfg")
 
 _llm_key="llm:${LLM_NAME}"
 _llm_row_found=0
@@ -210,7 +226,24 @@ done
 [[ -n "$LLM_BG_FILE"   ]] && BG_FILE="$LLM_BG_FILE"
 [[ -n "$LLM_BG_VOLUME" ]] && BG_VOLUME="$LLM_BG_VOLUME"
 
-# Read pretext if configured
+# Per-agent profile (written by bmad-speak.sh) takes highest priority for music
+if [[ -n "$AGENT_PROFILE_FILE" ]] && [[ -f "$AGENT_PROFILE_FILE" ]]; then
+  _prof_track=$(_AV_PROF="$AGENT_PROFILE_FILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._AV_PROF,'utf8'));process.stdout.write(p.backgroundMusic?.track??'')}catch{process.stdout.write('')}" 2>/dev/null || true)
+  _prof_vol=$(_AV_PROF="$AGENT_PROFILE_FILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._AV_PROF,'utf8'));process.stdout.write(String(p.backgroundMusic?.volume??''))}catch{process.stdout.write('')}" 2>/dev/null || true)
+  _prof_enabled=$(_AV_PROF="$AGENT_PROFILE_FILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._AV_PROF,'utf8'));process.stdout.write(String(p.backgroundMusic?.enabled??''))}catch{process.stdout.write('')}" 2>/dev/null || true)
+  if [[ "$_prof_enabled" == "true" ]] && [[ -n "$_prof_track" ]]; then
+    BG_FILE="$_prof_track"
+    if [[ "$_prof_vol" =~ ^[0-9]+$ ]]; then
+      BG_VOLUME=$(awk "BEGIN{printf \"%.2f\", ${_prof_vol}/100}")
+    fi
+  fi
+fi
+
+# PRETEXT is NOT extracted from the llm row here.
+# play-tts.sh already prepends the llm row's pretext to TEXT before calling this script.
+# Extracting it again and sending it as a separate JSON field would cause the receiver
+# to prepend it a second time — the user hears the intro text twice.
+# PRETEXT here is only for the (rare) pretext.txt override file, not the llm row.
 PRETEXT=""
 PRETEXT_FILE="$PROJECT_ROOT/.agentvibes/config/pretext.txt"
 if [[ -f "$PRETEXT_FILE" ]]; then
@@ -265,9 +298,9 @@ build_json_payload() {
       --arg llm "$LLM_NAME" \
       '{text: $text, voice: $voice, effects: $effects, music: $music, volume: $volume, project: $project, pretext: $pretext, speed: $speed, provider: $provider, llm: $llm}'
   else
-    # Manual JSON — escape double quotes and backslashes in text
+    # Manual JSON — escape backslashes, quotes, control chars
     local escaped_text
-    escaped_text=$(printf '%s' "$TEXT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g')
+    escaped_text=$(printf '%s' "$TEXT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g' | tr '\n' ' ' | sed 's/\r//g')
     local escaped_pretext
     escaped_pretext=$(printf '%s' "$PRETEXT" | sed 's/\\/\\\\/g; s/"/\\"/g')
     printf '{"text":"%s","voice":"%s","effects":"%s","music":"%s","volume":"%s","project":"%s","pretext":"%s","speed":"%s","provider":"%s","llm":"%s"}' \
@@ -289,6 +322,13 @@ fi
 # Send to receiver via SSH (fire and forget — backgrounded)
 # ---------------------------------------------------------------------------
 
+# In test mode, dump the decoded payload to stdout so tests can inspect it
+# without needing a real SSH connection or a mock binary.
+if [[ "${AGENTVIBES_TEST_MODE:-false}" == "true" ]]; then
+  echo "$JSON_PAYLOAD"
+  exit 0
+fi
+
 echo "Sending to $SSH_HOST..." >&2
 
 # Build SSH args — use explicit key/port from config if available, else rely on ~/.ssh/config

package/.claude/hooks/play-tts.sh

@@ -367,7 +367,7 @@ speak_text() {
       bash "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$text" "$voice"
       ;;
     ssh-remote)
-      bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$text" "$voice"
+      bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$text" "$voice" "" "${profile_file:-}"
       ;;
     agentvibes-receiver)
       bash "$SCRIPT_DIR/play-tts-agentvibes-receiver-for-voiceless-connections.sh" "$text" "$voice"
@@ -497,7 +497,7 @@ case "$ACTIVE_PROVIDER" in
     exec bash "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;
   ssh-remote)
-    exec bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$TEXT" "$VOICE_OVERRIDE"
+    exec bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$TEXT" "$VOICE_OVERRIDE" "" "${AGENT_PROFILE_FILE:-}"
     ;;
   agentvibes-receiver)
     exec bash "$SCRIPT_DIR/play-tts-agentvibes-receiver-for-voiceless-connections.sh" "$TEXT" "$VOICE_OVERRIDE"

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.7.4
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.7.6
 
 ---
 
@@ -40,7 +40,19 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Ter
 
 ---
 
-## 🌟 NEW IN v5.7.0 — BMAD v6.6 Support + Windows Auto-Restart Watcher
+## 🌟 NEW IN v5.7.6 — SSH Remote Payload Integrity + Receiver Rewrite
+
+**SSH remote music/voice fix:** The correct project music track and voice now reach the remote receiver — previously the global config was used instead of the active project's settings.
+
+**Bash receiver rewrite:** The Linux/Termux `agentvibes-receiver.sh` has been fully rewritten to decode the current base64 JSON payload format. The old positional-arg format from pre-v5.5 is gone.
+
+**No more double intro:** The personality pretext (e.g., "Bcs latin dance here") is no longer spoken twice over SSH remote. `play-tts.sh` prepends it to the text; the receiver no longer gets a separate pretext field to prepend again.
+
+**SSH host visible in TUI:** The Settings and Voices tabs now display your configured SSH remote host alias.
+
+**Security fixes** and 24 new BATS tests covering the full sender → receiver round-trip.
+
+## v5.7.5 — TUI Button Contrast + BMAD Routing Fixes
 
 **BMAD v6.6.0:** AgentVibes now detects the new `.claude/skills/*/agents/` agent structure, correctly handles globally-installed BMAD at `~/_bmad`, and gracefully skips v6.6+ plain-Markdown agents during TTS injection instead of erroring. The BMAD tab now shows detection correctly for global installs.
 
@@ -341,7 +353,7 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 
 ## 📰 Latest Release
 
-**[v3.6.0 - "Voice Explorer" Release](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.6.0)** 🎉
+**[v3.6.0 - "Voice Explorer" Release](https://github.com/paulpreibisch/AgentVibes/releases/tag/v5.7.5)** 🎉
 
 ### 🎤 Voices Tab — Browse & Sample 914 Voices
 

package/RELEASE_NOTES.md

@@ -1,5 +1,72 @@
 # AgentVibes Release Notes
 
+## 🔧 v5.7.6 — SSH Remote Payload Integrity + Receiver Rewrite
+
+**Released:** 2026-05-16
+
+### 🐛 SSH Remote Playing Wrong Music and Voice
+
+When using the SSH remote TTS feature, the wrong project's music track and voice were being applied. Root cause: `CLAUDE_PROJECT_DIR` was not forwarded to the sender, causing it to fall back to the global config instead of the active project's `audio-effects.cfg`.
+
+### 🐛 Bash Receiver Incompatible with JSON Payload Format
+
+The Linux/Termux bash receiver (`agentvibes-receiver.sh`) was using a positional-argument format from pre-v5.5 and could not decode the current base64 JSON payload at all. The receiver has been fully rewritten to match the PowerShell receiver's logic: decodes base64, parses JSON, applies voice/music/effects/volume, and validates all fields.
+
+### 🐛 Personality Intro Heard Twice on Remote
+
+The personality pretext (e.g., "Bcs latin dance here") was being spoken twice when using SSH remote TTS. Root cause: `play-tts.sh` already prepends the pretext to the speech text before calling the sender; the sender was also packing it into the JSON `pretext` field, causing the receiver to prepend it again. The `pretext` JSON field is now intentionally left empty — the personality is delivered via the `text` field only.
+
+### 🆕 SSH Host Alias Visible in Settings Tab
+
+The configured SSH remote host alias is now displayed in the Settings and Voices tabs so users can confirm which remote machine TTS is targeting without opening config files.
+
+### 🔒 Security Fixes
+
+Input validation improvements in the SSH remote sender and receiver.
+
+### 🧪 24 New BATS Tests
+
+- 15 SSH remote payload tests: verify voice, music track, volume, reverb/effects, pretext handling, LLM identifier, project config precedence, and JSON validity
+- 9 end-to-end round-trip tests: sender builds payload → receiver decodes and applies all fields simultaneously, catching regressions in either end
+
+---
+
+## 🖥️ v5.7.5 — TUI Button Contrast + BMAD Routing Fixes
+
+**Released:** 2026-05-13
+
+### 🐛 TUI Button Focus: Grey Text Eliminated Across All Terminals
+
+Focused and selected buttons in the TUI (voices, music, settings, setup tabs) displayed light grey text on light-blue backgrounds in many terminals. Root cause: `bold: true` combined with a dark foreground triggers terminal "bright mode," rendering the color as grey regardless of shade.
+
+**Fix:** All button focus states now use **white text on dark green (`#2e7d32`) background** — the same high-contrast pattern already used by the Agents tab. Explicit `focus`/`blur` handlers were added to setup-tab modal buttons to prevent `attachBtnBlink` from interfering with blessed's passive `style.focus` color application.
+
+### 🐛 BMAD Tab Voice Picker ♪ Indicator Not Showing
+
+The ♪ preview indicator in the BMAD tab voice list didn't appear during preview. The Agents tab was missing `_refreshVP()` calls that the Settings tab already had. A 2-second minimum display timer now keeps the indicator visible when SSH-remote exits immediately (fire-and-forget mode).
+
+### 🐛 Non-Interactive Install: Generic Pretext Instead of Project Name
+
+Running `agentvibes install` non-interactively always set the pretext to `"Claude Code here"` regardless of project. The installer now derives a project-aware pretext from `path.basename(process.cwd())` with capitalization (e.g., `"MyProject here"`), with a safe fallback for Docker root paths.
+
+### 🐛 Global Pretext Overriding Per-Project Config
+
+`seedAllLlmDefaultsSync` was seeding project-level LLM rows with the global pretext string, causing the global `"Claude Code here"` to override per-project `tts-pretext.txt` values. Project-level rows are now seeded with empty pretexts so the per-project file takes precedence.
+
+### 🐛 `screen`/`tmux` TERM Variant Caused `plab_norm` Capability Error
+
+When `TERM` was set to a `screen-*` or `tmux-*` variant, blessed threw a `plab_norm` terminal capability error on startup. The app now overrides `TERM` to `xterm-256color` before creating the blessed screen when such a variant is detected.
+
+### 🐛 BMAD Per-Agent Music/Reverb Not Reaching SSH Receiver
+
+`play-tts.sh` was not forwarding `AGENT_PROFILE_FILE` to the SSH remote transport, so per-agent background music and reverb overrides in the BMAD tab were silently ignored for remote audio. The profile file path is now passed as argument 4 to `play-tts-ssh-remote.sh`.
+
+### 🐛 Node 18 Compatibility: `import.meta.dirname` Replaced
+
+A test file used `import.meta.dirname`, available only in Node 21+. Replaced with the `fileURLToPath(import.meta.url)` pattern so tests run correctly on Node 18 and 20.
+
+---
+
 ## 🎭 v5.7.0 — BMAD v6.6 Support + Windows Auto-Restart Watcher
 
 **Released:** 2026-05-11

package/mcp-server/WINDOWS_SETUP.md

@@ -121,7 +121,7 @@ Now we'll tell Claude Desktop to use AgentVibes.
        "mcpServers": {
          "agentvibes": {
            "command": "npx",
-           "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"]
+           "args": ["-y", "-p", "agentvibes@beta", "agentvibes-mcp-server"]
          }
        }
      }

package/mcp-server/docs/troubleshooting-audio.md

@@ -270,7 +270,7 @@ Your config file has syntax errors:
      "mcpServers": {
        "agentvibes": {
          "command": "npx",
-         "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"]
+         "args": ["-y", "-p", "agentvibes@beta", "agentvibes-mcp-server"]
        }
      }
    }

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "5.7.4",
+  "version": "5.7.6",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code, Claude Desktop (via MCP), and Clawdbot with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [

package/src/console/app.js

@@ -138,7 +138,14 @@ export class AgentVibesConsole {
       return;
     }
 
+    // blessed's terminfo parser chokes on screen-256color's plab_norm capability.
+    // xterm-256color is functionally identical for our TUI and parses cleanly.
+    const _origTerm = process.env.TERM;
+    if (/^(screen|tmux)(-256color)?$/.test(process.env.TERM || '')) {
+      process.env.TERM = 'xterm-256color';
+    }
     this.screen = blessed.screen(this._screenOptions);
+    if (_origTerm !== undefined) process.env.TERM = _origTerm;
 
     // Reflow on terminal resize
     this.screen.on('resize', () => this.screen.render());

package/src/console/audio-env.js

@@ -163,3 +163,22 @@ export function detectWavPlayer(env) {
   }
   return _detect(WAV_PLAYERS, env);
 }
+
+/**
+ * Returns all installed WAV players in preference order.
+ * Used for fallback playback — try each until one succeeds.
+ * On Windows, always appends the PowerShell fallback.
+ *
+ * @param {Object} [env] - Environment (defaults to buildAudioEnv())
+ * @returns {Player[]}
+ */
+export function getAllWavPlayers(env) {
+  env = env || buildAudioEnv();
+  const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+  const installed = WAV_PLAYERS.filter(p => {
+    const r = spawnSync(whichCmd, [p.bin], { stdio: 'pipe', env });
+    return r.status === 0;
+  });
+  if (process.platform === 'win32') installed.push(WIN_WAV_PLAYER);
+  return installed;
+}

package/src/console/tabs/agents-tab.js

@@ -367,7 +367,7 @@ ${_tl('bmadDesc')}
       padding: { left: 1, right: 1 },
       style: {
         bg: COLORS.btnDefault,
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },
@@ -711,7 +711,7 @@ ${_tl('bmadDesc')}
         padding: { left: 1, right: 1 },
         style: {
           bg: COLORS.btnDefault,
-          fg: 'white',
+          fg: 'bright-white',
           focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
           hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         },
@@ -1139,8 +1139,6 @@ ${_tl('bmadDesc')}
     const inputBox = blessed.textbox({
       parent: editModal, top: 3, left: 2, right: 2, height: 3,
       border: { type: 'line' },
-      inputOnFocus: true,
-      value: draft.pretext,
       style: {
         fg: COLORS.valueFg, bg: '#0d1b35',
         border: { fg: COLORS.borderFg },
@@ -1149,22 +1147,78 @@ ${_tl('bmadDesc')}
     });
 
     let _editClosed = false;
+    let _cursor = draft.pretext.length;
+    inputBox.value = draft.pretext;
+
+    function _renderPretext() {
+      const val = inputBox.value;
+      const lpos = inputBox._getCoords();
+      if (!lpos) { screen.render(); return; }
+      const contentWidth = Math.max(1, (lpos.xl - lpos.xi) - inputBox.iwidth);
+      const start = _cursor > contentWidth - 1 ? _cursor - contentWidth + 1 : 0;
+      inputBox.setContent(val.slice(start));
+      screen.render();
+      screen.program.cup(lpos.yi + inputBox.itop, lpos.xi + inputBox.ileft + (_cursor - start));
+    }
+
+    const _prevGrabKeys = screen.grabKeys;
     function _closeEdit(save) {
       if (_editClosed) return;
       _editClosed = true;
+      inputBox.removeAllListeners('keypress');
+      screen.grabKeys = _prevGrabKeys;
+      screen.program.hideCursor();
       if (save) {
-        const raw = inputBox.getValue().trim();
-        // M7: enforce max pretext length
-        draft.pretext = (raw || draft.pretext).slice(0, MAX_PRETEXT_LENGTH);
+        // M7: enforce max pretext length; allow clearing to empty string
+        draft.pretext = inputBox.value.trim().slice(0, MAX_PRETEXT_LENGTH);
       }
       destroyList(editModal, screen, onDone);
     }
 
-    inputBox.key(['enter'], () => _closeEdit(true));
-    inputBox.key(['escape'], () => _closeEdit(false));
+    // Guard: if editModal is destroyed externally (parent closed, signal, etc.)
+    // without _closeEdit being called, restore grab state so TUI stays responsive.
+    editModal.once('destroy', () => {
+      if (!_editClosed) {
+        _editClosed = true;
+        inputBox.removeAllListeners('keypress');
+        screen.grabKeys = _prevGrabKeys;
+        screen.program.hideCursor();
+      }
+    });
 
+    screen.grabKeys = true;
     inputBox.focus();
-    screen.render();
+    screen.render(); // Layout pass so _getCoords() returns valid coords on first _renderPretext
+    screen.program.showCursor();
+    _renderPretext();
+
+    inputBox.on('keypress', function(ch, key) {
+      if (_editClosed) return;
+      const val = inputBox.value;
+      if (key.name === 'enter') { _closeEdit(true); return; }
+      if (key.name === 'escape') { _closeEdit(false); return; }
+      if (key.name === 'home' || (key.ctrl && key.name === 'a')) {
+        _cursor = 0;
+      } else if (key.name === 'end' || (key.ctrl && key.name === 'e')) {
+        _cursor = val.length;
+      } else if (key.name === 'left') {
+        if (_cursor > 0) _cursor--; else return;
+      } else if (key.name === 'right') {
+        if (_cursor < val.length) _cursor++; else return;
+      } else if (key.name === 'backspace') {
+        if (_cursor > 0) { inputBox.value = val.slice(0, _cursor - 1) + val.slice(_cursor); _cursor--; }
+        else return;
+      } else if (key.name === 'delete') {
+        if (_cursor < val.length) { inputBox.value = val.slice(0, _cursor) + val.slice(_cursor + 1); }
+        else return;
+      } else if (ch && !key.ctrl && !key.meta && !/^[\x00-\x08\x0b-\x0c\x0e-\x1f\x7f]$/.test(ch)) {
+        inputBox.value = val.slice(0, _cursor) + ch + val.slice(_cursor);
+        _cursor++;
+      } else {
+        return;
+      }
+      _renderPretext();
+    });
   }
 
   // -------------------------------------------------------------------------

package/src/console/tabs/music-tab.js

@@ -409,7 +409,7 @@ export function createMusicTab(screen, services) {
       padding: { left: 1, right: 1 },
       style: {
         bg: COLORS.btnDefault,
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },
@@ -423,7 +423,7 @@ export function createMusicTab(screen, services) {
     });
     btn.on('blur', () => {
       btn.style.bg = COLORS.btnDefault;
-      btn.style.fg = 'white';
+      btn.style.fg = 'bright-white';
       const raw = btn.content.replace(/[►◄]/g, '').trim();
       btn.setContent(raw);
       screen.render();
@@ -776,7 +776,7 @@ export function createMusicTab(screen, services) {
         padding: { left: 1, right: 1 },
         style: {
           bg,
-          fg: 'white',
+          fg: 'bright-white',
           focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
           hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         },
@@ -819,7 +819,7 @@ export function createMusicTab(screen, services) {
       padding: { left: 1, right: 1 },
       style: {
         bg: '#e65100',
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },

package/src/console/tabs/settings-tab.js

@@ -201,6 +201,15 @@ export function createSettingsTab(screen, services) {
       },
       desc: 'Play audio locally or stream to a remote host via SSH',
     },
+    {
+      key: 'sshAlias',
+      label: 'SSH Host Alias',
+      getValue: () => {
+        const alias = configService?.getConfig?.()?.audio_ssh_alias ?? '';
+        return alias || '(not set)';
+      },
+      desc: 'SSH host alias from ~/.ssh/config used when Audio Destination is Remote',
+    },
     {
       key: 'configStorage',
       label: 'Config Storage',
@@ -395,6 +404,9 @@ export function createSettingsTab(screen, services) {
       case 'audioDst':
         _editAudioDst();
         break;
+      case 'sshAlias':
+        _editSshAlias();
+        break;
       case 'rerunWizard':
         _rerunWizard();
         break;
@@ -583,7 +595,7 @@ export function createSettingsTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'blue' },
-        selected: { bg: 'green', fg: 'white', bold: true },
+        selected: { bg: 'green', fg: 'black', bold: true },
         item: { fg: COLORS.labelFg },
       },
     });
@@ -864,6 +876,68 @@ export function createSettingsTab(screen, services) {
     screen.render();
   }
 
+  // ── SSH alias editor ─────────────────────────────────────────────────────
+
+  function _editSshAlias() {
+    navigationService?.openModal();
+
+    const aliases = _detectSshAliases().filter(a => !a.includes('github.com'));
+    const MANUAL_OPTION = '  Type manually...';
+    const items = [...aliases.map(a => `  ${a}`), MANUAL_OPTION];
+    const currentAlias = configService?.getConfig?.()?.audio_ssh_alias ?? '';
+
+    const listHeight = Math.min(items.length + 4, 18);
+    const modal = blessed.list({
+      parent: screen,
+      top: 'center',
+      left: 'center',
+      width: 44,
+      height: listHeight,
+      border: { type: 'line' },
+      tags: true,
+      label: ' {bold}{cyan-fg} Select SSH Host Alias {/cyan-fg}{/bold} ',
+      keys: true,
+      vi: true,
+      mouse: true,
+      style: {
+        fg: COLORS.labelFg,
+        bg: COLORS.contentBg,
+        border: { fg: 'cyan' },
+        selected: { bg: 'blue', fg: 'yellow' },
+        item: { fg: COLORS.labelFg },
+      },
+    });
+    modal.setFront();
+    modal.setItems(items);
+
+    const currentIdx = aliases.indexOf(currentAlias);
+    if (currentIdx >= 0) modal.select(currentIdx);
+
+    modal.key(['enter'], () => {
+      const selItem = items[modal.selected];
+      if (selItem === MANUAL_OPTION) {
+        _closeModal();
+        _promptSshAlias();
+        return;
+      }
+      const alias = selItem?.trim();
+      if (alias) configService.set('audio_ssh_alias', alias);
+      _closeModal();
+    });
+    modal.key(['escape', 'q'], _closeModal);
+
+    function _closeModal() {
+      navigationService?.closeModal();
+      destroyList(modal, screen);
+      _refreshValues();
+      box.focus();
+      screen.render();
+    }
+
+    modal.focus();
+    screen.render();
+  }
+
   // ── Re-run wizard ────────────────────────────────────────────────────────
 
   function _rerunWizard() {