BulbScript-for-Wiz-Lights

KO | EN

gitlite — search

#ai #llm #go #android #rust #docker #macos #nodejs #kubernetes #awesome-list #pytorch #mcp #openai #open-source

BulbScript-for-Wiz-Lights

(★ 27)

BulbScript is a simple scripting language for controlling Philips Wiz Lightbulbs using the pywizlight library.

BulbScript-for-Wiz-Lights Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BulbScript for Wiz Lights

BulbScript is a simple scripting language used to control Philips Wiz Lightbulbs using the [pywizlight](https://github.com/sbidy/pywizlight) library. <br>
BulbScript can be used to *very quickly* create intricate lightbulb sequences with the help of functions, variables, and conditional statements, all without having to write any Python code. However, BulbScript also supports executing and getting returned values from custom Python functions, for those who are looking to create more advanced light sequences and routines.

<img src="https://user-images.githubusercontent.com/48174610/124525483-bf406700-ddff-11eb-8f87-406c2870df9e.gif" width="400" height="250"/>
This script and several other example scripts can be found in /BulbScript_scripts

<h3>Dependencies</h3>

- [pywizlight](https://github.com/sbidy/pywizlight)

<h2>💡Using BulbScript</h2>
1. Configure your broadcast space in config.py. (Default: "192.168.1.255") <br>
2. Run interpreter.py, this will execute the default BulbCode.bulb script. If your lights start slowly turning off and on, your broadcast space is set correctly. <br>
3. Create your own BulbScript script! Simply navigate to the /bulbScript_scripts directory and create a new .bulb file. Then open it in your favorite text editor and start coding! Make sure to read the documentation below and check out the other example script in the /bulbScript_scripts directory if you're struggling.<br>
4. Set the "loadedScript" variable in config.py to your new bulb script, and run interpreter.py. If everything is configured correctly, your script will be successfully executed. The script will infinitely loop until it hits a "stop" command. Alternatively, you can load a script by passing its name (not path, it MUST be in bulbScript_scripts!) as the first argument to interpreter.py.<br>
 
<h3>Note: BulbScript now supports indentation in scripts!</h3> <br>

<h2>⚠️BulbScript Limitations</h2>

As BulbScript is a small and simple interpreted scripting language with the sole purpose of controlling lightbulbs, it does not come packed with 'quality of life' features.
The interpreter expects you to write your code formatted exactly as in the example scripts and in many cases will ignore an incorrectly formatted line of code instead of throwing an exception.

<h3>BulbScript does NOT support</h3>

- Arrays, Lists, Vectors, etc
- Booleans. I did not see a point in implementing this, as integers will get the same job done.
- For Loops. However, a simple workaround can be found in "Loop Example.bulb".
- BulbScript function arguments and return values, however, you can still pass BulbScript values to a custom Python function and get the returned value
- Nested functions (but it does support nested conditionals!)

<h2>📖BulbScript Commands</h2>

**setrgb *'all/index of light'* (R, G, B)** <br>
```
setrgb all (255, 255, 255) //Sets the rgb value of all lights to (255, 255, 255) 
```

**setbrightness *'all/index of light'* *'int 1-255'*** <br>
```
setbrightness 1 50 //Sets the brightness value of the light at the index of 1 to 50 
```

**setscene *'all/index of light'* *'int 1-255'*** <br>
```
setscene all 4 //Sets the scene on all lights to 4
```
Supported scenes can be found [here](https://github.com/sbidy/pywizlight/blob/master/pywizlight/scenes.py) <br>

**setwhite *'all/index of light'* *warm/cold* *'int 1-255'*** <br>
```
setwhite all warm 50 //Sets all lights to a warm white with a brightness value of 50 
setwhite all cold 255 //Sets all lights to a cold white with a brightness value of 255 
```

**setoff *'all/index of light'*** <br>
```
setoff all //Turns all the lights off
```

**slp *float*** <br>
```
slp 0.5 //Waits for half a second before continuing 
```

**var *varName*** <br>
```
var exampleIntVariable = 50
var exampleFloatVariable = 5.5
var exampleStringVariable = Hello World!
```

**set *variable* *'variable/value'*** <br>
```
set exampleIntVariable 50 //Sets the value of exampleIntVariable to 50 
set exampleIntVariable exampleFloatVariable //Sets the value of exampleIntVariable to the value of exampleFloatVariable 
```

**add *variable* *'variable/value'*** <br>
```
add exampleIntVariable 50 //Adds 50 to the value of exampleIntVariable
add exampleIntVariable anotherIntVariable //Adds the value of anotherIntVariable to the value of exampleIntVariable
```

**sub *variable* *'variable/value'*** //Same as add but for subtraction <br>

**exec *functionName()*** //Executes a Python function from /user_functions/customFunctions.py <br>
//Note: The default BulbScript variable 'returned' will be set to whatever the custom function returns

**print** //Prints out whatever comes after it <br>
```
print Hello World! //Prints out "Hello World!"
print The value of X is *X* //Prints out "The value of X is " followed by the value of the variable 'X'
```

**rnd *variable* *int* *int*** <br>
```
rnd exampleIntVariable 0 500 //Sets the value of exampleIntVariable to a random number between 0 and 500
```

**if** and **end if** //Starts and ends an If Statement <br>
*Supported operators:* ==, >=, <=, >, <, !=
```
if x == 255 //Checks if x is equal to 255
 set y x //Sets the value of y to the value of x (255)
 set x 0 //Sets x to 0
end if //Ends the if statement
```
**func**, **end func**, and **call** //Starts, ends, and calls a function <br>

```
func lightsOff
 setoff all
end func

call lightsOff //calls lightsOff once, 'call lightsOff 2' would call it twice.
```

**stop**  //Stops the script so it will not loop indefinitely

BulbScript-for-Wiz-Lights

BulbScript-for-Wiz-Lights Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

BulbScript-for-Wiz-Lights

BulbScript-for-Wiz-Lights Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README