How to Install the Apple Music Driver

The Control4 Apple Music driver is compatible with the following primary or secondary controllers:

• CORE 1
• CORE 3
• CORE 5
• CORE-lite
• SA-1

1. Verify the above system requirements.
2. Download the latest Apple Music driver and add it to the project.
3. Verify the project’s audio paths and endpoints.
4. Ensure the Apple Music driver is visible in the Listen experience for the desired Rooms.
5. Refresh Navigators.
6. From a Navigator, go to Listen > Apple Music and sign in with the Apple Music account credentials.
7. Test the driver.

• Apple Music does not provide user information to the driver. Be sure to name each driver instance to avoid playback issues.
• Apple Music is DRM-protected and allows only one stream at a time across all devices. If the driver cannot obtain a track license from Apple, the playback stops and the user receives a message about the error.
• Because Apple Music allows only one stream at a time, the driver joins any Rooms that try to play back at the same time as the same driver. This cannot be disabled.
• Live stations (Apple Music One, Apple Music Hits, and Apple Music Country) are not supported at this time.
• Tracks longer than fifteen minutes stop playing around fifteen minutes into the track. This is under investigation, and we expect a resolution in a future release.
• Gapless playback is not currently supported. If a track is mastered to be gapless there is still an audible transition between tracks. This is under investigation, and we expect a resolution in a future release.

• The Apple Music driver cannot be selected or controlled by the Room Control driver. Albums podcasts, and playlists can be programmed to the Room Control driver.
• The Apple Music driver is not selectable as a source for the Wakeup experience. It can be programmed to queue when a specific Wakeup Scene executes.
• Spatial sound and lossless audio are not currently supported, due to the APIs used to decode Apple Music DRM.

What should I do first?
Before proceeding, ensure your Apple Music account meets the following criteria:

• You have an account that has Apple Music
• You have an active Apple Music subscription
• You have music that you’ve played on your Apple device, such as your iPhone.
• You have successfully played Apple Music on your devices.
• Once these steps are confirmed, you can start the integration process with Control4.

Can I use an EA controller?
You must have a CORE controller or an SA1 in your project to install the required DRM license for Apple Music. With one of these devices in your project, this allows streaming to any Control4 device with Ryff capabilities.

Does Apple Music require Control4 Connect?
A valid Connect or 4Sight license is required.

What Control4 OS release is required?
OS 3.4.2 or newer is required.

Is the Control4 App for iOS required?
Ensure you have downloaded the latest Control4 Mobile App from the App Store, version 324.23 or newer.

• If Apple Music does not show up or work, it means one of these requirements has not been met.
• If Apple Music still isn’t showing up, after installing the Apple Music driver, navigate to File and Refresh Navigators within Composer if you haven’t already.
• No Audio? After installing the driver, allow 10-15 minutes for the required licensing packages to download.
• If Apple Music still isn’t showing up or working, navigate to System Design within Composer. Select the Apple Music driver and ensure it is on version 51 or higher. If so, navigate to the Actions tab and click Trigger Flatpak Install. Allow up to 10 minutes to install. 
• If you are still having issues, ensure you can access the same content or information on https://music.apple.com/, as this is Apple’s direct site that we use for API access.
• Please refer to and use the documentation tab of the driver for additional information.

El driver de Apple Music de Control4 es compatible con los siguientes controladores primarios o secundarios:

• CORE 1
• CORE 3
• CORE 5
• CORE-lite
• SA-1

1. Comprueba que se cumplen los requisitos del sistema.
2. Descarga el último driver de Apple Music y añádelo al proyecto.
3. Verifica las rutas de audio y los End Points del proyecto.
4. Asegúrate de que el driver de Apple Music está visible en la sección Escuchar para las habitaciones deseadas.
5. Refresh Navigators.
6. Desde un Navegador, ve a Escuchar > Apple Music e inicia sesión con las credenciales de la cuenta de Apple Music.
7. Prueba el driver.

