audio: support macOS play pause media key

Author: Alexsatter

README.md

@@ -37,6 +37,8 @@ direct HTTP streams, and YouTube live/videos via `yt-dlp`).
 - **Four themes** — Tokyo Night, Catppuccin Mocha, Gruvbox Dark, Rose
   Pine. Cycle with `t`.
 - **Mini mode** — collapses to ~6 lines for a tmux pane (`m`).
+- **macOS media key** — the hardware Play/Pause key toggles the
+  current station while `lofi-player` is running.
 - **Tmux statusline** — `lofi-player --statusline` prints one colored
   line for `status-right`.
 - **State persistence** — last station, volume, theme, ambient levels
@@ -134,6 +136,7 @@ Quit with `q` or `ctrl+c`.
 | `j` / `↓` | move cursor down |
 | `k` / `↑` | move cursor up |
 | `space` | play / pause selected station |
+| macOS `Play/Pause` | pause / resume the current station |
 | `+` / `=` | volume up (5%) |
 | `-` / `_` | volume down (5%) |
 | `t` | cycle theme |
@@ -146,6 +149,9 @@ Quit with `q` or `ctrl+c`.
 | `?` | toggle full help card |
 | `q` / `ctrl+c` | quit |
 
+The macOS hardware Play/Pause key controls the station already loaded
+in mpv; if no station has been started yet, it is ignored.
+
 ### Ambient mixer (after `x`)
 
 | key | action |

README.ru.md

@@ -39,6 +39,8 @@ TUI-плеер для лофи, чиллхопа и эмбиент-радио 
   Rose Pine. Перебор по `t`.
 - **Mini-режим** — сворачивает UI до ~6 строк, чтобы влезть в
   tmux-панель (`m`).
+- **Media key на macOS** — аппаратная клавиша Play/Pause переключает
+  паузу текущей станции, пока `lofi-player` запущен.
 - **Tmux statusline** — `lofi-player --statusline` печатает одну
   цветную строку для `status-right`.
 - **Сохранение состояния** — последняя станция, громкость, тема,
@@ -138,6 +140,7 @@ lofi-player
 | `j` / `↓` | курсор вниз |
 | `k` / `↑` | курсор вверх |
 | `space` | play / pause выбранной станции |
+| macOS `Play/Pause` | пауза / продолжение текущей станции |
 | `+` / `=` | громкость +5% |
 | `-` / `_` | громкость -5% |
 | `t` | следующая тема |
@@ -150,6 +153,9 @@ lofi-player
 | `?` | показать/скрыть полную справку |
 | `q` / `ctrl+c` | выход |
 
+Аппаратная клавиша Play/Pause на macOS управляет станцией, уже
+загруженной в mpv; если станцию ещё не запускали, нажатие игнорируется.
+
 ### Эмбиент-микшер (после `x`)
 
 | клавиша | действие |

internal/audio/player.go

