audio-play

star 1

KDE Plasma / PipeWire(PulseAudio互換) 環境で通知音・効果音・テストトーン・VOICEVOX発話（VOICEBOX表記の依頼含む）などの音声を確実に再生する。ユーザーが『通知音を鳴らして』『音を出して確認して』『VOICEVOXで喋らせて』など依頼したときに使う。

yuiseki By yuiseki schedule Updated 2/25/2026
play_arrow Run Skill in Manus View GitHub

name: audio-play description: "KDE Plasma / PipeWire(PulseAudio互換) 環境で通知音・効果音・テストトーン・VOICEVOX発話（VOICEBOX表記の依頼含む）などの音声を確実に再生する。ユーザーが『通知音を鳴らして』『音を出して確認して』『VOICEVOXで喋らせて』など依頼したときに使う。"

audio-play Skill

KDE Plasma デスクトップ上で音を再生するためのスキルです。notify-send の通知表示だけでなく、paplay / pw-play / canberra-gtk-play / VOICEVOX API を使った再生まで扱います。

この環境では「通知は出るが音が聞こえない」問題が起きやすいため、音の出力先（sink）を明示して検証するのが基本です。

前提

  • デスクトップ: KDE Plasma（X11, 通常 DISPLAY=:1）
  • 音声基盤: PipeWire（PulseAudio 互換）
  • よく使うコマンド:
    • pactl, wpctl
    • paplay（最優先）
    • notify-send
    • canberra-gtk-play（通知風効果音）
    • pw-play（代替）
    • curl（VOICEVOX API）

重要ルール

  • まず 音の経路確認を行う（pactl info, pactl list short sinks）
  • 重要な再生は paplay --device=<sink> で sink を明示する
  • notify-send 単体で「通知音が鳴る」と期待しない
    • 通知表示はできても、音は別コマンドが必要なことがある
  • canberra-gtk-play は DISPLAY が必要（DISPLAY=:1）
  • paplay 系は DISPLAY 不要だが、XDG_RUNTIME_DIR が必要なことがある
  • 「聞こえない」ときは、短い効果音より 長めのテストトーンで切り分ける

典型ユースケース

  • notify-send の代わりにちゃんと聞こえる通知音を鳴らして
  • いま音が出るか確認して
  • VOICEVOX で「作業が終わりました」と喋らせて
  • VacuumTube と同じ出力先（テレビ）に音を出して

基本ワークフロー（推奨）

  1. 出力先（sink）確認
  2. 明確なテスト音で再生確認（paplay + 明示 sink）
  3. 必要に応じて notify-send と組み合わせる
  4. VOICEVOX 利用時は API 生存確認 → WAV 生成 → paplay 再生

出力先（sink）確認

pactl info | sed -n '1,40p'
pactl list short sinks
wpctl status

見るべき項目:

  • Default Sink
  • sink 名（例: alsa_output.pci-0000_04_00.1.hdmi-stereo）
  • Mute: no
  • 音量

補足:

  • State: SUSPENDED はアイドル時には普通
  • VacuumTube の音がテレビから出ているなら、同じ HDMI sink を使うとよい

通知表示 + 音（実用パターン）

notify-send は通知表示、音は別コマンドで鳴らす。

export DISPLAY=:1
notify-send "完了" "処理が終わりました"
paplay --device=alsa_output.pci-0000_04_00.1.hdmi-stereo \
  /usr/share/sounds/freedesktop/stereo/message.oga

canberra-gtk-play を使う場合

export DISPLAY=:1
notify-send "通知" "効果音テスト"
canberra-gtk-play -i dialog-information

注意:

  • AT-SPI 警告が出ることがあるが、再生自体は成功する場合がある
  • 成功しても音が小さい/短いと気づきにくい

notify-send 単体で音が鳴らないときの理由（この環境）

KDE/Plasma の通知デーモン capability に sound-name / sound-file が無い場合、notify-send -h ... で音ヒントを渡しても効かない。

確認:

qdbus org.freedesktop.Notifications /org/freedesktop/Notifications \
  org.freedesktop.Notifications.GetCapabilities

この環境の実測では、sound-name / sound-file は未対応。

明確なテスト音（聞こえるか切り分け）

短い通知音で判断しづらいときは、1kHz テストトーンを生成して再生する。

