<p align="center"> <a href="https://github.com/keefo/NeewerLite"> <img src="Design/icon_128x128@2x.png" alt="Logo" width="150" height="150"> </a> </p> <h1 align="center">NeewerLite</h1>

About The Project

NeewerLite is a unofficial macOS app designed for controlling Neewer LED lights.

While Neewer provides official Android and iOS app for controlling their high-CRI LED lights via Bluetooth, they do not offer a means of control from a PC or Mac.

This project aims to fill that gap by creating a macOS app that allows you to control your Bluetooth-enabled Neewer LED lights from your Mac. With NeewerLite, you can even integrate light control into your Elgato Stream Deck or shortcuts for better experince.

Here is a video I made to demo the scene:

<p> <a align="left" href="https://youtu.be/pbNi6HZTDEc"> <img src="https://j.gifs.com/3Qz2Ox.gif" /> </a> <img src="screenshot.png" width="300px" /> </p>

Features

• Power On/Off control
• Brightness control
• Correlated color temperature control
• RGB color control
• Scene control
• Script support
• Sync RGB lights with music

How to install pre-build app

1. Download the latest dmg file from release page, double click the dmg to open it.
2. Then drag .app file in dmg to your application folder.
3. Go to application folder to double the app you just dropped from dmg.
4. once the app is running, it should has a icon in the status bar on the right top of you screen.

Script Usage

Open the app and let it scans all Neewer lights through Bluetooth. Once it finds lights. Then you could use command to switch On/Off lights.

Turn on all lights:

open "neewerlite://turnOnLight"

Turn off all lights:

open "neewerlite://turnOffLight"

Toggle all lights:

open "neewerlite://toggleLight"

Scan all lights:

open "neewerlite://scanLight"

Set lights CCT:

open "neewerlite://setLightCCT?CCT=3200&Brightness=100"

Set lights CCT+GM:

open "neewerlite://setLightCCT?CCT=3200&GM=-50&Brightness=100"

Most of light model support CCT range 3200K to 5600K, Some lights support long CCT range 3200K to 8500K. And some newer model of light support GM.

Set lights Hue and Saturation and Brightness:

open "neewerlite://setLightHSI?RGB=ff00ff&Saturation=100&Brightness=100"

open "neewerlite://setLightHSI?HUE=360&Saturation=100&Brightness=100"

Set lights to scene:

open "neewerlite://setLightScene?Scene=SquadCar"

open "neewerlite://setLightScene?SceneId=1&Brightness=100"

Scene Names: SquadCar, Ambulance, FireEngine, Fireworks, Party, CandleLight, Lighting, Paparazzi, Screen

Not all model follow these scene names. If your light support more scenes, you can use SceneId to switch.

SceneId Range from 1 ~ 17 depends on light type.

Turn on light by name:

open "neewerlite://turnOnLight?light=left"

The 'left' is the name I give one of my light. You could change your light's name in the app and use it in this command.

Another way to test these commands is to copy a command(the string in the double quote) into your browser address bar, and press enter.

Using the Elgato Stream Deck

You can control NeewerLite from your Stream Deck in two different ways:

1. Install the built-in Stream Deck plugin

   • NeewerLite will prompt you to install the plugin automatically.
   • Click Install when prompted, then open the Stream Deck app—our plugin will appear in your actions list.

<p> <img src="Docs/StreamDeck_dial_ui.png" width="300px" /> <img src="Docs/StreamDeck_dial.jpg" width="300px" /> </p>

2. Bind a custom script to a Stream Deck button
   • Write a simple shell, Python, or Node.js script that sends commands to NeewerLite’s open schema.
   • In the Stream Deck software, use the System → Open action (or Run action) to point at your script.
   • Assign your button an icon and label, then you’re ready to go!
   • Read this Integrate with Elgato Stream Deck for details.

How to use script to integrate with macOS Shortcuts?

Read this Integrate with Shortcuts

Voice Control Interaction

You could integrate these commands into Voice Control.

Open “System Preferences” -> “Accessibility” -> “Voice Control” -> “Commands”, Click the “+” button to create a new command, give a name to your new command such as “Meow” and choose “Any Application” then choose perform “Open URL”. Type in “neewerlite://toggleLight” for example.

Now, when you say “Meow” voice control will switch on/off your LED lights.

Tested Lights

• Neewer CB60 RGB Light
• Neewer 660 RGB Light
• Neewer 480 RGB Light
• Neewer RGB176 Light
• Neewer RGB 530 PRO Light
• Neewer RGB1-A Magnetic Handheld Light Stick
• Neewer SL90 Pro Aluminum Alloy RGB Panel Video Light
• Neewer BH-30S RGB LED Tube Light Wand

TO DO LIST

If you find a way to implement these features, feel free to create a pull request.

• [ ] Test more Neewer LED lights
• [ ] Add support for other Neewer LED lights
• [ ] Advanced scene management

How to add support for a new light?

If you are unable to find your Neewer light using NeewerLite, you can easily add support for it by following these steps:

1. Find your light bluetooth raw name.
2. Find light type value from NeewerLightConstant.getLightType function from bluetooth raw name.
3. Add new light type to the Database/lights.json file.

Here is an example of adding neewer-tl21c-rgb-magnetic-light-wand

The bluetooth raw name is should contain tl21c by checking NeewerLightConstant.getLightType function, it converts to light type 69.

Add this into database json file. Make sure it reflects what this LED light supports including, cct range, rgb support and scene effect support.

{
   "type": 69,
   "image": "https://github.com/keefo/NeewerLite/blob/main/Database/light_images/tl21c.png?raw=true",
   "link": "https://neewer.com/products/neewer-tl21c-rgb-magnetic-light-wand-with-app-control-66604585",
   "supportRGB": true,
   "supportCCTGM": false,
   "supportMusic": true,
   "support17FX": true,
   "support9FX": false,
   "cctRange": {
         "min": 25,
         "max": 85
   }
}

It does not recognize my RGB light as RGB light, what to do?

If you are have a Neewer RGB light but, the app does not show it as RGB light, then you could follow these steps:

1. Use a Bluetooth app to find the raw name of your light.
2. Check Database/lights.json file to find the light type section.
3. Check if supportRGB value is true.
4. If not, you need to rise a PR to update this value. Once PR is merged, app will get new database from github.

License

Follow NeewerLite, the code and examples of this project is released under MIT License.

Donations

If you would like to support me, donations are very welcome.

You can go fund this project through my sponsors page.

or

You can send bitcoin to this address:

1A4mwftoNpuNCLbS8dHpk9XHrcyvtExrYF