「Shairport Sync」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(カテゴリ追加)
(ユーザーサービスを翻訳して追加)
 
(同じ利用者による、間の3版が非表示)
8行目: 8行目:
 
Shairport Sync は AirPort Express で使われている Apple の鍵を元にリバースエンジニアリングして作られた Shairport のフォークです。今後 Apple の出方によっては機能が削除される可能性があるので注意してください。
  
Shairport Sync は AirPort Express で使われている Apple の鍵を元にリバースエンジニアリングして作られた Shairport のフォークです。今後 Apple の出方によっては機能が削除される可能性があるので注意してください。
   
−
==インストール==
 +
== インストール ==
   
−
{{Pkg|shairport-sync}} パッケージを[[インストール]]してください。
 +
{{Pkg|shairport-sync}} パッケージを [[インストール]] してください。
   
  +
{{Note|Sharport Sync は、avahi-daemon が実行されている必要があります。systemd を使用して {{ic|avahi-daemon.service}} を [[起動/有効化]] して下さい。
−
==設定==
  
  +
}}
  +
  +
== 設定 ==
   
 
設定ファイルは {{ic|/etc/shairport-sync.conf}} に存在します。設定ファイルにはコメントが付いており設定ヒントも記述されています。詳しいドキュメントは [https://github.com/mikebrady/shairport-sync/blob/master/README.md#configuring-shairport-sync README] ファイルから閲覧できます。
  
設定ファイルは {{ic|/etc/shairport-sync.conf}} に存在します。設定ファイルにはコメントが付いており設定ヒントも記述されています。詳しいドキュメントは [https://github.com/mikebrady/shairport-sync/blob/master/README.md#configuring-shairport-sync README] ファイルから閲覧できます。
   
  +
=== Audio バックエンド ===
−
==起動==
  
  +
  +
Sharport Sync は [[PulseAudio]] とうまく連携しますが、タイミング情報は Alsa や sndio ほど正確ではありません。多くの場合、PulseAudio を削除または無効にするのは現実的ではありません。変わりに ''pa'' バックエンドを使用できます。[https://github.com/mikebrady/shairport-sync/blob/master/README.md#more-information]
  +
  +
バックエンドを変更したい場合は、たとえば {{Pkg|alsa-utils}} のツールを使用して出力デバイスのリストを確認し、次のような生のオーディオ デバイスを確認します:
  +
  +
{{hc|$ aplay -L|2=
  +
...
  +
sysdefault:CARD=PCH
  +
HDA Intel PCH, ALC269VC Analog
  +
Default Audio Device
  +
...
  +
}}
  +
  +
次に、デバイス名を追加します:
  +
  +
{{hc|/etc/shairport-sync.conf|2=
  +
// These are parameters for the "alsa" audio back end.
  +
// For this section to be operative, Shairport Sync must be built with the following configuration flag:
  +
// --with-alsa
  +
alsa =
  +
{
  +
output_device = "sysdefault";
  +
}
  +
}}
  +
  +
== システムサービス ==
  +
  +
=== 起動 ===
  +
  +
{{ic|shairport-sync.service}} を [[起動]]/[[有効化]] します。
  +
  +
=== デーモンのセットアップ ===
  +
  +
shairport-sync をデーモンとして実行したい場合は、{{ic|/run}} にフォルダーを作成する必要があります。これは Arch Linux のデフォルトでは tempfs です。起動時にフォルダーが自動的に作成されるようにするには、次のように tempfiles 設定ファイルを作成します:
  +
  +
{{hc|/usr/lib/tempfiles.d/shairport-sync.conf|d /run/shairport-sync 0755 username group}}
  +
  +
{{ic|shairport-sync -d}} を使用して shairport-sync をデーモンとして実行し、{{ic|shairport-sync -k}} を使用してデーモンを停止できるようになります。
  +
  +
== ユーザーサービス ==
  +
  +
[https://github.com/mikebrady/shairport-sync/issues/471#issuecomment-394089069 著者] によると、デフォルトの PulseAudio 設定を持つ PulseAudio バックエンドは [[ユーザーユニット|ユーザーサービス]] としてのみ動作します。2022-01-27 時点では、pulseaudio (pipewire-pulse) を変更せずにシステムサービスとして動作するようで、ユーザー サービスは必要ありません。
  +
  +
ユーザーデーモンとして ''shairport-sync'' を実行するには、それをデスクトップ環境の自動起動に追加するか、{{ic|shairport-sync.service}} を [[有効化]] して [[ユーザーユニット]] として追加できます。
  +
  +
次に、{{ic|shairport-sync.service}} を実行し、次の行を [[編集]] してコメントアウトします:
  +
  +
[Unit]
  +
...
  +
#Requires=avahi-daemon.service
  +
#After=avahi-daemon.service
  +
...
  +
[Service]
  +
...
  +
#User=shairport-sync
  +
#Group=shairport-sync
  +
...
  +
  +
これで、{{ic|shairport-sync.service}} を [[Systemd/ユーザー|ユーザーとして]] [[起動/有効化]] する準備ができました:
   
  +
ログを取得するには、[[systemd/ジャーナル|ジャーナル]] を使用するか、[[ヘルプ:読み方#systemd ユニットのコントロール|ユニットのコントロール]] を確認してください。
−
systemd を使って {{ic|shairport-sync.service}} を[[起動]]・[[有効化]]してください。
  

2023年12月28日 (木) 12:30時点における最新版

Shairport Sync は AirPlay オーディオプレイヤーです。iTunes, iOS デバイス, ForkedDaapd などのサードパーティの AirPlay 音源からストリーミングされた音声を再生します。Shairport Sync のデバイスによって再生される音声は音源と同期し続けるので、同一の音源を再生する同じようなデバイスとも同期することになります。これによって、同期するマルチルームオーディオを簡単に構築できてしまいます (故に Shairport Sync という名前が付けられています)。

Shairport Sync は AirPlay の動画や写真のストリーミングには対応していません。

Shairport Sync は AirPort Express で使われている Apple の鍵を元にリバースエンジニアリングして作られた Shairport のフォークです。今後 Apple の出方によっては機能が削除される可能性があるので注意してください。

インストール

shairport-sync パッケージを インストール してください。

ノート: Sharport Sync は、avahi-daemon が実行されている必要があります。systemd を使用して avahi-daemon.service を 起動/有効化 して下さい。

設定

設定ファイルは /etc/shairport-sync.conf に存在します。設定ファイルにはコメントが付いており設定ヒントも記述されています。詳しいドキュメントは README ファイルから閲覧できます。

Audio バックエンド

Sharport Sync は PulseAudio とうまく連携しますが、タイミング情報は Alsa や sndio ほど正確ではありません。多くの場合、PulseAudio を削除または無効にするのは現実的ではありません。変わりに pa バックエンドを使用できます。[1]

バックエンドを変更したい場合は、たとえば alsa-utils のツールを使用して出力デバイスのリストを確認し、次のような生のオーディオ デバイスを確認します: 

$ aplay -L
...
sysdefault:CARD=PCH
    HDA Intel PCH, ALC269VC Analog
    Default Audio Device
...

次に、デバイス名を追加します: 

/etc/shairport-sync.conf
// These are parameters for the "alsa" audio back end.
// For this section to be operative, Shairport Sync must be built with the following configuration flag:
// --with-alsa
alsa =
{
    output_device = "sysdefault";
}

システムサービス

起動

shairport-sync.service を 起動/有効化 します。

デーモンのセットアップ

shairport-sync をデーモンとして実行したい場合は、/run にフォルダーを作成する必要があります。これは Arch Linux のデフォルトでは tempfs です。起動時にフォルダーが自動的に作成されるようにするには、次のように tempfiles 設定ファイルを作成します: 

/usr/lib/tempfiles.d/shairport-sync.conf
d /run/shairport-sync 0755 username group

shairport-sync -d を使用して shairport-sync をデーモンとして実行し、shairport-sync -k を使用してデーモンを停止できるようになります。

ユーザーサービス

著者 によると、デフォルトの PulseAudio 設定を持つ PulseAudio バックエンドは ユーザーサービス としてのみ動作します。2022-01-27 時点では、pulseaudio (pipewire-pulse) を変更せずにシステムサービスとして動作するようで、ユーザー サービスは必要ありません。

ユーザーデーモンとして shairport-sync を実行するには、それをデスクトップ環境の自動起動に追加するか、shairport-sync.service を 有効化 して ユーザーユニット として追加できます。

次に、shairport-sync.service を実行し、次の行を 編集 してコメントアウトします: 

[Unit]
...
#Requires=avahi-daemon.service
#After=avahi-daemon.service
...
[Service]
...
#User=shairport-sync
#Group=shairport-sync
...

これで、shairport-sync.service を ユーザーとして 起動/有効化 する準備ができました:

ログを取得するには、ジャーナル を使用するか、ユニットのコントロール を確認してください。

「https://wiki.archlinux.jp/index.php?title=Shairport_Sync&oldid=35461」から取得