Difference between revisions of "Shairport Sync"

From ArchWiki
Jump to: navigation, search
(Configuration: Give a bit more detail about the one config option. Also changed the service name to reflect what is in the official repos)
m (link AirPlay wikipedia article)
(12 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
[[Category:Streaming]]
 
[[Category:Streaming]]
Shairport is a utility for emulating AirPlay functionality on Linux. However, since it has been created by reverse-engineering Apple's key used in its AirPort Express, be advised that the functionality may be removed at Apple's discretion. ShairPort does not support AirPlay v2 (video and photo streaming).
+
[[ja:Shairport Sync]]
 +
[https://github.com/mikebrady/shairport-sync Shairport Sync] is an [[w:AirPlay]] audio player — it plays audio streamed from iTunes, iOS devices and third-party AirPlay sources such as ForkedDaapd and others. Audio played by a Shairport Sync-powered device stays synchronised with the source and hence with similar devices playing the same source. In this way, synchronised multi-room audio is possible without difficulty. (Hence the name Shairport Sync, BTW.)
 +
 
 +
Shairport Sync does not support AirPlay video or photo streaming.
 +
 
 +
Shairport Sync is a fork of the original Shairport which was based on reverse-engineering Apple's key used in its AirPort Express. Be advised that this functionality may be removed at Apple's discretion.  
  
 
==Installation==
 
==Installation==
[[pacman#Installing specific packages|Install]] {{Pkg|shairport-sync}}, from the [[official repositories]].
 
  
Alternatively, the {{AUR|shairport-git}} package is available from the [[AUR]].
+
[[Install]] the {{Pkg|shairport-sync}} package.
  
 
==Configuration==
 
==Configuration==
  
The configuration file can be found at {{ic|/etc/conf.d/shairport}}. It consists on a single variable allowing arguments to be passed to the service. In the example below, iTunes would label the server as 'My Server Name' rather than the default 'Shairport Sync on <hostname>'.
+
The configuration file can be found at {{ic|/etc/shairport-sync.conf}}. It contains useful comments and configuration hints. More documentation is available in the [https://github.com/mikebrady/shairport-sync/blob/master/README.md#configuring-shairport-sync README] file.
 
 
{{hc|/etc/conf.d/shairport|<nowiki>
 
# Shairport Daemon options
 
SHAIRPORT_ARGS="--name='My Server Name'"
 
</nowiki>}}
 
  
If using the {{Pkg|shairport-sync}} from the [[official repositories]], the service name is shairport-sync.service:
+
==Starting==
  
# systemctl start shairport-sync.service
+
[[Start]]/[[enable]] {{ic|shairport-sync.service}} using systemd.

Revision as of 08:39, 2 August 2017

Shairport Sync is an w:AirPlay audio player — it plays audio streamed from iTunes, iOS devices and third-party AirPlay sources such as ForkedDaapd and others. Audio played by a Shairport Sync-powered device stays synchronised with the source and hence with similar devices playing the same source. In this way, synchronised multi-room audio is possible without difficulty. (Hence the name Shairport Sync, BTW.)

Shairport Sync does not support AirPlay video or photo streaming.

Shairport Sync is a fork of the original Shairport which was based on reverse-engineering Apple's key used in its AirPort Express. Be advised that this functionality may be removed at Apple's discretion.

Installation

Install the shairport-sync package.

Configuration

The configuration file can be found at /etc/shairport-sync.conf. It contains useful comments and configuration hints. More documentation is available in the README file.

Starting

Start/enable shairport-sync.service using systemd.