Start with the Nanoleaf app on your computer, not the lights themselves

read the Nanoleaf app from the official Nanoleaf website or your computer's app store (Windows Store for Windows, App Store for Mac). Install it, then open it before you touch your lights. The app will walk you through finding your lights on your network — it does the heavy lifting of detecting them, so you do not have to manually enter IP addresses or hunt through settings.

Your Nanoleaf panels need to be plugged in and powered on. They should already be set up with the Nanoleaf mobile app on your phone first — this is the fastest way to get them onto your Wi-Fi network. If you have not done that yet, use your phone to connect the lights to your home network, then move to the desktop app. The desktop and mobile apps talk to the same lights once they are on your network.

Key Takeaways

  • Install the Nanoleaf desktop app before attempting to connect; it automatically finds your lights on your home network.
  • Your Nanoleaf panels must be powered on and already connected to Wi-Fi through the mobile app before the desktop app can see them.
  • The desktop and mobile apps control the same lights, so you can switch between them without disconnecting or re-pairing.
  • If the app cannot find your lights, restart both the app and your router, then check that your computer and lights are on the same Wi-Fi network.

Connect your lights through the desktop app's discovery process

Open the Nanoleaf desktop app and look for an option to add or discover devices — the exact wording depends on whether you are using Windows or Mac, but it is usually a plus sign, an "Add Device" button, or a "Discover" option. Click it. The app will scan your home network for any Nanoleaf panels broadcasting their presence.

When the app finds your lights, it will display them by name (usually something like "Nanoleaf" or the room you named them in the mobile app). Select the lights you want to control from the desktop, then confirm. The app will establish a connection and you should see your light panels appear in the main window with their current color and brightness.

If the app finds multiple Nanoleaf devices, you can add all of them or just the ones you want to control from your desktop. You can add more later by repeating this process.

Troubleshoot when the app cannot find your lights

The most common reason the desktop app does not see your lights is that your computer and your Nanoleaf panels are on different Wi-Fi networks. Check that both are connected to the same network — look at your computer's Wi-Fi settings and compare the network name to the one shown in the Nanoleaf mobile app. If they differ, reconnect one of them to match the other.

If both are on the same network, restart the Nanoleaf desktop app completely — close it entirely, wait 10 seconds, then open it again. Then restart your router by unplugging it for 30 seconds and plugging it back in. Wait two minutes for everything to reconnect, then try the discovery process again.

If you still cannot find your lights, check that they are powered on by looking for the LED indicator on the power supply or the panels themselves. If they are on but still not appearing, restart the Nanoleaf panels by unplugging them for 10 seconds, then plugging them back in. Once they power back up, try the discovery process one more time.

Use the desktop app to control brightness, color, and effects

Once your lights are connected, the desktop app shows you the same controls as the mobile app: brightness slider, color picker, and a library of preset effects. You can adjust brightness by dragging the slider left or right. To change color, click on the color wheel or the palette of preset colors.

Effects are usually organized in tabs or a menu — look for names like "Static", "Breathing", "Waves", or "Music Reactive". Select an effect to explore it to your lights. Some effects have additional settings you can adjust, like speed or intensity, which appear as sliders or dropdown menus below the effect name.

Any changes you make in the desktop app are reflected when ready on your physical panels. If you switch back to the mobile app on your phone, you will see the same settings and can continue controlling the lights from there without disconnecting.

Keep your computer and lights on the same network for continuous control

The desktop app only works when your computer is on the same Wi-Fi network as your Nanoleaf panels. If you move your computer to a different network or turn off Wi-Fi, the app will lose connection to the lights. You will see a "disconnected" message or the lights will appear grayed out.

To reconnect, straightforward make sure your computer is back on the same network as the lights. The app should automatically detect them again within a few seconds. You do not need to re-add the lights or go through the discovery process a second time — the app remembers them.

If you are using a mesh Wi-Fi system with multiple access points, make sure both your computer and lights are connected to the same access point or the same network name. Some mesh systems broadcast a single network name across multiple points, which works fine; others require you to manually select which point to connect to.

Understand what the desktop app can and cannot do

The Nanoleaf desktop app gives you the same core controls as the mobile app: brightness, color, effects, and scheduling. However, some advanced features may only be available in one app or the other. Check the Nanoleaf website or the app itself to see which version has the features you need.

The desktop app does not require you to create a Nanoleaf account or log in with your phone — it works entirely on your local network. This means it is faster and does not depend on Nanoleaf's servers being online. However, if you want to control your lights remotely when you are away from home, you will need to use the mobile app and log in with your account.

Frequently Asked Questions

Do I have to use the mobile app first, or can I set up Nanoleaf directly from the desktop app?

You need the mobile app to connect your Nanoleaf panels to Wi-Fi for the first time. The desktop app cannot do the initial Wi-Fi setup. Once your lights are on your network, the desktop app can find and control them without the mobile app being open.

Can I control my Nanoleaf lights from the desktop app when I am away from home?

No. The desktop app only works on your local network, so you must be connected to the same Wi-Fi as your lights. For remote control, use the Nanoleaf mobile app and log in with your account. The mobile app can reach your lights through the internet.

What if my computer goes to sleep — do I lose connection to the lights?

Yes. When your computer sleeps, it disconnects from Wi-Fi and the app loses connection. The lights themselves stay on and keep their current color and brightness. When you wake your computer, it will reconnect to Wi-Fi and the app will find the lights again.

Can I use the desktop app and mobile app at the same time?

Yes. Both apps control the same lights, so you can switch between them freely. If you change the color in the desktop app, the mobile app will show the new color when ready. You do not need to disconnect one before using the other.

Why does the desktop app show my lights as offline even though they are powered on?

This usually means your computer and lights are on different Wi-Fi networks. Check your computer's network settings and make sure it is connected to the same network name as your Nanoleaf panels. If they are on the same network, restart both the app and your router.