• Apple Music no proporciona información del usuario al driver. Asegúrate de nombrar cada instancia del driver para evitar problemas de reproducción.
• Apple Music está protegido por DRM y sólo permite una transmisión a la vez en todos los dispositivos. Si el driver no puede obtener una licencia de pista de Apple, la reproducción se detiene y el usuario recibe un mensaje sobre el error.
• Dado que Apple Music sólo permite una transmisión a la vez, el driver se une a cualquier habitación que intente reproducir al mismo tiempo que el mismo driver. Esto no puede desactivarse.
• Las emisoras en directo (Apple Music One, Apple Music Hits y Apple Music Country) no son compatibles en este momento.
• Las pistas de más de quince minutos dejan de reproducirse en torno a los quince minutos de la pista. Este problema se está investigando y esperamos solucionarlo en una próxima versión.
• Actualmente no es posible la reproducción sin pausas. Si se masteriza una pista para que no haya pausas, sigue habiendo una transición audible entre las pistas. Este problema se está investigando y esperamos solucionarlo en el futuro.

• El driver Apple Music no puede ser seleccionado o controlado por el driver Room Control. Los podcasts de álbumes y las listas de reproducción se pueden programar en el driver Room Control.
• El driver Apple Music no se puede seleccionar como fuente para la experiencia Wakeup. Se puede programar para que se ponga en cola cuando se ejecute una escena Wakeup específica.
• El sonido espacial y el audio sin pérdidas no son compatibles actualmente, debido a las API utilizadas para descodificar Apple Music DRM.

¿Qué debo hacer primero?
Antes de continuar, asegúrate de que tu cuenta de Apple Music cumple los siguientes criterios:

• Tienes una cuenta con Apple Music
• Tienes una suscripción activa a Apple Music
• Tienes música que has reproducido en tu dispositivo Apple, como tu iPhone.
• Has reproducido correctamente Apple Music en tus dispositivos.
• Una vez confirmados estos pasos, puede iniciar el proceso de integración con Control4.

¿Puedo usar un controlador EA?
Debes tener un controlador CORE o un SA1 en tu proyecto para instalar la licencia DRM necesaria para Apple Music. Con uno de estos dispositivos en el proyecto, puedes transmitir a cualquier dispositivo Control4 con capacidades Ryff.

¿Apple Music requiere Control4 Connect?
Se requiere una licencia Connect o 4Sight válida.

¿Qué versión de Control4 OS se requiere?
Se requiere OS 3.4.2 o posterior.

¿Es necesaria la aplicación Control4 para iOS?
Asegúrate de que has descargado la última versión de la aplicación Control4 Mobile de la App Store, versión 324.23 o posterior.

• Si Apple Music no aparece o no funciona, significa que uno de estos requisitos no se ha cumplido.
• Si Apple Music sigue sin aparecer, después de instalar el driver de Apple Music, ve a File y Refresh Navigators dentro de Composer si aún no lo has hecho.
• ¿No hay audio? Después de instalar el driver, espera de 10 a 15 minutos para que se descarguen los paquetes de licencias necesarios.
• Si Apple Music sigue sin aparecer o no funciona, ve a System Design en Composer. Selecciona el driver de Apple Music y asegúrate de que está en la versión 51 o superior. Si es así, ve a la pestaña Actions y haz clic en Trigger Flatpak Install. Espera hasta 10 minutos para la instalación.
• Si sigues teniendo problemas, asegúrate de que puedes acceder al mismo contenido o información en https://music.apple.com/, ya que es el sitio directo de Apple que utilizamos para acceder a la API.
• Consulta y utiliza la ficha de documentación del driver para obtener información adicional.

The Control4 Apple Music driver is compatible with the following primary or secondary controllers:

• CORE 1
• CORE 3
• CORE 5
• CORE-lite
• SA-1

1. Verify the above system requirements.
2. Download the latest Apple Music driver and add it to the project.
3. Verify the project’s audio paths and endpoints.
4. Ensure the Apple Music driver is visible in the Listen experience for the desired Rooms.
5. Refresh Navigators.
6. From a Navigator, go to Listen > Apple Music and sign in with the Apple Music account credentials.
7. Test the driver.

• Apple Music does not provide user information to the driver. Be sure to name each driver instance to avoid playback issues.
• Apple Music is DRM-protected and allows only one stream at a time across all devices. If the driver cannot obtain a track license from Apple, the playback stops and the user receives a message about the error.
• Because Apple Music allows only one stream at a time, the driver joins any Rooms that try to play back at the same time as the same driver. This cannot be disabled.
• Live stations (Apple Music One, Apple Music Hits, and Apple Music Country) are not supported at this time.
• Tracks longer than fifteen minutes stop playing around fifteen minutes into the track. This is under investigation, and we expect a resolution in a future release.
• Gapless playback is not currently supported. If a track is mastered to be gapless there is still an audible transition between tracks. This is under investigation, and we expect a resolution in a future release.

