Viewer Page Documentation

Stagetimer viewer page
Stagetimer viewer page

The viewer link allows access to a fullscreen timer. It can be shared via link or QR code. You can also protect the link If you have a Pro subscription or Event license.

The viewer page displays the following features or information:

  1. Logo
  2. Title
  3. Timer
  4. Message
  5. Speaker
  6. Progress bar
  7. Viewer name
  8. Sound on/off button
  9. Mirror screen button
  10. Fullscreen mode
  11. Showing individual elements in isolation

The logo can be displayed in different positions based on your choice. This is set on the controller page by clicking on “Customize” at the top left corner. On “Custom logo” you can upload an image as JPG, PNG, SVG or Max 3 MB, adjust the size and position the logo on the screen. You can also simply hide the Stagetimer logo on the “General” section of the popup if you don’t want to display any logo at the timer.

The customize timer appearance popup allows you to custom the logo on the timer viewer
The customize timer appearance popup allows you to custom the logo on the timer viewer

2. Title

A title can be displayed or hidden at each timer by clicking on the pencil icon beside the title section of the timer on the controller page. When the “Hide” checkbox is selected, the title will be hidden on the timer viewer but will still be visible on the controller and agenda page. This option can be used so speakers are not distracted by so much information on the screen.

A title can be displayed or hidden by checking a box on the controller page
A title can be displayed or hidden by checking a box on the controller page

You can also use the bulk actions to choose between showing all titles or hiding them all. This is also done on the controller page by clicking on “Actions” at the top of the timer list.

Choose a bulk action to show or hide all titles
Choose a bulk action to show or hide all titles

3. Timer

The timer displayed on the viewer link will always be the set or active timer. The appearance or type of timer depends on the choices made on the controller page. You can choose to display a countdown, count-up, time of day or different combinations of timers by hovering the mouse under the duration section of each timer

Choose the appearance of the timer or a combination of timer and time of day on the controller page
Choose the appearance of the timer or a combination of timer and time of day on the controller page

To adjust the size of the timer, go to “Customize” at the top left corner and on the section “Text” you will be able to choose a font for the timer and customize the size of the timer in relation to the messages.

Customize the size and font for timers on the controller page
Customize the size and font for timers on the controller page

4. Message

The messages displayed on the viewer screen can be created and controlled from both the controller and the moderator page. With a Pro subscription or Event license, you can create unlimited messages and show them as needed.

Create and control messages on the moderator page
Create and control messages on the moderator page

You can also adjust the size of the messages in relation to the timer by clicking on “Customize” on the controller page. In the “Text” section of the popup, you can choose a font and resize the message as needed. These changes are only possible on the controller page.

Customize the font and size of messages on the controller page
Customize the font and size of messages on the controller page

5. Speaker

The name of a speaker can be displayed or hidden at each timer by clicking on the pencil icon beside the title section of the timer on the controller page. When the “Hide” checkbox is selected, the speaker/talent will be hidden on the timer viewer but will still be visible on the controller and agenda page.

The name of a speaker can be displayed or hidden by checking a box on the controller page
The name of a speaker can be displayed or hidden by checking a box on the controller page

You can also use the bulk actions to choose between showing speaker names or hiding them all. This is also done on the controller page by clicking on “Actions” at the top of the timer list.

Choose a bulk action to show or hide all speaker names
Choose a bulk action to show or hide all speaker names

6. Progress bar

A progress bar can be seen at the bottom of the timer. The wrap-up time can be customised at the individual timers by clicking on the settings gear icon on each timer. On the same popup, you also be able to choose a chime to alert the speaker or program the timer to flash at a specific wrap-up time.

Customise wrap up times and actions at the individual timer settings
Customise wrap up times and actions at the individual timer settings

If you prefer to apply a chime or flash all timers, this bulk action can be made by clicking on “Actions” on the same popup.

Apply a chime or flash to all timers by using the bulk action on the popup
Apply a chime or flash to all timers by using the bulk action on the popup

