Controller Documentation

Controler interface of Stagetimer

1. Timer preview

Timer preview

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

2. Countdown monitor

The countdown monitor provides feedback to the controller. Independent of the timer mode, this monitor always shows a countdown including fractional seconds. The small indicator is red when the timer is running.

3. Master settings

The master settings control how to disaply the time. The most important setting is the timer mode. There are three timer modes, "Countdown", "Count up" and "Time of Day". You can toggle them individually which allows you to display any of them together if you are so inclined.

Master settings popup

Next you can 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.

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.

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.

4. User profile

Profile dropdown

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

5. Timer presets

The primary interface to control the timer. Here you can define multiple timer presets, each with its uniqe set of options.

Timer settings popup

Each preset features a name that you can show to speakers or just use as internal reference.

There are four available triggers:

  1. Manual: The timer starts when you click the start button.
  2. Linked: The timer starts automatically right when the previous timer finishes.
  3. Scheduled: You can specify a time and date. If the time is in the future, the timer will start automatically.
  4. Until: The timer stars when you click the start button, but the duration is automatically adjusted so it finishes at the chosen time.

The wrap-up time setting defines when the timer turns yellow and red to warn the speaker that it apporaches zero.

Running timer

When a timer is running the interface changes slighty, showing information about the start and finish time. The duration of a running timer cannot be changed directly. However, it is possible to add and subtract minutes on the fly with the + and - buttons.

In addition to the individual settings there is a flash icon which allows you to flash the countdown a few times to catch the attention of the speaker. The eye icon can be used to hide just the timer, an alternative to the full blackout.

The interface also allows you to reorder individual timers and collapse them, if you have a lot of them and need a cleaner interface.

6. Message presets

Message preset

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 to make them pop even more. You know how hard it can be to get the attention of speakers sometimes, so in addition, you can also flash the message a few times with the flash icon.

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

7. Timer blackout

Blackout button

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.

8. 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 fonts, change the size of the timer and message, choose one of the background templates or upload a custom background. Check out this example of a timer with custom styling.

You can also hide the Stagetimer logo and the progress bar. The options of this popup are available to pro subscribers.

9. Sharable links

Sharable links

These are the links for the timer and controller that you can share with others. Up to 3 devices can connect to a room on the free version. For rooms owned by pro users, you can connect unlimited devices. The links are also available as QR codes.

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.

10. Connected devices

Connected devices

Here you see a list of all connected devices. A status indicator shows if the device has connection issues.

Every new device gets a random name. The name can be changed to help the controller identify the connected devices. A device will remember its name room even after page reload.