メディア操作マニュアル

オーディオ/ビデオ関連の操作。PipeWire の管理、音量制御、デバイスルーティング、録音、およびトラブルシューティングを含みます。

アーキテクチャ概要

重要概念:

• PipeWire = 統一されたオーディオ/ビデオサービス。PulseAudio と JACK を同時に置き換えます。
• WirePlumber = デバイスのホットプラグ/自動ルーティングポリシー (イヤホンが挿された場合や HDMI 出力への切り替えなど)
• pipewire-pulse = PulseAudio 互換層。PA アプリが PipeWire を透過的に使用できるようにします。
• pactl は pipewire-pulse を操作し、wpctl は PipeWire 原生層を操作します。

ステータス確認

# サービス状態
systemctl --user status pipewire wireplumber pipewire-pulse

# PipeWire 原生情報
pw-cli info                          # PipeWire サービス概要
pw-dump                              # 完全ダンプ (ノード/ポート/リンク)
pw-top                               # リアルタイムパフォーマンスモニタリング (htop に類似)
pw-cli list-objects                  # すべてのオブジェクトをリスト

# WirePlumber デバイス
wpctl status                         # デバイスの概要 (sink/source/デフォルトデバイス)
wpctl inspect <id>                   # 特定のデバイス/ノードの詳細表示

# PulseAudio 互換層
pactl info                           # PulseAudio サービス情報
pactl list sinks                     # すべてのオーディオ出力をリスト
pactl list sources                   # すべてのオーディオ入力 (モニター含む) をリスト
pactl list cards                     # サウンドカード情報 (プロファイル/ポート)
pactl list sink-inputs               # 再生中のオーディオストリーム
pactl list modules                   # ロードされているモジュール

# ハードウェア
aplay -l                             # ALSA 再生デバイスリスト
arecord -l                           # ALSA 録音デバイスリスト
lspci | grep -i audio                # PCI オーディオデバイス
cat /proc/asound/cards               # カーネル視点のサウンドカード

音量制御

# wpctl (推奨、PipeWire 原生)
wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+      # デフォルト出力を +5%
wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-      # デフォルト出力を -5%
wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.5      # 50% に設定
wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle     # ミュート切り替え
wpctl set-volume <sink-id> 0.75                # 指定された sink を 75% に設定

# pactl (PulseAudio 互換層)
pactl set-sink-volume @DEFAULT_SINK@ +5%
pactl set-sink-volume @DEFAULT_SINK@ 50%
pactl set-sink-mute @DEFAULT_SINK@ toggle

# amixer (ALSA 低レベル、ハードウェア直接制御)
amixer scontrols                      # シンプルミキサーコントロールをリスト
amixer sget Master                    # Master 音量を確認
amixer sset Master 80%                # Master を 80% に設定
amixer sset Master 5%+                # Master を +5%
amixer sset Master toggle             # ミュート切り替え
amixer sset Headphone 70%

オーディオルーティング (出力デバイスの切替)

# 利用可能な sink をリストして切替
wpctl status                          # 対象 sink の ID を確認
wpctl set-default <sink-id>           # デフォルト出力に設定
wpctl inspect <sink-id>               # 切替が有効になったことを確認

# 現在の再生ストリームを指定された sink に移行
pactl list sink-inputs                # sink-input ID を確認
pactl move-sink-input <input-id> <sink-id>

# 特定のデバイスに切替 (名前で指定)
SINK=$(pactl list sinks short | grep -i "hdmi\|analog\|usb" | head -1 | awk '{print $1}')
pactl set-default-sink "$SINK"

# サウンドカードのプロファイルを確認 (アナログ/デジタル/HDMI 切替)
pactl list cards
pactl set-card-profile <card-name> output:analog-stereo
pactl set-card-profile <card-name> output:hdmi-stereo
pactl set-card-profile <card-name> output:iec958-stereo  # SPDIF

WirePlumber / PipeWire の再起動

# 音声スタック全体の再起動 (ソフトリブート、アプリ側は気づかない)
systemctl --user restart pipewire pipewire-pulse wireplumber

# WirePlumber のみ再起動 (デバイスリストの更新)
systemctl --user restart wireplumber

# 完全リセット (一旦停止させてから再起動)
systemctl --user stop pipewire pipewire-pulse wireplumber
sleep 1
systemctl --user start pipewire wireplumber pipewire-pulse

トラブルシューティング

# 1. 音声出力があるか確認
paplay /usr/share/sounds/alsa/Front_Center.wav    # テスト音
speaker-test -t sine -f 440 -l 1                   # 440Hz 正弦波 (PA/PW をバイパス)

# 2. pipewire-pulse がハングしていないか確認 (よくあるケース: Chrome の動画が固まる)
pactl info 2>&1                                    # エラーやタイムアウトがないか確認
paplay /usr/share/sounds/alsa/Front_Center.wav     # 終了コードが 124 の場合、pipewire-pulse がハングしている
# 修正: systemctl --user restart pipewire-pulse

