Difference between revisions of "Shairport Sync"

From ArchWiki
Jump to: navigation, search
(It was updated 3 days ago ... - Undo revision 390195 by Ainola (talk))
(Changed contents to relate properly to the package, which is shairport-sync rather than shairport. Would love to change the page title to "Shairport Sync" from "Shairport")
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).
+
Shairport Sync is an 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==
Line 8: Line 12:
 
==Configuration==
 
==Configuration==
  
The configuration file can be found at {{ic|/etc/conf.d/shairport-sync}}. 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 README] file.
 
 
{{hc|/etc/conf.d/shairport-sync|<nowiki>
 
# ShairportSync Daemon options
 
SHAIRPORT_ARGS="--name='My Server Name'"
 
</nowiki>}}
 
  
 
==Starting==
 
==Starting==
  
 
[[Start]]/[[enable]] {{ic|shairport-sync.service}} using systemd.
 
[[Start]]/[[enable]] {{ic|shairport-sync.service}} using systemd.

Revision as of 14:09, 30 December 2015

Shairport Sync is an 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.