Change settings
/api/settingsx-tempolight-token) while a PIN lock is set; without a lock, anyone can call it.Takes any part of the settings and answers them all: brightness, frame rate, light timing, low-power mode, ambient effect, sound capture, metronome, OSC, guest areas, location, night mode, text, MQTT (Home Assistant), Pro DJ Link, Ableton Link and DMX. The MQTT password is never sent back.
Request body application/json
brightnessnumber0 to 1fpsinteger10 to 120syncOffsetMsintegerLight timing for the sound output playing now (or output), -500 to 500 ms.
outputstringA sound output's key, for syncOffsetMs.
syncOffsetsmap of number | null{key: ms}, or {key: null} to forget one.
performancestring"auto" "full" "lite"ambientstringidleBrightnessnumber0 to 1idleAfterSecnumbersafebooleanpredictbooleandropFlashbooleanvariationsbooleanDrops change look every 2 bars (colour flip, mirror) between effect changes.
punchnumberHow hard the kick pumps the room in drops.
0 to 1dynamicsnumberHow much brightness follows the song part.
0 to 1audioSyncbooleanautoDiscoverbooleansetupDonebooleansongMemorybooleanmoodColoursbooleanrequestsbooleanshowsbooleanhearingobjectcaptureobjectmetronomeobjectoscobjectguestobjectlocationobject | nullnightobjecttextobjectmqttobjectdjlinkobjectlinkobjectdmxobjectResponses
200OKapplication/json
brightnessnumber0 to 1fpsinteger10 to 120syncOffsetMsinteger-500 to 500syncOffsetsobjectLight timing per sound output: {key: {ms, name, bt}}.
performancestring"auto" "full" "lite"ambientstringAn effect id or off.
idleBrightnessnumber0 to 1idleAfterSecnumber1 to 600safebooleanPhotosensitive-safe mode.
predictbooleandropFlashbooleanvariationsbooleanDrops change look every 2 bars (colour flip, mirror) between effect changes.
punchnumberHow hard the kick pumps the room in drops.
0 to 1dynamicsnumberHow much brightness follows the song part.
0 to 1audioSyncbooleanautoDiscoverbooleansetupDonebooleansongMemorybooleanmoodColoursbooleanrequestsbooleanshowsbooleanhearingobjectcaptureobjectmetronomeobjectoscobjectguestobjectWhat guests may do while a PIN lock is set.
locationobject | nullnightobjecttextobjectmqttobjectdjlinkobjectlinkobjectdmxobjecteffectPrefsmap of integerEffect id: 1 liked, -1 banned.
homekitobjectnowPlayingobject400The body isn't valid JSON, or a value is wrong.application/json
errorstringrequiredWhat went wrong, in a sentence for people.
403Locked, or not allowed.application/json
errorstringrequiredWhat went wrong, in a sentence for people.
curl -X PATCH 'http://localhost:8080/api/settings' \
-H 'content-type: application/json' \
-d '{
"fps": 50,
"night": {
"enabled": true,
"from": "23:00",
"to": "07:00"
}
}'const res = await fetch("http://localhost:8080/api/settings", {
method: "PATCH",
headers: { "content-type": "application/json" },
body: JSON.stringify({
"fps": 50,
"night": {
"enabled": true,
"from": "23:00",
"to": "07:00"
}
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.patch(
"http://localhost:8080/api/settings",
json={
"fps": 50,
"night": {
"enabled": True,
"from": "23:00",
"to": "07:00"
}
},
)
print(res.json()){
"brightness": 0.8,
"fps": 60,
"performance": "auto",
"ambient": "northern",
"safe": false,
"guest": {
"effects": true,
"scenes": true,
"pads": true,
"brightness": true
},
"location": null,
"requests": true
}{
"error": "Performance is auto, full or lite"
}{
"error": "Settings are locked. Unlock with the PIN in Settings."
}