# 3. プロセスがサウンドカードを独占していないか確認
fuser /dev/snd/*                                   # どのプロセスがオーディオデバイスを占有しているか
lsof /dev/snd/*                                    # より詳細な情報

# 4. ALSA 層が正常か確認
aplay -D hw:0,0 /usr/share/sounds/alsa/Front_Center.wav  # PipeWire をバイパスして直接再生
speaker-test -D hw:0,0 -t sine -f 440 -l 1
# ALSA 直接再生は正常だが PipeWire では音が出ない場合 → PipeWire 層の問題
# ALSA でもエラーが出る場合 → ドライバ/ハードウェアの問題

# 5. USB/HDMI のホットプラグで反応がない場合
wpctl status                          # デバイスが出現しているか確認
systemctl --user restart wireplumber  # デバイスリストの強制更新
journalctl --user -u wireplumber -f   # WirePlumber のログ確認

# 6. Bluetooth オーディオ
bluetoothctl connect XX:XX:XX:XX:XX:XX
# 接続後、wireplumber が BT sink を自動作成し、wpctl status で確認可能
# 表示されない場合: systemctl --user restart wireplumber

# 7. 同時複数出力 (必要な場合)
pactl load-module module-combine-sink   # 結合 sink を作成し、すべてのデバイスに同時に出力
# アンロード: pactl unload-module module-combine-sink

よくある症状のクイックリファレンス

録音

# スクリーン録画 (PipeWire + wf-recorder、Wayland 原生)
wf-recorder -f output.mp4                    # フルスクリーン録画
wf-recorder -g "$(slurp)" -f output.mp4      # 領域選択録画
wf-recorder --audio -f output.mp4            # オーディオ付き (pipewire が必要)
wf-recorder --audio=HDMI -f output.mp4       # 特定のオーディオソースを指定

# オーディオ録音 (PipeWire)
pw-record output.wav                          # デフォルト入力デバイスで録音
pw-record --target=<node-id> output.wav       # 入力ソースを指定

# PulseAudio 互換
parecord output.wav                           # デフォルトマイクで録音
parecord --device=<source> output.wav         # 入力ソースを指定
parec --device=<sink>.monitor output.wav      # システム出力を録音 (内部録音)

# スクリーンショット (Wayland/Hyprland)
grim screenshot.png                           # フルスクリーン
grim -g "$(slurp)" screenshot.png             # 領域選択
grim - | wl-copy                              # クリップボードにコピー

音量/メディアキー

Hyprland のメディアキーバインド例 (hyprland.lua):

-- 音量制御 (wpctl)
hl.dsp.bind({"SUPER"}, "XF86AudioRaiseVolume",  function() hl.exec("wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+") end)
hl.dsp.bind({"SUPER"}, "XF86AudioLowerVolume",  function() hl.exec("wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-") end)
hl.dsp.bind({"SUPER"}, "XF86AudioMute",         function() hl.exec("wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle") end)
hl.dsp.bind({"SUPER"}, "XF86AudioMicMute",      function() hl.exec("wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle") end)

-- 再生制御 (playerctl、インストールが必要)
hl.dsp.bind({}, "XF86AudioPlay",  function() hl.exec("playerctl play-pause") end)
hl.dsp.bind({}, "XF86AudioNext",  function() hl.exec("playerctl next") end)
hl.dsp.bind({}, "XF86AudioPrev",  function() hl.exec("playerctl previous") end)

playerctl のその他の使用方法:

playerctl play-pause                  # 現在のプレイヤーを制御
playerctl -p spotify next             # 特定のプレイヤーを指定
playerctl -a play-pause               # すべてのプレイヤーを制御
playerctl -l                          # 制御可能なプレイヤーをリスト
playerctl metadata                    # 現在の曲情報
playerctl metadata --format '{{artist}} - {{title}}'

ビデオ/コーデック情報

ffprobe video.mp4                     # 動画の完全な情報
ffprobe -v quiet -show_streams video.mp4 | grep codec  # コーデックのみ表示
ffprobe -v quiet -show_entries stream=codec_name,width,height video.mp4

# ハードウェアエンコード/デコードのサポートを確認
vainfo                                # VA-API (Intel/AMD)
vulkaninfo | grep -i video            # Vulkan Video 拡張機能
ffmpeg -encoders | grep vaapi         # 利用可能な VA-API エンコーダ

ファームウェア

# AMD GPU ファームウェア (エンコード/デコード/表示)
ls /lib/firmware/amdgpu/              # gc_*, psp_*, sdma_*, vcn_* など
dmesg | grep -i "firmware\|amdgpu"    # ファームウェアロードログ

# SOF (Sound Open Firmware、Intel 音声 DSP)
dmesg | grep -i sof
ls /lib/firmware/intel/sof/