LuvLink App Setup
Setting up your Friendship Lamp takes about five minutes. Your lamp sets itself up over Bluetooth, so the first thing to do is turn Bluetooth on for your phone or tablet — the lamp then appears in the LuvLink app on its own, and there is nothing to type in.
This article walks through the whole thing, from plugging the lamp in to the three green ticks that mean it is ready.
How groups work — read this first
Your lamps talk to each other through a group. Everyone who wants to send and receive colors has to be in the same group, so one thing is worth getting right before you begin:
- One person creates the group. Only one. They get a GroupID — a short code like
yourname_ab12. - That person shares the GroupID with everyone else, by message or email.
- Everyone else chooses "Connect to an existing Group" and enters that same GroupID. They do not create one.
> If you each create your own group, your lamps will not be connected. Both lamps will work. > Both will look correctly set up, with the three green ticks. But nothing will pass between them, > because they are in different groups. This is the most common reason a new pair of lamps does not > talk to each other — and it is invisible from inside the app, so it is worth checking first.
Setting a lamp up as a gift? Create the group on your own lamp, then send the GroupID along with the gift so the other person can join it rather than starting their own.
Not sure whether you already have a group? See Checking your GroupID — you can view it in the app without resetting anything.
Before you start
Make sure you have:
- Bluetooth turned on for your phone or tablet
- Your phone within range of the Wi-Fi network you want the lamp to use
- The LuvLink app downloaded on your iOS or Android phone
- An account created, and you are logged in
Your lamp needs a 2.4 GHz Wi-Fi network. Most routers broadcast both 2.4 GHz and 5 GHz; a lamp cannot join a 5 GHz-only network.
If your router uses one name for both bands — common on mesh systems, where 2.4 GHz and 5 GHz share a single network name — your phone may sit on 5 GHz and the lamp will not be able to follow it. Two things fix this:
- Move further away from the router while you set the lamp up. Your phone drops back to 2.4 GHz as the 5 GHz signal weakens.
- Or turn the 5 GHz band off in your router settings just for setup, and turn it back on afterwards.
Step 1: Turn it on
Plug the lamp in with the USB cable, into a USB charger or a laptop.
The lamp turns blue, and after a few seconds it settles on dim red. Dim red means it is in setup mode and waiting for you.
Step 2: Tap "+ Add Device"
Open the LuvLink app and tap + Add Device. The app then asks about your group.
- Joining someone who already has lamps set up? Choose Connect to an existing Group and enter the GroupID they shared with you.
- First lamp in a brand-new group? Choose Create a new Group.
If you are not sure which of these you are, go back to How groups work above. Choosing the wrong one is the single most common setup mistake.
Step 3: Your GroupID
If you created a new group, a GroupID is generated for you. Copy it with the copy button, and use the share button to send it to everyone you are connecting lamps with — they will need it to join.
Step 4: Select your lamp
Check that your lamp is still dim red. If it already is, skip this step and go straight to the app.
If it is not, touch and hold your finger on the silver touch plate on top, and keep it there without lifting off. The lamp will usually settle on dim red well within a minute. Allow up to 3 to 5 minutes — that is the longest it should ever take, not the normal wait.
The lamp often cycles through several colors on the way. That is normal — keep holding. Occasionally it will not cycle at all, which is also fine.
Infinity and Infinity Voice lamps reset differently. There is no top sensor pad to hold. Insert a pin into the small reset hole underneath the lamp instead.
Your lamp then appears in the app over Bluetooth. Just select it — there is nothing to type in.
If your phone shows a Bluetooth Pairing Request, accept it. Setup cannot continue if it is dismissed.
If your lamp does not appear here, skip to If your lamp does not appear over Bluetooth below.
Step 5: Connect to Wi-Fi
Select your Wi-Fi network, enter your Wi-Fi password, and press SAVE.
Two things stop most setups at this step:
- Passwords are case-sensitive. Watch for a capital letter added by your phone's auto-capitalization, and for a space on the end.
- Pick the 2.4 GHz network if your router lists both bands separately.
Then be patient. The app works through the connection steps and shows you ticks as it goes. Count the ticks — they tell you exactly where you are:
- Three green ticks — you are connected. The lamp swirls green as it comes online, then you are ready to go. Tap go to the dashboard, and see Connecting to the Lamps in Your Group for sending your first color.
- Two green ticks — the lamp is waiting to be approved. This is expected when you are joining somebody else's group. Your lamp turns yellow and waits for the group's admin — whoever created the group — to approve it, and they get a notification. See My Lamp Is Yellow, or the App Says "Pending".
- A "Wi-Fi Failed" or "Connection Failed" message — unplug the lamp and plug it back in first. Do this before you reset anything. The app often reports a connection error when the lamp has in fact joined your network successfully; power-cycling the lamp and refreshing the app dashboard clears it. Only if that does not work, go on to Troubleshooting Common Error Messages.
- Fewer than three ticks, and you were not joining a group — the lamp did not connect. Work through Troubleshooting Common Error Messages, which covers the exact messages the app shows.
Once setup is complete the lamp swirls green. That means it is connected and ready to send and receive colors.
If your lamp does not appear over Bluetooth
This is the most common thing to go wrong, and it is nearly always one of the four below. Work through them in order.
- Is Bluetooth actually on, and is the app allowed to use it? Check your phone's own settings, not just the app. On both iOS and Android an app can be denied Bluetooth permission separately, so check the LuvLink app's own permissions while you are in there. On Android you also need Location Services (GPS) turned on — Android will not let an app scan for nearby devices without it, even though the lamp has nothing to do with your location.
- Is the lamp dim red? A lamp that is any other color is not offering itself for setup. Unplug it, plug it back in, and if it does not come back to dim red, hold the top sensor for 3 to 5 minutes (or use the pin, on an Infinity).
- Forget the lamp and start again. If you have set this lamp up before, your phone may be holding on to a stale pairing:
- In your phone's Bluetooth settings, find the lamp — its name starts with FriendLamp (Infinity on an Infinity lamp) — and tap Forget or Remove.
- In your phone's Wi-Fi settings, look under saved or known networks for a network whose name also starts with FriendLamp, and forget that too.
- Close the LuvLink app completely, reopen it, and start again at + Add Device.
- Move the phone and the lamp closer together, and try once more.
If the app gives you a named error — Connect to Device Failed, Unable to Join the Friendlamps Network, or Failed to Connect to WiFi — go straight to Troubleshooting Common Error Messages, which deals with each one.
Older, non-Bluetooth lamps
Not every lamp we have sold uses Bluetooth. If yours is an older one, the app asks you to identify it instead of finding it: enter the MAC ID from the sticker on the base of the lamp, or select it from the list. Everything else — the group, the Wi-Fi, the ticks — is the same.
If the sticker has gone, we can work the number out for you. See What Is the MAC ID and How Can I Find It?
If you cannot see anywhere to enter the MAC ID
It is there — it is just not in the Bluetooth flow. The app searches over Bluetooth first, and an older lamp will never be found that way, so the search fails and it looks as though there is no other option.
When the Bluetooth search finishes without finding your lamp, look at the bottom of that screen and choose Legacy Setup. That is where you enter the MAC ID. It is on both iOS and Android.
If you have already tried several times and seen nothing but the Bluetooth search, you have not done anything wrong. Legacy Setup only appears once the search has given up.
If you still cannot find it, or the MAC ID is not accepted, contact us with your MAC ID, your GroupID and your LuvLink account email address and we will register the lamp to your group for you.
What you can do in the app
The LuvLink app is your control center for the lamp. From it you can:
- Set up devices
- Manage your group
- Change the lamp color
- Create Color Codes
- Extend the Dimming Time
- Adjust Brightness and Dimness levels
- Set a Sleep Timer
- Create or join GroupIDs
- Connect to a second group
- Update device information
- Manage time zones
- Enable Message Notifications
- Update firmware
You may be asked to update the firmware during or after setup. You can do that at any time from Settings > Firmware in the app.
You only need the app and Bluetooth for setup. Once the lamp is connected, it works on its own — you can change its color and send colors with the top sensor, and receive colors from your group, with no phone involved at all.
Still stuck?
Contact us, choose Lamp Troubleshooting, and include:
- Your GroupID
- The lamp's MAC ID, from the sticker on the base
- Your LuvLink account email address
- A screenshot of the last step you can get to in the app
You do not type the MAC ID in during setup any more, but it is still how we identify your lamp — with it we can look at your lamp from our side, which usually saves a round of questions.