Overview
Integrates LinkPlay-based streamers with Control4: the device's streaming, Bluetooth and USB show up as sources in the rooms, with media information and album art.
Compatible devices
- SoundSmart, Arylic, AAT Audio Cast, AAT PMR 9/12 and others with streaming
- Savage Stream Pro, Loud Streaming Media Player, iEast
- Wave integrated into the matrices
- WiiM (use https in the http-https property)
Features
- Song, artist, album, cover art and progress bar in Control4.
- Turns the room on automatically when someone starts playing from the app, AirPlay, Bluetooth or USB.
- Browsing inside Control4: device Presets, TuneIn radios (with Favorites) and Tidal (search, account Collection, artist page and save the queue as a playlist).
- Choose which tabs are shown in Navigator.
- Multiroom between LinkPlay devices over the network.
Requirements
- LinkPlay device on the same network as the controller, with a fixed or reserved IP.
- Manufacturer app (4Stream, WiiM Home, Arylic or similar) to set up the device on the network and sign in to the streaming services.
- To play Tidal from Control4, the Tidal account must be signed in on the device's app. The account connected in the driver (see the Tidal section) is used to browse the Collection and save playlists.
Installation
- Add the driver to the project and enter the device IP in Device IP, or use Devices on Network > Scan Devices and pick the device from the list.
- For WiiM, set http-https to https.
- Wait until Connection Status shows connected.
- Make the driver's audio connections to the rooms and hide the unused players in each room's properties.
Each driver creates 3 players (Streaming, Bluetooth and USB) besides itself. Hide the unused ones in the room properties.
Room showing all options
Room with streaming only
Never leave a single option in the room's Listen menu: keep another source or the media driver as an option.
Properties
General
| Property | Description |
|---|---|
| Debug Mode | Set to Print to generate a log for support. |
| Chave / Validacao / Cloud Status / Automatic Updates / Developer Access | Licensing and 4Drivers internal use. |
| Command Delay-Milliseconds | Time between commands sent to the device. |
| Protocol | How the device is controlled: HTTP (default, most devices) or TCP (devices with TCP control). |
| Volume Ramp Delay-Milliseconds | Time between volume commands while the button is held. |
Auto Room Select
| Property | Description |
|---|---|
| Auto Select Room | Which sources turn the room on automatically when the device starts playing: Streaming, Bluetooth, USB, All or No (off). |
| Room to be Selected | Room that will be turned on with the player when playback starts. |
Turn OFF Settings
| Property | Description |
|---|---|
| Auto Select Requires Play | With Yes (default), the room only turns on automatically when the device actually starts playing, for example when someone presses play in the phone app or via AirPlay. This prevents the room from turning on by itself when an app just reconnects to the device or a radio stream reloads. With No, it goes back to the previous behavior: it turns on as soon as the device changes source, even without playing. |
| Auto Select Quiet After OFF (seconds) | After the room is turned off by Control4, the driver will not turn the room back on automatically during this time (default 30 seconds). If someone really presses play during this period and the music keeps playing, the room turns on as soon as the time is over. Zero disables it. |
| Auto Room Off (minutes) | Turns the room off after this time with the music paused or stopped (from the app or from Control4). Zero disables it. |
| Switch INPUT on turn OFF | Null input used when turning off. See Turning the room off: null input. |
| Set Prompt Voice OFF | Turns off the device's voice prompts when the room is turned off. |
Volume Settings
| Property | Description |
|---|---|
| Current Volume | Current device volume (read only). |
| Volume when Turns OFF | Sets the volume when turning off. Useful for the device to keep serving audio to others over the network without playing in the room. With -1 the volume is not changed. For players built into the multiroom or connected to their inputs we suggest 99%; never do this on amplified players. |
| Max Volume Limiter | Limits the maximum volume when raised by Control4. |
Driver Update Info
| Property | Description |
|---|---|
| Last Server Version | Latest driver version available at 4drivers.com.br. |
| Server Version Notes | Notes about the latest available version. |
Network
| Property | Description |
|---|---|
| http-https | For WiiM use https; for the others, http (default). |
| Devices on Network | Scans the network for LinkPlay devices: choose Scan Devices, wait for the property to blink and select the device. The IP is filled in Device IP. |
| Device IP | Device IP, if you prefer to enter it manually. It must be fixed or reserved. |
| Polling Interval | Time between queries to the device. Longer times make media information slower to update. |
Info
| Property | Description |
|---|---|
| Driver Version | Driver version. |
| Device Name | Device name. |
| Connection Status | Connection state. After one minute without response the device is considered disconnected. |
Navigator Tabs
| Property | Description |
|---|---|
| Show Presets Tab / Show TuneIn Tab / Show Tidal Tab | Shows or hides each tab in Navigator. E.g. hide the Tidal tab if the client has no Tidal subscription. The change applies the next time the user enters the driver in Navigator. If all are set to No, the Presets tab is still shown. |
| TuneIn Favorites | Shared with other LinkPlay drivers (default): the favorite radio list is the same on every LinkPlay device in the project using this option. This device only: this device keeps its own list. |
Tidal
| Property | Description |
|---|---|
| Tidal Country Code | Country of the Tidal account (default BR). |
| Tidal Shortcuts | Search shortcuts shown in the Tidal tab, comma separated. |
| Tidal Account | Shows whether a Tidal account is connected to the driver (read only). |
Turning the room off: null input
When the room is turned off, the driver stops the music and switches the device to the input chosen in Switch INPUT on turn OFF. Since nothing is connected to that input, the device stays silent and no streaming keeps playing in the background.
- Choose an input that really exists on the device and is not in use. On most devices the best choice is Line In.
- Use Optical, HDMI or USB only if the device has that input: if the chosen input does not exist, the device simply ignores the switch.
On some devices, Tidal music started from Control4 keeps advancing after the stop command (muted) and may start playing again by itself, sometimes turning the room back on. With the right null input this does not happen. As a backup, after turning off the driver checks that the music really stopped and, if not, keeps insisting until it stops.
How to check on site
- Play a Tidal playlist from Control4.
- Turn the room off and wait about 1 minute.
- The progress bar must not keep moving and the music must not come back. If it does, change the input (for example from Optical to Line In) and test again.
Do not use the null input if the device serves audio to other rooms (for example, connected to a controller and distributing audio): set it to No, or Line In.
Browsing in Navigator
Presets
Plays the presets saved on the device. By default they are numbered; to rename, open the preset options and choose Rename Preset, or Rename with Current to use the name of what is playing. Presets are saved from the device's app.
TuneIn
- Browse by category, location and language, or use the Navigator search.
- Favoritos (Favorites): folder at the top of the TuneIn tab. To add a radio, open its options in any list and choose Adicionar aos favoritos. While a TuneIn radio is playing, the option is also at the top of the Now Playing queue (queue icon). To remove, use Remover dos favoritos.
- Up to 60 radios. With TuneIn Favorites set to Shared, the list is the same on every LinkPlay device in the project.
TuneIn radio list
Favorites folder
Tidal
- Search for albums, artists, tracks and playlists, configurable shortcuts and recently played.
- Artist page: top tracks, albums, EPs and singles (newest first), artist radio, playlists with the artist and similar artists.
- Collection (Coleção): playlists, albums, tracks and artists saved in the client's Tidal account.
- Save queue as playlist: while Tidal is playing, open the Now Playing queue (queue icon) and tap the top item. The playlist is created in the client's Tidal account with the queue tracks.
Tidal pause
Some LinkPlay devices ignore the pause command while playing Tidal tracks. So on the first pause the driver automatically tries, one by one, the ways of pausing the device accepts, checks that the music really stopped and remembers the one that worked on that device. From then on it uses the remembered method directly, with no new test.
On some models the only method that works is the null input (the same one used when turning off, usually Line In): the device is switched to that input, the sound stops and the screen shows the paused state. When you press Play, the same track resumes, from where it stopped when the device allows it (otherwise from the start of the track).
The first pause on each device may take a few seconds (sometimes close to half a minute) because of the test. This is normal and happens only once. For the null input method to work, Switch INPUT on turn OFF must point to an input the device really has.
Tidal search (artists)
Collection: account playlists
Navigator labels for TuneIn favorites and the Tidal Collection are currently in Portuguese.
Tidal: connecting the client's account
The client connects the account from the Control4 screen, without Composer access.
- In Navigator, open Tidal > Coleção > Conectar conta Tidal.
- Scan the QR code with the phone, or open 4drivers.com.br/tidal and type the code shown on screen.
- Sign in to Tidal on the phone. When "Pronto!" appears, go back to Control4 and tap Já fiz o login.
The account stays connected after driver updates and controller reboots. To change accounts, use Desconectar conta Tidal at the end of the Collection, or the Tidal - Disconnect Account action in Composer.
For playback, the device uses the Tidal account signed in on its own app. If a list does not start, Control4 shows "Tidal não iniciou no aparelho" (Tidal did not start on the device): check the account in the device's app.
Connections and Multiroom
Connections for the device's physical inputs (when available on the model): Line In, Optical and HDMI.
The LinkPlay Network 1, 2, 3... and Out To LinkPlays connections let Control4 understand audio distribution between players over the network. Connect the Out To LinkPlays output of one device to the LinkPlay Network inputs of the others that will be in multiroom.
Do not make these connections when the players are built into the multiroom (audio matrices) or connected to the inputs of those devices.
A source connected to one of the devices (TV or any audio) can be distributed to the others over the network.
Device receiving the TV or another distributed source: set Volume when Turns OFF to zero and Switch INPUT on turn OFF to No. The client can then turn this room off and keep listening in the others.
Showing sources in rooms
Keep visible only the device's own players (streaming, Bluetooth, USB), plus conventional sources connected to it or other players.
Programming actions and commands
| Action / command | Description |
|---|---|
| Play Direct URL | Plays a radio directly from the stream URL. Media information may not come and the device may keep the previous media info; to work around it, switch the device to some input, wait 2 s and then run the URL. |
| Presets | Plays a device preset from programming. |
| Show LinkPlay Configs | Lists the device settings in Composer's Lua tab. |
| Voice ON / Voice OFF | Turns the device voice prompts on or off. |
| Ch Select | Channel output (L, R). |
| Release All My Slaves | Releases every player grouped with this one. Good to make sure devices are standalone; can be used as a "release all" button. |
| Shuffle - Repeat | Repeat and shuffle mode. |
| Eq | Bluetooth only: equalizer modes. |
| Tidal - Disconnect Account | Disconnects the Tidal account from the driver. |
Programming example with Play Direct URL
Troubleshooting
| Symptom | What to check |
|---|---|
| Room turns back on by itself | Keep Auto Select Requires Play on Yes and check the null input. With Debug Mode on Print, the log shows the reason for each turn-on. |
| Music keeps playing after turning off | Set Switch INPUT on turn OFF to an input the device really has (usually Line In). |
| First Tidal pause is slow | Normal: on the first pause the driver tests the device's pause method. After that, pausing is immediate. |
| "Tidal não iniciou no aparelho" | Tidal account not signed in (or the wrong one) on the device's app. |
| Collection asks to connect | Connect the client's account in Tidal > Coleção. |
| Connection Status disconnected | Device IP, network, http-https (WiiM uses https) and Protocol. |
For support, set Debug Mode = Print, reproduce the problem and send the log to 4Drivers.
History
| Version | Changes |
|---|---|
| 1155 (2026-11-04) | New features: TuneIn built into the driver (browsing, search and Favorites shareable between the project's LinkPlay devices); Tidal built in (search, artist page, account Collection with on-screen QR code login, save the queue as a playlist, track cover and name in Now Playing); configurable Navigator tabs (Presets, TuneIn, Tidal); the room only turns on when the device really starts playing, with a quiet time after turning off; turning off confirms the device stopped; HTML documentation. |
| 1120 (2025-12-20) | Play Direct URL command. |
| 1115 (2025-10-08) | Progress bar and auto-switching fix. |
| 1111 (2025-06-28) | Renames the driver when installed. |
| 1110 (2025-05-21) | Ids reworked (see the update note). |
| 1091 (2025-03-19) | Auto-switching adjustments. |
| 1085 (2024-12-01) | Scan Devices and Presets in the interface. |
| 1067 (2024-04-08) | Room grouping adjustment. |
| 1060 (2023-12-25) | AutoOff property. |
| 1052 (2023-11-23) | https support for WiiM. |
| 1051 (2023-01-23) | Validation adjustments for OS 2. |
| 1024 (2022-07-03) | Multiroom mode fix. |
| 1023 (2022-06-18) | Voice OFF on start; AirPlay adjustment. |
| 1022 (2022-06-11) | Start room with AirPlay. |
| 1020 (2022-06-02) | Initial release. |
Update note (versions before 1110)
In version 1100 the internal connection ids were normalized. Input and multiroom connections between devices are lost in the update and must be redone: write down the connections before updating and reconnect them afterwards.