Skip to main content

Intro

Note

The Readerboard application is deployed on customer servers upon request. If you are interested in using this application, please contact our support team at [email protected].

Important

This custom application is under active development, so the information in the documentation may be outdated or incomplete, or may change completely in the future. If you encounter any issues or have any questions, reach out to our support team at [email protected].

The Readerboard application displays calendar and event data from various scheduling systems in a clean, paginated table layout. It is designed for digital signage, lobby displays, and room boards where real-time event information needs to be presented at a glance.

The widget automatically detects the calendar source type from the connected data source and normalizes events into a unified format with columns for time, event name, and location.

Features

  • Multi-Calendar Support - Automatically detects and normalizes data from 9 different calendar and scheduling platforms.
  • Automatic Pagination - Events are split across pages based on the available container height, with configurable page transition intervals.
  • Page Transition Animations - Supports fade and slide (in four directions) animations between pages.
  • Event Grouping - Group events by room, owner, or organization with styled group headers.
  • Event Filtering - Filter events by expiration status, date ranges (today, this week, this month, and more), or limit the number of displayed events.
  • Customizable Appearance - Full control over background, title, table header/body fonts, row colors, group header styling, and no-events fallback text.

Supported Calendar Sources

The Readerboard widget supports the following calendar and scheduling platforms:

PlatformDescription
Google CalendarGoogle Workspace calendar events
Microsoft CalendarMicrosoft 365 / Outlook calendar events
iCalendarStandard iCalendar (ICS) format events
NexudusCoworking space booking platform
Dean Evans EMSEnterprise event management system
Ad AstraHigher education scheduling system
Momentus EliteVenue and event management platform
25Live (CollegeNet)Campus event and space scheduling
Oracle OHIPOracle Hospitality event management
Standard FormatPre-normalized events using the widget's own StandardEventValues format

The calendar type is auto-detected from the structure of the incoming data. No manual configuration is required to select the calendar type.

If your data is already in the normalized event format (with title, startDate, startTime, etc.), you can pass it directly and the widget will use it as-is without any transformation.

Normalized Event Format

Regardless of the source, all events are normalized into the following fields:

FieldDescription
TitleThe name or subject of the event
OwnerThe organizer or person responsible for the event
OrganizationThe company, department, or group associated with the event
RoomThe location, room name, or venue of the event
Start DateThe start date in YYYY-MM-DD format
Start TimeThe start time in HH:MM format
End DateThe end date in YYYY-MM-DD format
End TimeThe end time in HH:MM format

The table display shows three columns: Time (start - end), Event (title), and Location (room).

Sensor Events

The Readerboard widget emits sensor events to communicate pagination state to external systems (e.g., other widgets or automation scripts). Sensor events are only emitted in displayer mode and are silently skipped in the editor.

These sensor events are emitted only when the Show page number setting is disabled, allowing external widgets to display pagination information instead of the built-in page indicator.

Event NameValue TypeDescription
currentPageNumbernumberThe current page being displayed (1-indexed).
maxPageNumbernumberThe total number of pages available.

Data Source

Read more about connecting and configuring data sources here.

Settings

Read more about all available settings here.


For further assistance, please contact [email protected].