在ncspot中实现当前播放歌曲快速保存的技术方案

背景介绍

ncspot作为一款终端音乐播放器，其TUI界面操作逻辑与远程控制功能存在一些行为差异。用户在使用过程中发现，通过TUI界面保存歌曲时需要先选中目标曲目，而通过IPC套接字却能直接保存当前播放曲目，这为自动化操作提供了可能。

技术实现原理

IPC套接字控制机制

ncspot提供了基于Unix域套接字的IPC控制接口，允许用户通过发送文本命令来控制运行中的实例。该接口支持多种操作指令，其中save命令具有特殊的行为特性：

1. 当不带参数使用时，默认保存当前播放曲目
2. 支持save current显式指定保存当前曲目
3. 与TUI界面中的s快捷键（保存选中曲目）形成功能互补

自动化脚本实现

通过结合netcat工具和jq处理器，可以构建完整的自动化保存方案：

#!/usr/bin/env bash
# 保存当前播放曲目并显示通知
echo "save" | nc -W 1 -U /run/user/1000/ncspot/ncspot.sock
response=$(nc -W 1 -U /run/user/1000/ncspot/ncspot.sock)
title=$(echo "$response" | jq -r '.playable.title')
artist=$(echo "$response" | jq -r '.playable.artists[0]')
cover_url=$(echo "$response" | jq -r '.playable.cover_url')

# 下载专辑封面
cover_path="/tmp/album_cover.jpg"
curl -s -o "$cover_path" "$cover_url"

# 发送带封面的系统通知
notify-send --app-name="NCSPOT" -i "$cover_path" "歌曲已保存" "$title - $artist"

方案优势

1. 无需切换焦点：完全在后台运行，不影响当前工作流程
2. 即时反馈：通过系统通知显示保存结果
3. 可视化体验：自动获取并显示专辑封面
4. 扩展性强：可轻松集成到各类自动化工作流中

技术细节说明

1. 套接字路径：可通过ncspot info命令查询实际套接字位置
2. 超时设置：-W 1参数确保netcat在1秒后超时退出
3. JSON处理：使用jq解析播放器返回的JSON数据
4. 封面缓存：将封面临时保存在/tmp目录，避免重复下载

应用场景建议

1. 绑定到全局快捷键实现一键保存
2. 结合tmux会话实现后台运行
3. 集成到状态栏工具显示最近保存记录
4. 扩展为自动化收藏管理系统

此方案充分利用了ncspot的IPC接口特性，通过简单的shell脚本实现了专业级的音乐收藏管理功能，展现了终端工具的灵活性和可扩展性优势。