Reference Triggers Elgato Camera Hub

Elgato Camera Hub triggers

Also on the Cuebot Docs site.

Connected

Runs when Cuebot starts looking after your webcams (you press Connect, or it connects on start). Webcam control only works on Linux for now.

Variables you get

Variable	What it holds
%backend%	The method Cuebot uses to talk to the webcams, like V4L2

Type id: elgato.cameraHub.connected

Disconnected

Runs when Cuebot stops looking after your webcams (you press Disconnect, or Cuebot closes the link).

Variables you get

Variable	What it holds
%reason%	Why it stopped

Type id: elgato.cameraHub.disconnected

Webcam Anti Flicker Changed

Runs when a webcam's anti-flicker setting changes (it stops lamps from flickering on camera). Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%antiFlicker%	The new setting: Off, 50 Hz, 60 Hz or Auto
%oldAntiFlicker%	The setting before the change

Type id: elgato.cameraHub.webcam.antiFlickerChanged

Webcam Auto Exposure Disabled

Runs when a webcam's auto exposure is turned off. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%autoExposure%	false (it is off now)

Type id: elgato.cameraHub.webcam.autoExposureDisabled

Webcam Auto Exposure Enabled

Runs when a webcam's auto exposure (it picks the brightness by itself) is turned on. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%autoExposure%	true (it is on now)

Type id: elgato.cameraHub.webcam.autoExposureEnabled

Webcam Auto Focus Disabled

Runs when a webcam's auto focus is turned off. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%autoFocus%	false (it is off now)

Type id: elgato.cameraHub.webcam.autoFocusDisabled

Webcam Auto Focus Enabled

Runs when a webcam's auto focus is turned on. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%autoFocus%	true (it is on now)

Type id: elgato.cameraHub.webcam.autoFocusEnabled

Webcam Auto White Balance Disabled

Runs when a webcam's auto white balance is turned off. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%autoWhiteBalance%	false (it is off now)

Type id: elgato.cameraHub.webcam.autoWhiteBalanceDisabled

Webcam Auto White Balance Enabled

Runs when a webcam's auto white balance is turned on. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%autoWhiteBalance%	true (it is on now)

Type id: elgato.cameraHub.webcam.autoWhiteBalanceEnabled

Webcam Brightness Changed

Runs when a webcam's brightness changes. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%brightness%	The new brightness (0-100)
%oldBrightness%	The brightness before the change

Type id: elgato.cameraHub.webcam.brightnessChanged

Webcam Connected

Runs when Cuebot finds a webcam that was not there before, for example when you plug one in. Webcam control only works on Linux for now.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0

Type id: elgato.cameraHub.webcam.connected

Webcam Contrast Changed

Runs when a webcam's contrast changes. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%contrast%	The new contrast (0-100)
%oldContrast%	The contrast before the change

Type id: elgato.cameraHub.webcam.contrastChanged

Webcam Device Orientation Changed

Runs when a webcam's mirror or flip setting changes. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%mirrored%	true if the picture is mirrored now
%flipped%	true if the picture is upside down now

Type id: elgato.cameraHub.webcam.deviceOrientationChanged

Webcam Disconnected

Runs when a webcam goes away, for example when you unplug it.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0

Type id: elgato.cameraHub.webcam.disconnected

Webcam Flipped

Runs when a webcam's flip (upside down) setting is switched on or off. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%mirrored%	true if the picture is mirrored now
%flipped%	true if the picture is upside down now

Type id: elgato.cameraHub.webcam.flipped

Webcam Focus Changed

Runs when a webcam's focus changes. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%focus%	The new focus (0-100)
%oldFocus%	The focus before the change

Type id: elgato.cameraHub.webcam.focusChanged

Webcam Live Shutter Speed Changed

Runs when the webcam changes its own shutter speed because auto exposure is on. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%shutterSpeed%	The new shutter speed, like 1/60
%oldShutterSpeed%	The shutter speed before the change
%exposure%	The new exposure time as a plain number (tenths of a millisecond)
%oldExposure%	The exposure time before the change, same units

Type id: elgato.cameraHub.webcam.liveShutterSpeedChanged

Webcam Live White Balance Changed

Runs when the webcam changes its own white balance (how warm or cool the colors look) because auto white balance is on. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%whiteBalance%	The new white balance in Kelvin
%oldWhiteBalance%	The white balance before the change

Type id: elgato.cameraHub.webcam.liveWhiteBalanceChanged

Webcam Mirrored

Runs when a webcam's mirror setting is switched on or off. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%mirrored%	true if the picture is mirrored now
%flipped%	true if the picture is upside down now

Type id: elgato.cameraHub.webcam.mirrored

Webcam Pan Changed

Runs when a webcam's picture is moved left or right (pan). Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%pan%	The new pan position (0-100)
%oldPan%	The pan position before the change

Type id: elgato.cameraHub.webcam.panChanged

Webcam Saturation Changed

Runs when a webcam's color strength (saturation) changes. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%saturation%	The new saturation (0-100)
%oldSaturation%	The saturation before the change

Type id: elgato.cameraHub.webcam.saturationChanged

Webcam Sharpness Changed

Runs when a webcam's sharpness changes. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%sharpness%	The new sharpness in the camera's own steps
%oldSharpness%	The sharpness before the change

Type id: elgato.cameraHub.webcam.sharpnessChanged

Webcam Shutter Speed Changed

Runs when you change a webcam's shutter speed (how long each picture is exposed) by hand. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%shutterSpeed%	The new shutter speed, like 1/60
%oldShutterSpeed%	The shutter speed before the change
%exposure%	The new exposure time as a plain number (tenths of a millisecond)
%oldExposure%	The exposure time before the change, same units

Type id: elgato.cameraHub.webcam.shutterSpeedChanged

Webcam Tilt Changed

Runs when a webcam's picture is moved up or down (tilt). Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%tilt%	The new tilt position (0-100)
%oldTilt%	The tilt position before the change

Type id: elgato.cameraHub.webcam.tiltChanged

Webcam White Balance Changed

Runs when you change a webcam's white balance (how warm or cool the colors look) by hand. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%whiteBalance%	The new white balance in Kelvin
%oldWhiteBalance%	The white balance before the change

Type id: elgato.cameraHub.webcam.whiteBalanceChanged

Webcam Zoom Changed

Runs when a webcam's zoom changes. Cuebot checks about every 2 seconds, so changes from other programs show up with a short delay.

Setting	What to put in
Webcams	Which webcam to watch, by the name Cuebot shows, like "Elgato Facecam" (its device path, like /dev/video0, works too). Separate several with commas. Leave empty for every webcam.

Variables you get

Variable	What it holds
%deviceName%	The name of the webcam
%deviceId%	The webcam's own ID number
%devicePath%	Where the webcam sits on your computer, like /dev/video0
%zoomValue%	The new zoom as a number (100 is the widest)
%zoomPercent%	The new zoom with a percent sign, like 150%
%oldZoomValue%	The zoom before the change, as a number
%oldZoomPercent%	The zoom before the change, like 100%
%maximumZoom%	The biggest zoom, 400

Type id: elgato.cameraHub.webcam.zoomChanged