• The Apple Music driver cannot be selected or controlled by the Room Control driver. Albums podcasts, and playlists can be programmed to the Room Control driver.
• The Apple Music driver is not selectable as a source for the Wakeup experience. It can be programmed to queue when a specific Wakeup Scene executes.
• Spatial sound and lossless audio are not currently supported, due to the APIs used to decode Apple Music DRM.

What should I do first?
Before proceeding, ensure your Apple Music account meets the following criteria:

• You have an account that has Apple Music
• You have an active Apple Music subscription
• You have music that you’ve played on your Apple device, such as your iPhone.
• You have successfully played Apple Music on your devices.
• Once these steps are confirmed, you can start the integration process with Control4.

Can I use an EA controller?
You must have a CORE controller or an SA1 in your project to install the required DRM license for Apple Music. With one of these devices in your project, this allows streaming to any Control4 device with Ryff capabilities.

Does Apple Music require Control4 Connect?
A valid Connect or 4Sight license is required.

What Control4 OS release is required?
OS 3.4.2 or newer is required.

Is the Control4 App for iOS required?
Ensure you have downloaded the latest Control4 Mobile App from the App Store, version 324.23 or newer.

• If Apple Music does not show up or work, it means one of these requirements has not been met.
• If Apple Music still isn’t showing up, after installing the Apple Music driver, navigate to File and Refresh Navigators within Composer if you haven’t already.
• No Audio? After installing the driver, allow 10-15 minutes for the required licensing packages to download.
• If Apple Music still isn’t showing up or working, navigate to System Design within Composer. Select the Apple Music driver and ensure it is on version 51 or higher. If so, navigate to the Actions tab and click Trigger Flatpak Install. Allow up to 10 minutes to install. 
• If you are still having issues, ensure you can access the same content or information on https://music.apple.com/, as this is Apple’s direct site that we use for API access.
• Please refer to and use the documentation tab of the driver for additional information.

The Control4 Apple Music driver is compatible with the following primary or secondary controllers:

• CORE 1
• CORE 3
• CORE 5
• CORE-lite
• SA-1

1. Verify the above system requirements.
2. Download the latest Apple Music driver and add it to the project.
3. Verify the project’s audio paths and endpoints.
4. Ensure the Apple Music driver is visible in the Listen experience for the desired Rooms.
5. Refresh Navigators.
6. From a Navigator, go to Listen > Apple Music and sign in with the Apple Music account credentials.
7. Test the driver.

• Apple Music does not provide user information to the driver. Be sure to name each driver instance to avoid playback issues.
• Apple Music is DRM-protected and allows only one stream at a time across all devices. If the driver cannot obtain a track license from Apple, the playback stops and the user receives a message about the error.
• Because Apple Music allows only one stream at a time, the driver joins any Rooms that try to play back at the same time as the same driver. This cannot be disabled.
• Live stations (Apple Music One, Apple Music Hits, and Apple Music Country) are not supported at this time.
• Tracks longer than fifteen minutes stop playing around fifteen minutes into the track. This is under investigation, and we expect a resolution in a future release.
• Gapless playback is not currently supported. If a track is mastered to be gapless there is still an audible transition between tracks. This is under investigation, and we expect a resolution in a future release.

• The Apple Music driver cannot be selected or controlled by the Room Control driver. Albums podcasts, and playlists can be programmed to the Room Control driver.
• The Apple Music driver is not selectable as a source for the Wakeup experience. It can be programmed to queue when a specific Wakeup Scene executes.
• Spatial sound and lossless audio are not currently supported, due to the APIs used to decode Apple Music DRM.

What should I do first?
Before proceeding, ensure your Apple Music account meets the following criteria:

• You have an account that has Apple Music
• You have an active Apple Music subscription
• You have music that you’ve played on your Apple device, such as your iPhone.
• You have successfully played Apple Music on your devices.
• Once these steps are confirmed, you can start the integration process with Control4.

Can I use an EA controller?
You must have a CORE controller or an SA1 in your project to install the required DRM license for Apple Music. With one of these devices in your project, this allows streaming to any Control4 device with Ryff capabilities.

