Butler Events

Butler Events allow you to automate the behavior of your paired Zigbee actuators. You can trigger actions based on schedules, content events, or manual commands — enabling your Digital Signage installation to interact with the physical environment.

Overview

An event consists of:

• Trigger — What causes the action (a time, a content change, a manual command, etc.).
• Action — What should happen (turn on a light, switch a power outlet, activate a motor, etc.).
• Target — Which paired actuator should perform the action.

Creating an Event

1. Log in to the viewneo CMS at cms.viewneo.com.
2. Navigate to Devices and select your Butler.
3. Open the Events tab.
4. Click Add Event to create a new automation rule.

Configure the Trigger

Choose the trigger type for your event:

Trigger Type	Description
Schedule	Trigger at a specific time or on a recurring schedule (daily, weekly, etc.).
Content Event	Trigger when a specific slide, playlist, or content item starts or stops playing.
Manual	Trigger on demand from the CMS dashboard.

Configure the Action

Define what should happen when the trigger fires:

• Turn On / Turn Off — Switch a power outlet or relay.
• Toggle — Switch the current state of the device (on becomes off, off becomes on).
• Set Brightness — Adjust the brightness of a dimmable light (if supported).
• Set Color — Change the color of a smart bulb (if supported).

Select the Target

Choose which paired actuator should receive the command. You can select a single device or multiple devices if you want the same action to apply to several actuators simultaneously.

Save the Event

Review your configuration and click Save. The event will become active immediately.

Example: Scheduled Lighting

A common use case is to turn on shelf lighting during business hours:

1. Trigger: Schedule — Monday to Friday, 08:00 AM.
2. Action: Turn On.
3. Target: “Shelf Lights - Store Front”.
4. Create a second event with Trigger: Schedule — Monday to Friday, 08:00 PM, Action: Turn Off, same target.

Example: Content-Synchronized Lighting

Highlight a product when its promotional content appears on screen:

1. Trigger: Content Event — When slide “Summer Promotion” starts playing.
2. Action: Turn On (or Set Color to a warm tone).
3. Target: “Spotlight - Product Display A”.
4. Create a second event with the same content trigger set to “stops playing” and Action: Turn Off.

Managing Events

Editing an Event

1. Navigate to the Events tab in your Butler settings.
2. Click on the event you want to modify.
3. Update the trigger, action, or target as needed.
4. Click Save.

Disabling an Event

You can temporarily disable an event without deleting it:

1. Open the event details.
2. Toggle the Active switch to off.
3. The event will remain in your list but will not fire until re-enabled.

Deleting an Event

1. Open the event details.
2. Click Delete Event.
3. Confirm the deletion when prompted.

Caution

Deleting an event is permanent. If you only want to stop an event temporarily, use the disable option instead.

Note

The Butler Plugin must be active in your viewneo plan to use events. If you do not see the Events tab, check your plan settings or contact your administrator.

Next Steps

• Manage Devices — View and manage your paired actuators.
• Butler Firmware — Keep your Butler firmware up to date.