python3 - <<'PY'
import math, wave, struct
path = '/tmp/codex-tone-1khz.wav'
rate = 48000
dur = 1.8
freq = 1000.0
amp = 0.35
n = int(rate * dur)
with wave.open(path, 'wb') as w:
    w.setnchannels(2)
    w.setsampwidth(2)
    w.setframerate(rate)
    for i in range(n):
        v = int(32767 * amp * math.sin(2 * math.pi * freq * i / rate))
        w.writeframesraw(struct.pack('<hh', v, v))
PY

paplay --device=alsa_output.pci-0000_04_00.1.hdmi-stereo \
  --volume=65536 /tmp/codex-tone-1khz.wav

VOICEVOX 発話（WAV生成→再生）

1) API の生存確認

curl -fsS http://127.0.0.1:50021/version

起動していない場合:

  • VOICEVOX AppImage / アプリを起動
  • API ポート 50021 が開くまで待つ

2) 利用可能な話者を確認（任意）

curl -fsS http://127.0.0.1:50021/speakers | jq '.[].name'

3) 音声クエリ生成 → 合成 → 再生

以下は speaker=3 の例（環境差があるため、必要なら /speakers を見て選ぶ）。

TEXT='作業が終わりました'
SPEAKER=3
OUT=/tmp/voicevox-notify.wav
TEXT_ENC=$(python3 -c 'import sys, urllib.parse; print(urllib.parse.quote(sys.argv[1]))' "$TEXT")

curl -fsS -X POST \
  "http://127.0.0.1:50021/audio_query?text=${TEXT_ENC}&speaker=${SPEAKER}" \
  -H 'accept: application/json' > /tmp/voicevox-query.json

curl -fsS -X POST \
  "http://127.0.0.1:50021/synthesis?speaker=${SPEAKER}" \
  -H 'Content-Type: application/json' \
  --data-binary @/tmp/voicevox-query.json \
  > "$OUT"

paplay --device=alsa_output.pci-0000_04_00.1.hdmi-stereo "$OUT"

実務メモ:

  • URL エンコードが必要（日本語テキスト）
  • paplay の再生先は sink 明示推奨
  • VOICEVOX 側の合成成功と、再生成功は別問題（出力先違いで無音に見える）

出力先を切り替えて試す（必要時のみ）

一時的にデフォルト sink を切り替えて検証できる。

wpctl status
wpctl set-default <SINK_ID>
paplay /usr/share/sounds/freedesktop/stereo/bell.oga

注意:

  • デフォルト変更は他アプリ（VacuumTube 等）にも影響する
  • まずは paplay --device=... での明示再生を優先する

よくある失敗と対処

  • notify-send は表示されるが音が鳴らない
    • notify-send 単体を諦める。paplay / canberra-gtk-play を併用
  • canberra-gtk-play が Cannot open display
    • DISPLAY=:1 を付ける
  • paplay は成功するが聞こえない
    • sink が違う。pactl info の Default Sink と実際の出力先を照合
    • paplay --device=<sink> で明示
  • 通知音が「鳴った気がしない」
    • サンプル音が短い/小さい。1kHz テストトーンで切り分ける
  • speaker-test -D pulse が失敗
    • ALSA の pulse PCM プラグイン未導入のことがある。paplay を使う
  • tmux / SSH 経由で notify-send / canberra-gtk-play が不安定
    • DISPLAY=:1 を明示
    • 必要なら XDG_RUNTIME_DIR=/run/user/$(id -u) を明示

成功条件（報告時）

  • 再生した音の種類（通知音 / 効果音 / テストトーン / VOICEVOX）
  • 使用したコマンドと sink
  • コマンドの成功可否
  • 必要なら「ユーザーに聞こえたか」の確認

ローカル参照（この環境で有用）

  • freedesktop 効果音: /usr/share/sounds/freedesktop/stereo/
  • 典型 sink（実測例）:
    • alsa_output.pci-0000_04_00.1.hdmi-stereo（HDMI / テレビ）
    • alsa_output.pci-0000_0c_00.4.iec958-stereo（S/PDIF）
Install via CLI
npx skills add https://github.com/yuiseki/ai-secretary --skill audio-play
Repository Details
star Stars 1
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator
yuiseki
yuiseki Explore all skills →