Does Apple Music require Control4 Connect?
A valid Connect or 4Sight license is required.

What Control4 OS release is required?
OS 3.4.2 or newer is required.

Is the Control4 App for iOS required?
Ensure you have downloaded the latest Control4 Mobile App from the App Store, version 324.23 or newer.

• If Apple Music does not show up or work, it means one of these requirements has not been met.
• If Apple Music still isn’t showing up, after installing the Apple Music driver, navigate to File and Refresh Navigators within Composer if you haven’t already.
• No Audio? After installing the driver, allow 10-15 minutes for the required licensing packages to download.
• If Apple Music still isn’t showing up or working, navigate to System Design within Composer. Select the Apple Music driver and ensure it is on version 51 or higher. If so, navigate to the Actions tab and click Trigger Flatpak Install. Allow up to 10 minutes to install. 
• If you are still having issues, ensure you can access the same content or information on https://music.apple.com/, as this is Apple’s direct site that we use for API access.
• Please refer to and use the documentation tab of the driver for additional information.

The Control4 Apple Music driver is compatible with the following primary or secondary controllers:

• CORE 1
• CORE 3
• CORE 5
• CORE-lite
• SA-1

1. Verify the above system requirements.
2. Download the latest Apple Music driver and add it to the project.
3. Verify the project’s audio paths and endpoints.
4. Ensure the Apple Music driver is visible in the Listen experience for the desired Rooms.
5. Refresh Navigators.
6. From a Navigator, go to Listen > Apple Music and sign in with the Apple Music account credentials.
7. Test the driver.

• Apple Music does not provide user information to the driver. Be sure to name each driver instance to avoid playback issues.
• Apple Music is DRM-protected and allows only one stream at a time across all devices. If the driver cannot obtain a track license from Apple, the playback stops and the user receives a message about the error.
• Because Apple Music allows only one stream at a time, the driver joins any Rooms that try to play back at the same time as the same driver. This cannot be disabled.
• Live stations (Apple Music One, Apple Music Hits, and Apple Music Country) are not supported at this time.
• Tracks longer than fifteen minutes stop playing around fifteen minutes into the track. This is under investigation, and we expect a resolution in a future release.
• Gapless playback is not currently supported. If a track is mastered to be gapless there is still an audible transition between tracks. This is under investigation, and we expect a resolution in a future release.

• The Apple Music driver cannot be selected or controlled by the Room Control driver. Albums podcasts, and playlists can be programmed to the Room Control driver.
• The Apple Music driver is not selectable as a source for the Wakeup experience. It can be programmed to queue when a specific Wakeup Scene executes.
• Spatial sound and lossless audio are not currently supported, due to the APIs used to decode Apple Music DRM.

What should I do first?
Before proceeding, ensure your Apple Music account meets the following criteria:

• You have an account that has Apple Music
• You have an active Apple Music subscription
• You have music that you’ve played on your Apple device, such as your iPhone.
• You have successfully played Apple Music on your devices.
• Once these steps are confirmed, you can start the integration process with Control4.

Can I use an EA controller?
You must have a CORE controller or an SA1 in your project to install the required DRM license for Apple Music. With one of these devices in your project, this allows streaming to any Control4 device with Ryff capabilities.

Does Apple Music require Control4 Connect?
A valid Connect or 4Sight license is required.

What Control4 OS release is required?
OS 3.4.2 or newer is required.

Is the Control4 App for iOS required?
Ensure you have downloaded the latest Control4 Mobile App from the App Store, version 324.23 or newer.

• If Apple Music does not show up or work, it means one of these requirements has not been met.
• If Apple Music still isn’t showing up, after installing the Apple Music driver, navigate to File and Refresh Navigators within Composer if you haven’t already.
• No Audio? After installing the driver, allow 10-15 minutes for the required licensing packages to download.
• If Apple Music still isn’t showing up or working, navigate to System Design within Composer. Select the Apple Music driver and ensure it is on version 51 or higher. If so, navigate to the Actions tab and click Trigger Flatpak Install. Allow up to 10 minutes to install. 
• If you are still having issues, ensure you can access the same content or information on https://music.apple.com/, as this is Apple’s direct site that we use for API access.
• Please refer to and use the documentation tab of the driver for additional information.