neewerlite 0.3.3

Python library for controlling all Neewer lights (Studio + Home) via Bluetooth LE.

NeewerLite v0.3.1

Python library for controlling all Neewer lights via Bluetooth LE:

• Studio lights (RGB62, RGB660, SL-80, GL1, etc.) — standard 0x78 protocol, 17 FX effects
• Home strips (NH-PD, NS02) — Neewer Home 0x7A protocol, music mode

Features

• Auto-detection : detects protocol (Studio vs Home) from device name
• Power control : on/off with state sync
• RGB / HSI : hue, saturation, brightness
• CCT : color temperature 2500K-8500K with optional GM tint
• 17 FX effects (studio) : lightning, paparazzi, cop car, candlelight, hue/cct loops, etc.
• Music mode (home strips) : microphone-reactive lighting
• Scanner : BLE discovery with signal strength sorting

Installation

pip install neewerlite

From source:

pip install -e .

Quick Start

Scan for lights

import asyncio
from neewerlite import NeewerScanner

async def main():
    devices = await NeewerScanner.scan()
    for d in devices:
        print(f"{d.name} ({d.address})")

asyncio.run(main())

Control a studio light (RGB62, SL-80, etc.)

import asyncio
from neewerlite import NeewerLight, NeewerEffect

async def main():
    light = NeewerLight("AA:BB:CC:DD:EE:FF", name="NEEWER-RGB62")
    await light.connect()

    # Power
    await light.turn_on()

    # RGB color (hue=0-360, saturation=0-100, brightness=0-100)
    await light.set_rgb(210, 100, 80)

    # White temperature (Kelvin, brightness, GM tint)
    await light.set_cct(5500, 80, gm=50)

    # FX effect with full parameters
    await light.set_effect(NeewerEffect.COP_CAR, brightness=80, color_mode=2, speed=7)
    await light.set_effect(NeewerEffect.CANDLELIGHT, brightness_min=10, brightness_max=80, cct=3200)
    await light.set_effect(NeewerEffect.HUE_LOOP, brightness=60, hue_min=0, hue_max=360, speed=5)

    await light.turn_off()
    await light.disconnect()

asyncio.run(main())

Control a Home strip (NS02, NH-PD)

import asyncio
from neewerlite import NeewerLight

async def main():
    light = NeewerLight("AA:BB:CC:DD:EE:FF", name="NS02_XXXX")
    await light.connect()

    await light.turn_on()

    # Color (hue, saturation, brightness 0-100 — auto-scaled to 0-1000)
    await light.set_rgb(120, 100, 80)

    # White temperature
    await light.set_cct(4500, 80)

    # Music reactive mode
    await light.set_music_mode(brightness=50, mode_id=0, speed=50, sensitivity=80)

    # Built-in scenes (73 available)
    await light.set_scene("Flamme", brightness=80)
    await light.set_scene("Arc-en-ciel", brightness=60)
    await light.set_scene(40)  # Noel

    await light.disconnect()

asyncio.run(main())

All 17 FX Effects (Studio Lights)

#	Effect	Parameters
1	Lightning	brightness, cct, speed
2	Paparazzi	brightness, cct, gm, speed
3	Faulty Bulb	brightness, cct, gm, speed
4	Explosion	brightness, cct, gm, speed, ember
5	Welding	brightness_min, brightness_max, cct, gm, speed
6	CCT Flash	brightness, cct, gm, speed
7	Hue Flash	brightness, hue, saturation, speed
8	CCT Pulse	brightness, cct, gm, speed
9	Hue Pulse	brightness, hue, saturation, speed
10	Cop Car	brightness, color_mode (0-4), speed
11	Candlelight	brightness_min, brightness_max, cct, gm, speed, ember
12	Hue Loop	brightness, hue_min, hue_max, speed
13	CCT Loop	brightness, cct_min, cct_max, speed
14	Brightness Loop	brightness_min, brightness_max, cct, hue, speed, cct_hsi_mode
15	TV Screen	brightness_min, brightness_max, cct, gm, speed
16	Fireworks	brightness, color_mode (0-2), speed, ember
17	Party	brightness, color_mode (0-2), speed

Using set_effect() with kwargs

await light.set_effect(NeewerEffect.EXPLOSION, brightness=80, cct=5500, gm=50, speed=7, ember=8)

Using individual FX functions (low-level)

await light.fx_cop_car(bri=80, color=2, speed=7)
await light.fx_candlelight(bri_min=10, bri_max=80, cct=3200, gm=50, speed=5, ember=5)

Direct protocol access

from neewerlite import fx_cop_car, fx_lightning, build_fx, NeewerEffect, FXParams

# Build raw packets
packet = fx_cop_car(bri=80, color=2, speed=7)
packet = build_fx(NeewerEffect.LIGHTNING, FXParams(brightness=80, cct=5500, speed=8))

Cop Car Color Modes

Mode	Colors
0	Red
1	Blue
2	Red + Blue
3	White + Blue
4	Red + Blue + White

Home Strip Scenes (73 built-in)

By name or ID

from neewerlite import HomeScene

# Find by name
scene = HomeScene.by_name("Flamme")
packet = scene.build_packet(brightness=80)

# Find by ID
scene = HomeScene.by_id(40)  # Noel

# Browse by category
nature_scenes = HomeScene.by_category("Naturel")
all_scenes = HomeScene.all()
categories = HomeScene.categories()  # ["Naturel", "Vie", "Festival", "Emotion", "Sport"]

All 73 scenes

Category	#	Scenes
Naturel (24)	1-24	Arc-en-ciel, Ciel etoile, Flamme, Lever du soleil, Coucher du soleil, Fleurs de cerisier, Foret, Maree de fleurs, Glacier, Vagues, Mer profonde, Luciole, Reflets ondules, Vagues de Ble, Etang de Lotus, Aurore, Desert Gobi, Printemps, Ete, Automne, Hiver, Meteore, Foudre, Pluie torrentielle
Vie (12)	25-36	Colore, Film, Tea Time, Reve, Loisirs, Technologie, Matin, Apres-midi, Feerie Lumineuse, Romantique, Fraicheur Estivale, Paresseux
Festival (7)	37-43	Fete, Anniversaire, Bal de promo, Noel, Halloween, Nouvelle annee, Feux d'artifice
Emotion (8)	44-51	Doux, Enthousiasme, Confortable, Mystere, Joyeux, Melancolique, Excite, Battement de coeur
Sport (22)	52-73	Dallas Football, New England Football, Kansas City Football, Madrid Soccer, Barcelona Soccer, Manchester Soccer, Paris Soccer, Munich Soccer, Los Angeles Basketball, Golden State Basketball, Chicago Basketball, Boston Basketball, New York Baseball, Los Angeles Baseball, Boston Baseball, Chicago Baseball, San Francisco Baseball, Toronto Hockey, Montreal Hockey, Chicago Hockey, New York Hockey, Las Vegas Hockey

BLE UUIDs

• Service: 69400001-b5a3-f393-e0a9-e50e24dcca99
• Write: 69400002-b5a3-f393-e0a9-e50e24dcca99
• Notify: 69400003-b5a3-f393-e0a9-e50e24dcca99

Device Name Patterns

• Studio: NEEWER-*, RGB62*, RGB660*, SL-*, GL1*, ZN-*, NW-*
• Home: NH-*, NS02*

License

MIT