Lumia Stream
Lumia Stream Integration
Section titled “Lumia Stream Integration”The Lumia Stream destination connects Now Playing to Lumia Stream via a dedicated plugin. When a new track plays, Now Playing pushes the track data to the plugin in real time, making the artist, title, BPM, key, and other fields available as Lumia variables. You can use those variables in alerts, light effects, and chatbot responses, creating a fully automated lighting and chat experience that follows your set.
What You’ll Need
Section titled “What You’ll Need”- Lumia Stream installed, running, and connected to your lights. Download it from lumiastream.com. A Lumia Stream account is required.
- The Now Playing plugin for Lumia Stream installed inside the Lumia Stream app.
- A connection token generated from your Now Playing dashboard.
Step 1: Install the Now Playing Plugin in Lumia Stream
Section titled “Step 1: Install the Now Playing Plugin in Lumia Stream”- Open the Lumia Stream app.
- Go to Settings then Plugins then Install from file.
- Select the Now Playing plugin file and install it.
Step 2: Generate a Connection Token
Section titled “Step 2: Generate a Connection Token”- Open the Now Playing dashboard and go to Connections then Destinations.
- Find the LumiaStream card and click Configure.
- Click Generate Token.
- Copy the token that appears.
Step 3: Paste the Token into the Plugin
Section titled “Step 3: Paste the Token into the Plugin”- In Lumia Stream, open the settings for the Now Playing plugin.
- Paste the token into the Connection Token field.
- The plugin connects automatically and begins receiving track updates.
Available Variables
Section titled “Available Variables”Once connected, the following variables are available in Lumia templates and alerts:
| Variable | Description |
|---|---|
np_artist | Current artist |
np_title | Track title |
np_album | Album name |
np_label | Record label |
np_genre | Genre |
np_bpm | BPM |
np_key | Musical key |
np_duration | Duration in seconds |
np_artwork_url | Artwork URL |
np_beatport_url | Beatport link |
np_apple_music_url | Apple Music link |
np_release_date | Release date |
np_remixer | Remixer |
np_isrc | ISRC code |
np_source | Track source (rekordbox, traktor, etc.) |
np_is_playing | Whether a track is currently playing |
Alerts and Chatbot Commands
Section titled “Alerts and Chatbot Commands”The plugin fires a New Track alert every time the track changes. You can attach this alert to any Lumia light effect, color change, or animation.
The plugin also adds chatbot commands that your viewers can use:
!songreplies with the current artist, title, key, and BPM.!artistreplies with the current artist along with genre and label if available.
Troubleshooting
Section titled “Troubleshooting”Plugin is not receiving track updates
- Confirm the connection token in the plugin settings matches the one shown in your Now Playing dashboard.
- Ensure the Now Playing desktop app is running and connected to your DJ software.
- Try generating a new token from the dashboard and updating the plugin settings.
Variables are blank after connecting
Variables populate the next time a track change occurs. Load a track in your DJ software to trigger an update. You can also use the Get Current Track action in Lumia Stream to manually refresh variables without waiting for a track change.
Plugin disconnects and does not reconnect
The plugin reconnects automatically after disconnections, with increasing delays between attempts (5 seconds, 10 seconds, 30 seconds, then 60 seconds). If it does not recover after several minutes, regenerate the connection token and update the plugin settings.