Controller Page Documentation

Controler interface of Stagetimer


  1. Room title
  2. Customize timer appearance
  3. Timer preview
  4. Transport controls
  5. Connected devices
  6. Sharable links
  7. Timers
  8. Timer bulk actions
  9. Timer blackout
  10. License information
  11. Room menu
  12. Profile menu
  13. Messages
  14. Room progess

1. Room title

Room title

The room title is displayed in the top left corner of the screen. It shows up on the controller page, the agenda page and the moderator page. It's not required to be unique, but it's recommended to be short and descriptive.

2. Customize timer appearance

Customize time appearance

The customizer popup is responsible for the visual appearance of the timer. Here you can add a custom logo, change colors, fonts, text sizes, choose one of the background templates or upload your own background image. Check out this example of a timer with custom styling.

The progress bar can moved to the top, changed into a ring or hidden altogether.

One interesting feature is to show the next cue in header or footer of the screen.

Custom logos are available to all Pro users. Premium users get access to all customization options.

3. Timer preview

Timer preview

The timer preview is what the talent sees on their screen. Send the "Viewer Link" to your talent or open it on a separate screen. The timer by itself is pretty lightweight and easily runs on a Raspberry Pi, for example.

Below the preview is a small countdown monitor. This monitor always shows a countdown including fractional seconds. The small indicator is red when the timer is running.

4. Transport controls

Transport controls

The transport controls are the central place to control the timer and rundown. Here you can start, stop, reset and advance the timer.

The timleine works similar to a video editing software, you can click and drag the playhead to move forward and backward in time.

The "-1m" and "+1m" buttons allow you to tweak a running timer by adding or subtracting a minute. A dropdown menu gives you even finer control, from adding 10 minutes to subtracting a single second.

The timestamps always show the current time of day, when the current cue started, and when it finishes. The arrow keys switch to the start and finish timestamps of the entire event.

5. Connected devices

Connected devices

This is a list of all connected devices. A status indicator shows which page they see and if the device has connection issues.

Every new device gets a default name. You can change the names and kick devices out of the room by clicking on the three dots beside the status indicator. You also have the option to force-reload the browser window of connected devices remotely. This is useful if you have a device that is not working properly. Devices remember their name even after page reload.

Sharable links

These links are sharable with other people. They can be used to invite people to your room. The links are also available as QR codes. The following links are available:

The lock symbol allows you to protect the link with a secret. This way, if you share the viewer link, people cannot just guess the controller link by adding controller to the URL.

For the agenda and moderator links you can also choose to include the timer notes. This way, the notes will be visible to your team. The checkbox adds a parameter to the link itself. This way you can share a link without notes for the public and with notes for staff and producers.

Up to 3 devices can connect to an unlicensed room. Licensed rooms can connect an unlimited number of devices.

ūüĎČ Note: The viewer link allows you to use URL parameters like ?only=timer to isolate a specific element of the viewer. This can be helpful when you use the viewer page with vMix or OBS. Refer to the isolation mode documentation for more info.

7. Timers

Running timer

Timers are the primary element of the controler page. They are the main way to control the timer. You can add timers to the controler page by clicking the "Add timer" button. Each timer has a title, an optional start time and a duration. The settings popup also gives you further options for wrap-up actions.

The list allows you to edit, delete and duplicate timers. You can also drag and drop timers to reorder them. In addition, you can flash the message a few times with the flash button or trigger a full blackout, see timer blackout.

Start time

Start time setting

The start time is an optional setting. You can set it to a specific time or to a specific day. By default, the start time is always relative to the current time of day.

This settings comes with three triggers: "Manual", "Linked" and "Scheduled"

In "Manual" mode the start time is just a reference and has no function otherwise. You need to start the timer manually.

In "Linked" mode the timer starts automatically right when the previous timer finishes, regardless of the start time you entered.

In "Scheduled" mode the timer starts automatically at the specified time (and optionally date).


Duration setting

The duration is the most important setting for the timer. The duration is always required. Instead of a fixed duration you also have the option to define a finish time. In this case the duration is calculated automatically so the timer finishes at the given time.

Here you can also choose the timer appearance. You have the choice between "Countdown", "Count Up", "Time of Day" or a combination of these, and "Hidden". This defines how the timer is represented in the viewer window.

Title, speaker and notes

Title, speaker and notes

The title, speaker and notes are optional. You can leave them empty if you don't want to use any of them. The title is shown at the top of the timer window. The speaker is shown at the bottom. The field doesn't need to contain the talent name, it can also be used for other information. The notes are a place to write internal info. Notes are never shown to the speaker, but they can be displayed on the agenda and moderator pages.

Wrap-up times & actions

Wrap-up times and actions

The wrap-up time setting defines when the timer turns yellow and red to warn the speaker that they approach the end. This section is found by clicking on the gear icon. The wrap-up actions define what happens when the timer reaches the red and yellow stages, or zero. You can use chimes, and let the timer flash, to reinforce to the talent that they are about to finish.

8. Timer bulk actions

Timer bulk actions

The bulk actions allow you to perform actions on all timers at once.

9. Timer blackout

Timer blackout

The blackout button allows you to switch the viewer to complete black. This may be useful if you are capturing the timer with OBS or vMix, or you have a pause and don't want to cause any confusion.

10. License information

License information

The license information is in the top right corner. It shows if the room is licensed or not, and if it is licensed, who the owner is. Here you can also claim a room if it doesn't have an owner.

11. Room menu

Room menu

The room menu is a dropdown menu that provides several options that affect the entire room.


API popup

The Stagetimer API provides an easy way to remote control your timer with scripts and tools like Bitfocus Companion or vMix.

See the API documentation for more information


Logs popup

Logs are a great way to track the activity of your room. You can view the logs in the popup, or download them as a text file. Old logs are automatically deleted after a month.

CSV Import

CSV import popup

The CSV import popup allows you to import a CSV file with the timer data. CSV files can be exported from Microsoft Excel, Google Sheets and other tools.

The CSV importer tries to scan the structure of your CSV file. It's quite versatile and should understand almost any event rundown table, you do not need to adhere to a strict structure. You can fine tune the details in the second step commiting to the import.

The CSV importer is available in licensed rooms.

CSV Export

The CSV export popup allows you to export all timers to a CSV file. The CSV export is available in licensed rooms.

General timer settings

Master settings popup

The general timer settings popup provides settings for the entire room. These are different from the settings for individual timers.

Time Format

The time format is automatically adjusted to that of your browser. If you share the link with someone from another country they will see the time and dates in their local format. But you can also decide to explicitly set the time format for everyone to either 12-hour or 24-hour.

Time Of Day Format

This setting affects how the time-of-day is formatted in the viewer. By default the seconds are included, but you can choose to hide them if they are distracting.

When hitting 0:00

Choose the behavior when the timer hits zero, either if it continues counting overtime or stops at 0:00. This setting also works with the "Count up" mode.

Fractional Seconds

By default, the timer shows fractional seconds only during the last 10 seconds. But you also have the options to show them always or never.

12. User profile menu

User profile menu

The profile dropdown gives you quick access to the dashboard and other profile pages for logged-in users.

13. Messages


Stagetimer allows you to define messages which you can show to the speaker. Messages come in three signal colors, and you can make them bold and uppercase so they pop even more. You know how hard it is to get the attention of talent sometimes. So in addition, you can flash the message a few times with the flash button.

The message automatically adjusts the text size to fit on the screen.

14. Room progess

Room progess

The room progress bar shows the total progress of the current event in real-time. The number on the left shows the total time expired, and the number on the right shows the total time remaining.