Music Scraper RTI Driver v1-50

Overview

The Music Scraper driver retrieves lyrics, artist information, and images based on now playing information from other RTI drivers such as Sonos, MusicCast, Spotify, or any music source driver.

How to Use This Driver

Step 1: Add the Driver

Add the Music Scraper driver to your Integration Designer project.

Step 2: Configure Source Driver Variables

In Driver Properties, link the Music Scraper to your music source driver's variables:

Artist Variable - Link to your source driver's artist variable

Example: Sonos Port > Now Playing Artist

Track Variable - Link to your source driver's track/title variable

Example: Sonos Port > Now Playing Title

Album Variable - Link to your source driver's album variable

Example: Sonos Port > Now Playing Album

Position Variable (Optional) - Link to elapsed time for synced lyrics

Example: Sonos Port > Elapsed Time

Position Is Milliseconds - Check if your source reports time in milliseconds

Is Playing Variable (Optional) - Link to play state for auto lyrics sync

The driver automatically monitors these variables and fetches lyrics/artist info when the track changes.

Polling Settings

Startup Delay - Seconds to wait before first poll (default: 60)

Poll Interval - Seconds between variable checks (default: 3)

Manual Input (Fallback)

If your source driver doesn't have linkable variables, you can manually enter track info:

Manual Artist - Artist name

Manual Track - Track name

Manual Album - Album name

These are only used when Source Driver Variables are not set.

API Keys Setup

To get artist images and biographies, you need free API keys from two services:

Fanart.tv API Key (for artist images, logos, banners)

1. Go to https://fanart.tv

2. Click "Sign Up" and create a free account

3. Once logged in, go to your profile settings

4. Find your Personal API Key

5. Copy the key and paste it into the driver's "Fanart.tv API Key" setting

Last.fm API Key (for artist biographies)

1. Go to https://www.last.fm/api/account/create

2. Sign in or create a Last.fm account

3. Fill in the application form:

- Application name: "RTI Music Scraper" (or any name)

- Application description: "RTI home automation driver"

- Application homepage: Leave blank or enter any URL

4. Click "Submit"

5. Copy the "API Key" (not the shared secret)

6. Paste it into the driver's "Last.fm API Key" setting

Note: Lyrics are fetched from LRCLIB which is free and requires no API key.

Licensing

This driver is sold through the Smart Home Programming Driver Store.

Driver Store: https://shpdrivers.services/store/

Your Account: https://shpdrivers.services/store/account.html

Free Trial:

The driver operates in a 2-hour trial mode without a licence key. The trial provides full functionality and resets each time the RTI processor is rebooted.

To Purchase:

1. Create an account at https://shpdrivers.services/store/

2. Add this driver to your cart

3. Enter your RTI processor MAC address during checkout

4. Complete payment and receive your licence key by email

5. Enter the licence key in the driver configuration

Functions

Lookup Functions

Lookup Now - Manually trigger lookup with current data

Lookup Artist - Lookup artist info only

Lookup Lyrics - Lookup lyrics only

Clear All - Clear all cached data

Image Controls

Next Image / Previous Image - Cycle through artist images

Start/Stop Image Rotation - Auto-rotate artist images

Lyrics Sync

Start/Stop Lyrics Sync - For synced lyrics display

Update Position - Update playback position for synced lyrics

Variables

Key variables available for display on your interfaces:

Source_ArtistName, Source_TrackName, Source_AlbumName

Artist_Bio, Artist_ImageURL, Artist_LogoURL, Artist_BannerURL

Lyrics_CurrentLine, Lyrics_NextLine, Lyrics_Plain

Status_Driver, Status_IsLoading

Notes

Lyrics are fetched from LRCLIB (free, no API key required)

Both synced and plain lyrics are supported

Artist images require a Fanart.tv API key for best results

Artist biographies require a Last.fm API key

Support

For bug reports, technical support, or feature requests, please use the ticket system in your account at the Driver Store.

Store: https://shpdrivers.services/store/

Email: david@smarthomeprogramming.com.au

Terms of Service

All drivers are provided "as is" without warranty of any kind. You use this software entirely at your own risk. A free trial is included so you can verify compatibility with your system before purchasing. Do not purchase a licence if you have not tested the driver on your hardware. For full terms including warranty disclaimer, limitation of liability, and refund policy, visit:

https://smarthomeprogramming.com.au/store/terms.html

Copyright 2026 Smart Home Programming. All rights reserved.