Documentation

Activity Logs

Track every action taken during your event — timer starts, messages, session changes, and more. Activity Logs give you a complete audit trail of what happened, when, and who did it.

What Gets Logged

Tevyr automatically records over 40 different event types. Every significant action — whether triggered by a controller, by the system, or by an audience member — is captured with a timestamp and context.

CategoryEvents tracked
Timer controlsStart, pause, reset, time adjustments (+/−), scrub (jump to a specific time)
Session lifecycleStarted, completed, skipped, created, edited, deleted, reordered, extended, overage recorded
MessagesSent (with content), cleared
EffectsBlackout on/off, flash on/off, panic on/off, disco on/off
QuestionsReceived (with content), displayed on screen, dismissed, selected
ConnectionsController connected/disconnected, screen connected/disconnected
SchedulingEvent started, event completed, auto-play countdown started, scheduled start triggered, gap detected/resolved, conflict detected/resolved
Timing accuracyDelay recorded, early start recorded, break started, break forwarded to audience
On-spot timersStart, pause, reset
MacrosCreated, updated, deleted, executed, execution failed, execution cancelled, schedule created/updated/deleted, schedule fired, schedule skipped

Accessing Activity Logs

Open the Activity Logs modal from the controller. The modal shows a chronological list of all actions taken during the event, with the most recent entries at the top.

Real-Time Updates

Activity Logs refresh automatically every 5 seconds while the modal is open. A live indicator in the header confirms that real-time updates are active. Up to 500 log entries are displayed per session.

Log Entry Details

Each log entry contains:

FieldDescriptionExample
TimestampWhen the action occurred, shown as relative timeJust now, 2m ago, 1h ago
ActorWho or what performed the actioniOS App, Web Control, System, Audience
ActivityThe type of action that was performedtimer_start, message_sent, session_completed
SessionThe session associated with the action, if anyOpening Keynote
DescriptionA human-readable summary of what happenedTimer Started at 14:30
DataAdditional context specific to the action typeDuration, content, adjustment amount

Example Log Entries

[14:30:05] Web Control: Timer Started at 14:30

[14:32:12] Web Control: Time Added (+5s)

[14:35:00] iOS App: Message Sent: "5 minutes remaining"

[14:40:00] System: Session Completed — Opening Keynote

[14:40:01] System: Session Extended (Session ran 2m 30s over)

[14:40:05] Audience: Question Received: "When is the next break?"

Filtering

Filter logs to focus on specific sessions or controllers:

FilterOptionsUse case
SessionAll Sessions, No Session, or a specific session nameReview timing for a single presentation
ActorAll, iOS App, Web Control, System, AudienceSee only actions from a specific controller or device

Filters can be combined — for example, show only timer actions from the iOS App during the "Keynote" session.

Exporting Logs

Export your activity logs for post-event reporting, analysis, or archiving.

FormatHow it worksOutput
CSVClick the export button to download a CSV file. Respects current filters.activity-logs-2026-03-27.csv
ClipboardClick copy to clipboard. Logs are formatted as readable text.[14:30:05] Web Control: Timer Started

CSV Columns

The exported CSV file contains the following columns:

ColumnDescription
TimestampISO 8601 format (e.g., 2026-03-27T14:30:05.000Z)
ActorThe controller or system that performed the action
ActivityThe machine-readable activity type (e.g., timer_start)
SessionThe session name, if the action was session-specific
DescriptionHuman-readable description of the action
DataJSON-encoded metadata with additional context
Tip

Export your activity logs after every event. The CSV format opens directly in Excel, Google Sheets, or any spreadsheet app — making it easy to create post-event reports, track timing accuracy, or share execution data with clients and stakeholders.

Common Use Cases

Post-event reporting

Review exact timing for every session — when it started, how long it ran, whether it went over. Share reports with event organizers and sponsors.

Debugging issues

Identify what happened when a screen went dark or a timer behaved unexpectedly. Trace actions back to a specific controller and timestamp.

Multi-controller accountability

When multiple operators control the same event, see exactly who made each change. Each action is tagged with the actor (iOS App, Web Control, System).

Client deliverables

Provide sponsors and stakeholders with concrete data — how many sessions ran on time, total event duration, and a full timeline of actions taken.

What gets logged

Every action — manual or system-generated — is captured with sub-second timestamps. Automatic events like session completions, gap detections, and scheduled starts are logged by the system alongside operator actions. All logs persist in the database and remain available for export after the event ends.