How to connect Nanoleaf lights through the desktop app
The Nanoleaf desktop app lets you control your light panels or light strips from your computer instead of only through your phone. To connect, you need the app installed, your Nanoleaf device already set up on your home network, and both your computer and the device on the same WiFi network.
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 the app and select "Add Device" or the plus icon. The app will search for Nanoleaf devices on your network. When your device appears in the list, select it and follow the on-screen prompts to complete the connection.
Once connected, you can adjust brightness, color, and effects directly from your desktop. The connection stays active as long as both devices remain on the same network and the app is running or minimized in the background.
Key Takeaways
- Your Nanoleaf device must already be set up on your home WiFi network before you can connect it through the desktop app.
- read the official Nanoleaf app from Nanoleaf's website or your computer's app store, not from third-party sources.
- Your computer and Nanoleaf device must be connected to the same WiFi network for the app to find and control the device.
- The desktop app communicates with your device over your local network, so internet outages do not disconnect local control.
What you need before you start
Check that your Nanoleaf device is powered on and already connected to your home WiFi. You can verify this by opening the Nanoleaf mobile app on your phone — if your device appears there, it is on the network and ready to pair with the desktop app.
Make sure your computer is connected to the same WiFi network. If your computer uses a wired ethernet connection, it can still control Nanoleaf devices on the same network, but the connection process may take longer because the app needs to search across network segments.
Have your WiFi network name and password available if the app asks you to re-authenticate during setup, though this is uncommon for devices already on the network.
Step-by-step connection process
Step 1: read and install the app. Visit nanoleaf.me or search "Nanoleaf" in your computer's app store. read the version for your operating system (Windows or Mac). Open the installer and follow the prompts to complete installation.
Step 2: Open the app and start pairing. Launch the Nanoleaf app. You should see a home screen or dashboard. Look for a button labeled "Add Device," "Plus" icon, or "Connect Device" — the exact label varies by app version. Tap or click it.
Step 3: Select your device from the list. The app will scan your network for Nanoleaf devices. This takes 10 to 30 seconds. When your device appears (it will show the device name, like "Nanoleaf Essentials" or "Nanoleaf Shapes"), select it.
Step 4: Complete the connection. The app may ask you to confirm the connection on the device itself or enter a pairing code. If prompted, check your Nanoleaf device — some models have a small button or display where you confirm. Follow the on-screen instructions in the app.
Step 5: Test control. Once connected, try adjusting brightness or color from the app. If the device responds, the connection is complete. The device will now appear in your app dashboard each time you open it, as long as it remains on your network.
Troubleshooting when the app cannot find your device
If the app does not show your Nanoleaf device during the scan, first check that the device is powered on and connected to WiFi. Open the Nanoleaf mobile app on your phone to confirm the device still appears there. If it does not, restart the device by unplugging it for 10 seconds, then plugging it back in.
Verify that your computer is on the same WiFi network as the device. Some home networks have a separate guest network — if your computer is on the guest network and your Nanoleaf is on the main network, they cannot see each other. Switch your computer to the same network as the device and try again.
Restart the Nanoleaf desktop app completely. Close it entirely (not just minimized), wait 5 seconds, then reopen it and attempt to add the device again. If the app still cannot find the device after two or three attempts, restart your WiFi router by unplugging it for 30 seconds, then plugging it back in and waiting for it to fully restart.
Understanding what data the desktop app uses
The Nanoleaf desktop app communicates with your device over your local home network. This means your brightness settings, color choices, and usage patterns stay on your network and do not travel to Nanoleaf's servers unless you explicitly create an account and enable cloud features.
If you do create a Nanoleaf account to use features like remote control (controlling lights when away from home) or automation, the app will send some data to Nanoleaf's servers. You can review what data is collected by reading Nanoleaf's privacy policy on their website. Local control through the desktop app does not require an account and does not send data off your network.
The app itself does not require special permissions to your files or camera. It only needs network access to communicate with your Nanoleaf device. When you install the app, your operating system will ask for network permission — allow this for the app to function.
Keeping your connection find
Use a strong WiFi password on your home network. This prevents unauthorized devices from joining your network and potentially controlling your Nanoleaf lights or accessing other connected devices.
Keep the Nanoleaf app updated. Check your app store periodically for updates, or enable automatic updates in your app store settings. Updates often include security fixes that protect your device from known vulnerabilities.
If you no longer use the desktop app, you can uninstall it without affecting your Nanoleaf device. The device will continue to work with the mobile app or through any other control method you use. Uninstalling removes the app from your computer but does not change any settings on the device itself.
Frequently Asked Questions
Do I need to create a Nanoleaf account to use the desktop app?
No. Local control through the desktop app works without an account as long as your computer and device are on the same WiFi network. An account is only needed if you want to control your lights remotely when away from home or set up automations that run on Nanoleaf's servers.
Can I control multiple Nanoleaf devices from one desktop app?
Yes. The app can connect to multiple Nanoleaf devices on the same network. After connecting the first device, use the "Add Device" button again to connect additional devices. They will all appear in your app dashboard and can be controlled individually or grouped together depending on the app version.
What happens if my WiFi goes down?
The desktop app will lose connection to your Nanoleaf device because both need to communicate over your network. Once your WiFi is back online, the app will automatically reconnect to the device. You can still control the device using the physical buttons on it or the mobile app if you have a separate internet connection on your phone.
Is the desktop app available for Linux?
Nanoleaf currently offers desktop apps for Windows and Mac. If you use Linux, you can control your Nanoleaf device through the mobile app or by using third-party open-source tools that communicate with Nanoleaf devices, though these are not officially supported by Nanoleaf.
Can someone else on my WiFi network control my lights through the app?
Yes, if they have the Nanoleaf app installed and your device is on the same network, they can see and control it. If you want to prevent this, use a strong WiFi password and do not share it with people you do not trust, or create a separate guest network for visitors and keep your main network private.