You can also remove the progress bar entirely by clicking on “Customize” at the top left corner, and then switching to “hide progress bar” on the top section of the popup.

Hide progress bar
Hide progress bar

7. Device name

The device name can be edited on the viewer screen at the top right or on the controller page. The name will show up in the “Connected Devices” list on the controller page. Hover with the cursor to reveal the edit field.

For each new connecting device a random name is generated. Except if you pre-define the name via URL parameter. See available URL parameters

The device name can be shown and edited at the top right corner of the screen
The device name can be shown and edited at the top right corner of the screen

8. Sound on/off button

If using chimes, the sound can be controlled at each individual viewer link by clicking the sound button at the top right corner of the viewer screen.

Sound on/off button on the viewer screen
Sound on/off button on the viewer screen

9. Mirror screen button

If using a teleprompter, you can invert the screen by clicking on the mirror screen icon.

Mirror screen button to use with a teleprompter
Mirror screen button to use with a teleprompter

10. Fullscreen Mode

To view the timer in fullscreen mode, click the last button on the top right corner of the interface.

Fullscreen mode button
Fullscreen mode button

Fullscreen on iOS Devices

iOS devices do not support browser-based fullscreen mode. However, you can achieve a similar effect using a simple workaround:

  1. Open the viewer link in Safari.
  2. Tap the “Share” icon at the bottom of the browser.
  3. Select “Add to Home Screen” from the share options.
  4. This action creates a home screen icon for the link.
  5. Opening the link from this icon will display it in fullscreen.
Share button on iOS Safari
Share button on iOS Safari

11. Isolation mode

Under certain circumstances you may need individual elements of the viewer in isolation. For example, if you want to import only the countdown into vMix or you need just the message to compose it yourself inside OBS. Stagetimer allows you to do just that.

Use URL parameters to isolate individual elements. If your viewer link is https://stagetimer.io/r/DEMO0002/, then append ?only=timer to isolate time timer like so: https://stagetimer.io/r/DEMO0002/?only=timer. The following list shows all available parameters and their effect.

You can pair these parameters with the transparent background option (available to Premium subscribers) to get the content of the page without the dark background.

Fullscreen mode button

12. Available URL parameters

The viewer page, also known as the fullscreen timer link, can be customized using URL parameters. These parameters allow you to change the appearance and functionality of the timer without having to go back to the controller page.

The available parameters are:

  • name: This parameter allows you to set a custom device name for the viewer page. The name will be displayed in the connected devices list on the controller page. This parameter accepts any text value. Defaults to a random generated name.
  • mirror: This parameter allows you to mirror the display of the viewer page. The possible values for this parameter are horizontal and vertical. You can use both values by separating them with a comma. For example, ?mirror=horizontal,vertical
  • hide: This parameter allows you to hide certain elements of the viewer page. The possible value for this parameter is controls, hiding the controls in the upper-right corner that appear when moving the mouse.
  • only: This parameter allows you to only show certain elements of the viewer page. The possible values for this parameter are header, footer, timer, message, and progress. Only one value can be used at a time. Read more …
  • key: Can contain the password when protecting the link on the controller page, it is required when accessing the viewer link with protection enabled.
  • delay: Add a delay in seconds. Different shared links can be on different delays.
  • background: Overwrite the background to use with hardware or software mixers (vMix, OBS). Options: transparent, green, purple, magenta

For example, if you want to name the device Stage, the URL should be as follows:

https://stagetimer.io/r/YOURROOM/?name=Stage

You can combine the parameters to customize the viewer page according to your needs. Use a & to chain parameter together. For example, you can set a key, mirror the display and hide the controls by using this URL:

https://stagetimer.io/r/YOURROOM/?key=ebyxa0je7nz0o7xn&mirror=horizontal,vertical&hide=controls

Please keep in mind that these are optional parameters, if you don’t specify them the default viewer will be loaded.