@@ -9,6 +9,7 @@ import (
 	"os"
 	"os/exec"
 	"path/filepath"
+	"runtime"
 	"strings"
 	"sync"
 	"time"
@@ -124,18 +125,27 @@ type Player struct {
 	lastCacheSec float64
 }
 
+const mainInputConf = "PAUSE cycle pause\n"
+
 func mainMPVArgs(socketPath string) []string {
-	return []string{
+	args := []string{
 		"--no-config",
 		"--idle=yes",
 		"--no-video",
 		"--no-terminal",
 		"--input-ipc-server=" + socketPath,
 	}
+	if runtime.GOOS == "darwin" {
+		args = append(args,
+			"--input-media-keys=yes",
+			"--input-conf="+mainInputConfPath(socketPath),
+		)
+	}
+	return args
 }
 
 func ambientMPVArgs(socketPath, filePath string) []string {
-	return []string{
+	args := []string{
 		"--no-config",
 		"--idle=no",
 		"--no-video",
@@ -144,8 +154,27 @@ func ambientMPVArgs(socketPath, filePath string) []string {
 		"--volume=0",
 		"--pause=yes",
 		"--input-ipc-server=" + socketPath,
-		filePath,
 	}
+	if runtime.GOOS == "darwin" {
+		args = append(args, "--input-media-keys=no")
+	}
+	args = append(args, filePath)
+	return args
+}
+
+func mainInputConfPath(socketPath string) string {
+	return filepath.Join(filepath.Dir(socketPath), "input.conf")
+}
+
+func writeMainInputConf(socketPath string) error {
+	if runtime.GOOS != "darwin" {
+		return nil
+	}
+	path := mainInputConfPath(socketPath)
+	if err := os.WriteFile(path, []byte(mainInputConf), 0o644); err != nil {
+		return fmt.Errorf("write mpv input.conf: %w", err)
+	}
+	return nil
 }
 
 // NewPlayer spawns mpv in idle mode and establishes a JSON-IPC connection
@@ -172,6 +201,10 @@ func NewPlayer(ctx context.Context, opts Options) (*Player, error) {
 		}
 	}
 	socketPath := filepath.Join(socketDir, "mpv.sock")
+	if err := writeMainInputConf(socketPath); err != nil {
+		os.RemoveAll(socketDir)
+		return nil, err
+	}
 
 	var stderr bytes.Buffer
 	cmd := exec.Command(mpvPath, mainMPVArgs(socketPath)...)

internal/audio/player_test.go

@@ -4,7 +4,10 @@ import (
 	"context"
 	"encoding/json"
 	"errors"
+	"os"
 	"os/exec"
+	"path/filepath"
+	"runtime"
 	"strings"
 	"testing"
 	"time"
@@ -200,6 +203,41 @@ func TestMPVArgsDisableUserConfig(t *testing.T) {
 	}
 }
 
+func TestDarwinMPVArgsWireMediaKeys(t *testing.T) {
+	if runtime.GOOS != "darwin" {
+		t.Skip("media-key args are macOS-only")
+	}
+	mainArgs := mainMPVArgs("/tmp/lofi-player-test.sock")
+	if !hasArg(mainArgs, "--input-media-keys=yes") {
+		t.Fatalf("main mpv args %v do not enable media keys", mainArgs)
+	}
+	if !hasArg(mainArgs, "--input-conf=/tmp/input.conf") {
+		t.Fatalf("main mpv args %v do not include media-key input.conf", mainArgs)
+	}
+
+	ambientArgs := ambientMPVArgs("/tmp/lofi-ambient-test.sock", "/tmp/rain.opus")
+	if !hasArg(ambientArgs, "--input-media-keys=no") {
+		t.Fatalf("ambient mpv args %v do not disable media keys", ambientArgs)
+	}
+}
+
+func TestWriteMainInputConf(t *testing.T) {
+	if runtime.GOOS != "darwin" {
+		t.Skip("media-key input.conf is macOS-only")
+	}
+	socketPath := filepath.Join(t.TempDir(), "mpv.sock")
+	if err := writeMainInputConf(socketPath); err != nil {
+		t.Fatalf("writeMainInputConf: %v", err)
+	}
+	data, err := os.ReadFile(mainInputConfPath(socketPath))
+	if err != nil {
+		t.Fatalf("read input.conf: %v", err)
+	}
+	if got := string(data); got != mainInputConf {
+		t.Fatalf("input.conf = %q, want %q", got, mainInputConf)
+	}
+}
+
 func TestFormatMPVStartupErrorIncludesDiagnostics(t *testing.T) {
 	err := formatMPVStartupError(context.DeadlineExceeded, "fatal: bad option\n", []string{"mpv", "--no-config", "--input-ipc-server=/tmp/lofi.sock"})
 	if !errors.Is(err, context.DeadlineExceeded) {

internal/tui/model_test.go

@@ -187,6 +187,18 @@ func TestUpdate_QuitReturnsTeaQuit(t *testing.T) {
 	}
 }
 
+func TestPlaybackStartedWhileIdleDoesNotMarkPlaying(t *testing.T) {
+	m := fixture()
+	if m.playingIdx != -1 {
+		t.Fatalf("fixture playingIdx = %d, want -1", m.playingIdx)
+	}
+	updated, _ := m.Update(PlaybackStartedMsg{})
+	m = updated.(Model)
+	if m.playing || m.loading || !m.playStartedAt.IsZero() {
+		t.Fatalf("idle PlaybackStarted mutated playback state: playing=%v loading=%v started=%v", m.playing, m.loading, m.playStartedAt)
+	}
+}
+
 func TestView_ShowsPlayingMarker(t *testing.T) {
 	m := fixture()
 	m = send(t, m, "space") // dispatch play; model goes into loading state

internal/tui/update.go

@@ -73,6 +73,14 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		return m, waitForEvent(m.player)
 
 	case PlaybackStartedMsg:
+		// mpv can emit pause=false while idle (for example if a hardware
+		// media key is pressed before any station has been loaded). Do not
+		// let that phantom event make the TUI claim something is playing.
+		if m.playingIdx < 0 || m.playingIdx >= len(m.cfg.Stations) {
+			m.playing = false
+			m.loading = false
+			return m, waitForEvent(m.player)
+		}
 		m.playing = true
 		m.loading = false
 		// First start after a fresh Play call: anchor the uptime