KUMA Dashboard — User Guide

A touch-first control and status screen for live events. It runs next to KUMA on a wide bar display, on the second screen of a dual-screen laptop, or in any browser on a tablet or phone. No experience with this kind of software needed: this guide starts from zero.

What KUMA Dashboard is

Think of Dashboard as a programmable control panel made of tiles. Each tile (we call it a box) can show a live value, change colour when something happens, and press a button when you tap it. You decide what the boxes show and where they sit, and you save the result as your own screen layout.

Dashboard gets its information from Bitfocus Companion. Companion is a free program from Bitfocus that connects to everything that talks to show equipment: video switchers, media servers, lighting desks, audio mixers, and anything else that connects to Companion. With the KUMA Timer module, to KUMA. Companion knows hundreds of live values called variables (for example the timer, the name of the running cue, which camera is on air). Dashboard reads those variables and draws them the way you want.

When you tap a box, Dashboard can press a button in Companion, which can then do anything Companion can do: start the timer, cut to a camera, fire a lighting cue. Companion does the work; Dashboard is the face.

What it is good for

Where to run it

Dashboard is designed for screens where you can touch things, but a mouse works the same way. Four common set-ups:

1. Beside KUMA on a wide bar screen

Wide bar displays (for example the 2560×720 Corsair Xeneon Edge) are made for this. KUMA runs as a slim full-height strip on one side, and Dashboard fills the rest of the screen, so the timer and your controls sit together on one display. Dashboard's wide-screen mode lines the two up for you, and it can even follow KUMA automatically (Beside KUMA).

2. On the second (touch) screen of a laptop

Dual-screen laptops such as the ASUS Zenbook Duo have a second, touch-sensitive screen below the main one. Put KUMA or your show software on the top screen and Dashboard on the bottom one: instant touch buttons for START, PAUSE, presets and cues, with the timer always in view. Any laptop with an extra touch monitor (a portable USB-C touch display works well) does the same job.

3. On a tablet or phone, in the browser

Dashboard has a built-in web server. Turn it on and the same screen opens in any browser on your network: an iPad on the production desk, a phone in the wings, a TV in the green room. Without a password the browser is view-only; with a password you can sign in and edit or press buttons from the tablet. See Web server.

4. On any computer with a mouse

Mac or Windows, in a normal window, or in full screen. Nothing needs to be installed on the show computer itself: Dashboard can run on a different computer, even on a different network from KUMA, as long as it can reach Companion.

Quick start (10 minutes)

1. Install Dashboard (macOS or Windows) and start it. Details.
2. Activate it with the same licence code you use for KUMA.
3. Connect to Companion: menu → LINK. If Companion runs on the same computer the default (127.0.0.1:8000) is already right. Details.
4. Build the screen: menu → SET → Build my dashboard. One press lays out every preset your Companion modules offer, in tidy columns (KUMA, ATEM, E2, routers…). Drag boxes where you want them. Details.
5. Add a button: New box, type START in the value, then ACTION → Press a Companion button and enter the page / row / column of the Companion button. Details.
6. Lock the layout with the padlock at the bottom of the menu. Boxes now react to taps. Details.

That is a working control panel. The rest of this guide explains each part and then shows how to make it look the way you want.

Installing and activating

Dashboard is a normal desktop application for macOS (Apple silicon) and Windows (10 / 11). Download the installer from the Dashboard section of the download page, install it like any other program and start it.

Activating

The first screen asks for your licence code. Enter the same 16-character code you use for KUMA Timer (for example AAAA-BBBB-CCCC-DDDD) and press Activate. The computer takes one Dashboard seat on your licence, and Dashboard opens. There is no separate trial: Dashboard needs a paid KUMA licence code (the free Lite version has no code).

• One seat per computer. A single licence has one Dashboard seat; a 20-seat site licence has 20. They are counted separately from your KUMA seats, so Dashboard never uses up a KUMA seat.
• Offline is fine. Dashboard checks the licence in the background and keeps working without internet for at least two weeks, so a venue with no connection is not a problem.
• Moving to another computer. Open menu → SYS → Licence → Give this seat back, then activate on the other computer. You can also release a seat in the licence portal under KUMA Dashboard seats. If every seat is in use, Dashboard tells you which computers hold them.

A first look

After activation you see a black canvas: this is your dashboard. Everything you build lives on it. All the settings are in one menu that slides in from the left.

• The round + button at the bottom right opens the menu (or press and hold on any box or empty space for about half a second).
• A small green dot at the top right shows that Companion is reachable (red when it is not).
• The menu has a slim rail of sections on its left edge, then the settings for the selected section.

At the top of the menu panel are Undo and Redo. Almost every change can be undone, so you can experiment freely.

Connecting to Companion

Open LINK. A new Dashboard already has one connection called Companion at 127.0.0.1:8000, which is right when Companion runs on the same computer. If Companion is on another computer, type its IP address and port instead (for example 192.168.1.60:8000). The address is shown at the top of Companion's own window.

• Status dot: green when Companion answers, red when it does not.
• Name: a short alias you can use in variables from several computers (see below).
• Star: the default connection. Boxes use it unless you say otherwise.
• Add connection for a second Companion (a second room, a second computer).
• Refresh rate in milliseconds: how often Dashboard asks for new values (300–500 ms feels live; the minimum is 100).
• Show connection status on screen: the little dots at the top right of the dashboard. Switch them off on a finished show screen if you prefer a clean look.

Your first box

Everything on a dashboard is a box. Let us build the most useful one: a live timer.

1. Open BOX and press New box. A box appears and is selected (a gold frame with handles). The settings for that box open below.

   

2. In Content → Value press + Insert variable…. The variable picker opens: on the left every module Companion knows (grouped by connection), on the right its variables with a plain description. Pick KUMA_Timer, type timer in the search box and tap timer.

   

3. The box now shows the live time. What you inserted is written in the Text (template) field as $(KUMA_Timer:timer). That is all a variable is: a name in $( ) that Dashboard replaces with the current value, several times a second.

   

4. Drag the box where you want it, drag a handle to resize it, and turn on Auto-fit text to the box so the number grows with the box.

You can mix text and variables in one box, for example Cue: $(KUMA_Timer:cue_name). If a value is missing Dashboard shows …; if Companion cannot be reached it shows ⚠.

Working on the canvas

Keyboard shortcuts

Shortcuts work while the layout is unlocked and you are not typing in a text field.

Hide is handy for boxes you only need sometimes: a hidden box is greyed out while you edit and completely invisible once the layout is locked.

Variables: drag any variable onto the screen

The VAR tab lists every variable of every connection, with a search field and a filter for one module.

• Drag a variable onto an empty part of the canvas: a new box appears there, with the variable as its value and its name as the title.
• Drag a variable onto a box: it is added to that box's text.
• Tap a variable: a box is added at the next free spot.

The settings window

Tap a box and its settings open in a window beside the canvas (on a wide enough screen), on the side where it covers less of the box, so you see the changes live. Drag it by its title bar; the × closes it (and deselects the box). Tapping a box shows its settings also while the SET or VAR tab is open. On a narrow screen the settings stay in the menu as before.

Box settings: Content

With a box selected the BOX section shows tools for the selection on top and four tabs below. Content is about what the box says.

Labels

A label is a small caption on one edge of the box, such as STATE above a status or PROGRAM on a camera tile. A box can have several labels. For each label you choose:

• the text (variables work here too, for example $(KUMA_Timer:cue_name)),
• its position: top, left, centre, right or bottom, and where it sits along that edge,
• Bar on or off: a bar draws the caption as a filled strip flush with the box edge (see the blue NOW strip in the screenshots), with its own colour (colour or variable) and thickness,
• rotation for vertical text, italic, UPPERCASE, size, letter spacing and text colour (Auto uses the box's own colour, dimmed).

Value

• Text (template): what the box shows. Type text and insert variables with + Insert variable….
• Edit text on the box lets you type directly on the canvas.
• Text colour and Size, or Auto-fit text to the box, which resizes the text to fill the box (recommended for timers).
• Alignment left / centre / right and top / middle / bottom.

Formatted text

Switch the text mode from plain to formatted to use a little mark-up: **bold**, *italic*, ~~strikethrough~~, colour with {#ff0000|red}, size with {150%|bigger}, and - item at the start of a line for a bullet list. Formatting also works on text that arrives from a variable. The Formatting cheat sheet in the menu always shows the rules.

Box settings: Style

Style is about how the box looks. It is divided into folding groups so the panel stays short.

Background

A colour (pick it, type a hex code such as #1f2937, or use a variable that holds a colour) and an optional two-colour gradient with an angle. Rules can override the background (see Rules).

Image and video

Put a picture or a looping video behind the text: pick a file from your computer (it is copied into Dashboard, so it keeps working even if you move the original), give a web address, or use a variable that holds an address. Choose cover (fill and crop), contain (show all) or stretch, and set the opacity. The video sits below the image. Images can be switched by rules (for example a different icon when something is on); videos cannot.

Border and shadow

Border width and colour, corner radius, shadow (none / soft / strong) and the opacity of the whole box. The opacity can also come from a variable between 0 and 100, for example to fade a box out as something finishes.

Progress bar

Turn a box into a bar that fills as a number changes: a countdown that empties, a media clip that plays, a fader level. Set the value (a number or a variable), what value means empty and what means full, the direction the bar grows, and its colour and opacity.

For a KUMA timer press KUMA timer: use KUMA's progress (%). It uses KUMA's own progress value (0–100) which is exact for any timer length and stays right even if Dashboard is started in the middle of a countdown. A line under the settings always shows what the bar is reading right now, so you can see at once if a variable or unit is wrong.

Text style

Bold, italic, a text effect (none / shadow / outline) for readability on pictures, letter spacing, and the font for this box (the default is the global font from VIEW).

Value animation

How a changing value appears: nothing, fade, slide or flip. Default follows the global setting in VIEW. Animations are skipped automatically if the computer asks for reduced motion.

Looks: restyle a box in one click

The Looks tab gives the box a complete ready-made look: panels with a coloured header band, cards, solid tiles, neon, glass, outline.

A look replaces the whole appearance (also a background image, video and effects you set before) and keeps the text, rules, action, size, font and progress bar. Colours set by a rule still win when the rule matches; the tab offers a button to clear them.

When you scale several selected boxes with the handles of their common frame, the labels, fonts, corners and borders scale with the boxes.

Box settings: Rules (make boxes react)

Rules are what make a dashboard come alive. A rule says: when this variable matches, change how the box looks. The first rule that matches wins, so put the most important one on top.

Example from the finished dashboard: the STATE box is grey by default, green while KUMA_Timer:status is RUNNING, orange for PAUSED and red for OVERTIME.

Each rule has:

• a variable (type it or tap … to pick it),
• a comparison: equals (=), not equal, greater / smaller (numeric), is empty, is not empty, contains, does not contain,
• a value to compare with,
• what to change when it matches: background colour, text colour, border colour, box opacity, the text itself (for example show no clip playing when nothing plays) and the image. Anything left empty (∅) stays as the box normally is.

Shortcuts for many rules

• Indicator from flag… builds an ON / OFF light in one step: pick a variable that is true or false and the box turns grey OFF and green ON.
• Add many rules copies the last rule and counts its variable up (source_1, source_2, source_3 …). Perfect for a box that must change for each of ten inputs.
• Find & replace in all rules changes a word everywhere, for example after you duplicated a box for another screen.

Rules for the whole screen

The page background can have rules as well (VIEW → Background). In the example the whole screen turns dark red while the timer is in overtime, which is hard to miss across a control room.

Box settings: Action (make boxes do something)

The Action tab says what a box does when you tap it while the layout is locked (see Locking).

Press a Companion button

Tell Dashboard which Companion button to press: the page, row and column of the button, exactly as you see them in Companion's Buttons view. If you have several Companion computers, choose which one (the default connection is used otherwise).

Go to a page

Switch the dashboard to the next, previous or first page, or to a particular page. Use it for a navigation strip.

Show on all pages

Tick Show on all pages for boxes that belong to the whole dashboard, such as a page-switch bar, a clock or a title strip. Otherwise a box lives only on the page where you created it.

Add to watch (Apple Watch)

The Action tab has a section Where it shows with Add to watch for every box. It marks the box for the Apple Watch app that comes with the iPhone app 1.1 (coming). The watch shows the ticked boxes as large equal cells, one grid per page, in the order of their position on the dashboard (top to bottom, then left to right; the size of the box does not matter). A box that presses a Companion button is a button; a box without an action, such as a clock or a status, is a read-only readout. A cell shows the first line of the box text with its colours and colour rules; images, progress bars and fonts are not shown. If no box is ticked, the watch gets every button that presses Companion.

The watch does not talk to Dashboard itself: it works through the paired iPhone, which must be near and connected to this computer's web server on the same network (set a password in the web server settings, or buttons cannot press), or through Relay when control is allowed. If the iPhone is out of range the watch keeps showing its last values.

Arranging many boxes

Select more than one box (drag a rectangle, or use Multi-select) and BOX shows alignment tools:

• Align left, horizontal centre, right, top, vertical middle, bottom.
• Distribute evenly horizontally or vertically (three or more boxes).
• Order: bring to front, forward, backward, send to back, for boxes that overlap.
• Duplicate and Delete. Delete all empties the page after a second confirmation press (“Sure?”).

Repeat as series

Need ten identical tiles for ten inputs? Build one, select it and press Repeat as series…. Dashboard makes numbered copies and counts the number in each variable up for you (preset_1_label, preset_2_label, …) and lays them out as a row, a column or a grid with the gap you choose. A preview shows the first and last variable before you press Create.

Save a selection as your own preset

Got a combination you will use again (a timer block, a camera tile)? Select its boxes and press Save selection as preset…. It is stored under My presets (next chapter) and can be added to any dashboard. The connection used becomes a placeholder, so the preset works with any connection of the same module.

Presets: build the screen in minutes

You do not have to build anything from scratch. Dashboard reads which modules your Companion has (a progress bar shows it when it starts) and offers boxes built from the variables your system really has: the number of sources, cards or screens is not typed in by you. Everything is in the SET tab of the menu, next to the canvas, so you can see the screen while you work.

Build my dashboard: one button

Press Build my dashboard at the top of SET. Dashboard adds the right boxes for every connection it recognised and lays them out in tidy columns, one group of presets under another. If the current page already has boxes, the result goes onto new pages (Dashboard, Dashboard 2, …), so nothing you made is touched. Ctrl/Cmd+Z takes the whole thing back in one step.

It leaves out the variants that would only repeat another preset (the big layouts, one tile per PowerPoint variable), so you get a clean base to arrange.

Drag a preset onto the canvas

Every preset shows a picture of what it will add. Drag it onto the canvas and it lands where you drop it, or press Add (it lands below what you already have, selected). Add all for… adds every preset of one connection. Reload from Companion reads Companion again after you add a module.

What the presets are

• Starter boxes (no module needed): Header + value, Name left, details right and Clock. Put your own variable in.
• Any module: a green OK / red PROBLEM tile that follows Companion's own connection status.
• KUMA Timer: Timer with progress bar, Status and cue, PowerPoint and TCR tiles, the two GFX buttons (below) and the layouts Layout: speaker timer and Layout: presentation.
• ATEM: program and preview per mix effect, keyers on air, aux outputs, and Layout: PGM and PVW monitor.
• Barco E2 / EventMaster: which input is on each screen, all cards in one OK / PROBLEM box (or one tile per card), power supplies.
• Routers: the input on each output, the selected destination in amber.
• My presets: select boxes, press Save selection as preset… in the BOX tab, and the next event is one drag away. The connection name in your boxes is replaced when you add the preset.

One box, two texts: a name on the left, details on the right

A box can have a second text, the right text (BOX → Content → Right text). It sits next to the main text and may have several lines. Left part % sets how wide the left side is, Right size the size of the right text (0 = fit to the space). A rule can replace the right text as well as the left one.

The two GFX presets (KUMA, for every connection that has PowerPoint variables) use it: the machine name on the left (taken from the connection, GFX_1 becomes GFX 1), on the right SLIDE X/Y and under it BUILD X/Y. The second preset adds a third line, TCR: XX:XX:XX, for connections that have a TCR variable. Name left, details right in the starter boxes is the same box for your own variables, for example PB A with the cue and the time left.

A button that shows what is on air

For an output (a PGM, a screen, GFX 1) you often want one button that lights up for the source that is on it and shows details of that source, for example which PowerPoint machine is on air and its slide and build. SET → Button: what is on air builds it:

1. Pick the variable that says what is on air (for example the ATEM program input) with the $ button.
2. Press Rows from KUMA PowerPoint: one row for every KUMA connection with PowerPoint variables, with the name on the left and SLIDE and BUILD on the right. Or press Add a source and fill a row in yourself (when it is / contains a name, a colour, the left text, the right text).
3. Press Add the button. Two small pictures show it with nothing on air and with the first source on air.

Add it again for the next output and change the title and the watched variable (Find & replace, below, helps). The older recipe in One box, many sources does the same by hand with rules.

One box, many sources: what is on PGM and PVW of a screen

A very common question in a production: what is on the LED wall right now, and what is waiting in preview? The answer is not one variable. A video processor such as a Barco E2 or EventMaster tells you, for every input, on which screens it is currently in program or preview. With 20 inputs that is 20 variables, and any one of them can be the answer. Dashboard solves this with one box that has one rule per input, and it has a shortcut so you do not enter the 20 rules one by one.

The idea

The E2 module in Companion gives every input two variables that list the screens it is on, for example eventmaster:source_4_pgm_destinations holds Screen LED while input 4 is in program on that screen (and is empty otherwise), plus its name eventmaster:source_4_name. (eventmaster is the connection name; yours may differ, pick the variables with … as usual.) The box looks at all inputs in turn. The first input whose list contains the screen name wins, and the box shows that input's name:

• variable source_N_pgm_destinations contains Screen LED,
• then show the text $(eventmaster:source_N_name) and colour the box red.

When nothing matches, the box keeps its normal look (grey, with a dash). If two inputs are on the same screen at once (a key over a background), the rule that is higher in the list wins, because the first matching rule wins.

Build it

1. Make the box with New box. Give it a value of — (shown when nothing matches), a big font and a bar label such as LED · PGM ("Content" tab).
2. Add the first rule (RULES → + Rule): variable eventmaster:source_1_pgm_destinations, comparison contains, value Screen LED (type the screen name exactly as the module reports it), background red, and as the rule's text $(eventmaster:source_1_name).

   

3. Add the other 19 at once. Scroll down to Add many rules, type 19 in More rules and look at the preview: it shows the last rule and the range that will be created (source_2_pgm_destinations … source_20_pgm_destinations). Press Add 19 rules.

   

   The copies keep the comparison, value and colour, and the number in the rule's text counts up together with the variable, so rule 7 reads source_7_pgm_destinations and shows $(eventmaster:source_7_name). Count by is the step, useful when inputs are numbered 1, 3, 5.

   

4. Look at the result. With input 4 in program on the LED wall the box shows its name:

   

Make the PVW box, and the same for a second screen

You do not repeat any of this. Duplicate the box (the duplicate icon in the BOX tab, or Ctrl/Cmd+D) and use Find & replace in all rules at the bottom of the Rules tab on the copy:

Finally change the bar label of the copy (Content tab) to LED · PVW. Four boxes, two screens, program and preview, and every one of them follows all 20 inputs:

Other uses of the same trick

• Router or matrix: one box per destination, one rule per source (destination_N_source, text is the source name).
• Several things in one box: end the rule list with a rule on a different variable (a warning, a fault flag). Put it at the top so it wins over everything else.
• Several sources at the same time: if one box must show two inputs (for example a key and a background), make two boxes, or use Repeat as series to lay out one box per input.
• Share the panel: SYS → Configuration → Save writes the whole dashboard into one file. Load it on another computer to get the same panel, then only change the connection in LINK.

Pages

One screen is rarely enough, so a dashboard can have several pages, like tabs. Open PAGE to add (+), rename, reorder (◀ ▶) and delete pages. Deleting a page deletes its boxes, after a confirmation press. Switch pages by tapping the page in this list, or with a box whose action is Go to a page.

Look of the whole screen (VIEW)

The VIEW section affects the entire dashboard.

Font

Choose the default font or import your own (ttf, otf, woff, woff2), for example your event's brand font. Imported fonts also appear in every box's own font list.

Scaling and design width

Dashboard draws your boxes on a canvas that is scaled to the width of the window, so a layout looks the same on a small laptop and on a large display. The design width (default 1280) is the width of that canvas in pixels. The height follows the shape of the window:

So: draw each page for the screen it will be shown on (a page for the bar, a page for the tablet). Use Use current canvas width to match the design width to the window you are working in.

Background

The colour of the page (or a variable that holds a colour), colour rules (change the whole screen when something happens, such as red in overtime), and an optional background image or video.

Animations

The default animation for changing values (none, fade, slide, flip), smooth colour changes, smooth image changes and the duration. A single box can override the value animation.

Locking: from editor to control panel

While unlocked, tapping a box selects it. While locked, tapping a box does its action (presses the Companion button or switches the page), the menu is gone and nothing can be moved by accident. Lock the layout before the show.

• Lock: press the padlock at the bottom of the menu rail.
• Unlock: press and hold the padlock button at the bottom right for one second. A ring fills up and the padlock pops open. The hold is deliberate: nobody unlocks it by an accidental tap in the dark.

Make a screen that always looks right

• Keep the big read-outs (timer, status) big and the touch buttons at least about 80 pixels on the canvas.
• Use colour with rules rather than text alone, so state is visible from across the room.
• Switch off Show connection status on screen only when you trust the link. The dots are a free early warning.

Web server: tablets, phones and TVs

Open WEB (desktop app) and switch on Enable web server. Dashboard now serves your screen to every browser on the same network. The addresses to open are listed right there, for example http://dashboard.local:8080 or the computer's IP address. Type one into the browser of an iPad, a phone or a smart TV.

• Port (default 8080) and Name (the .local name, default dashboard).
• Password: without one, every browser is view-only (it can look at the dashboard but not change it or press buttons). Set a password and browsers can sign in with the small key button to edit and press.
• Require the password to look at the dashboard too: off by default. When it is on, nothing is shown or pressed without the password: a browser (and the Dashboard app for phones and tablets) first shows a sign-in screen and only then loads the dashboard, its pictures and its live updates. Use it on a venue network, on a network shared with the audience, and for the mobile app. It needs a password to be set.
• The password is stored only as a salted hash; failed sign-ins are slowed down automatically.
• The server listens on your local network only while it is enabled.

Changes made on one device show up on the others a moment later, so you can edit on the laptop and watch the tablet update. A browser works like the app, with two differences: the WEB section and the window options (wide-screen, auto-fit) exist only in the desktop app.

One page on a screen: add ?page=2 to the address to show one page (a page number, name or id). The address follows the page you open, so a reload or a copied link stays on it. On a touch screen, swipe left on an empty part of the canvas to open the menu.

Using the iPhone, iPad, Apple Watch or Android app instead of a browser? The mobile guide shows how to connect, use the panel and set up alerts.

Relay: watch the dashboard from outside the network

New in Dashboard 0.1.0-rc.9.

The mobile apps (iPhone, iPad, Apple Watch, Android) connect through Relay as well; the mobile guide walks through the app side step by step.

The web server above is for screens on the same network as the computer. Relay is for everyone else: a client in another city, a producer in the hotel, a second screen on mobile data. They open a web page, type a code and a password, and see your dashboard live. It is view only unless you also allow control, and it is off until you turn it on.

Turn it on

1. Open the menu, go to WEB and scroll to Relay (outside this network).
2. Press Turn on Relay…

3. Read the seven lines and tick every one. The Turn on Relay button stays grey until all are ticked. This is on purpose: Relay makes your computer reachable from outside, and the lines say what that means.
4. Choose when it should turn itself off (4, 12 or 24 hours) and press Turn on Relay.

Share it

While Relay is on, a red RELAY ON flag shows in the corner of the screen with the number of viewers, and the menu shows three things:

• Pairing code: four letters and digits, for example AB2C.
• Password: sixteen letters and digits, new every time you turn Relay on. It is generated for you; it is not a password you choose.
• Viewer page: https://www.kumatimer.app/dashboard-view/. Copy link copies it with the code already in it.

Send the link and the password by different routes (for example the link by email and the password by a message). Anyone who has both can see your screens.

Turn it off with Turn off Relay. It also turns itself off when the time you chose runs out and when you close Dashboard.

What the viewer sees

The viewer opens the page, types the code (the link already has it) and the password, and presses Connect.

Then the dashboard appears, with the same layout and live values. If the dashboard has several pages, tabs at the bottom switch between them. On a phone the page scales to fit.

If the host goes quiet, the page shows No update from the host and keeps the last values until it hears again.

Allow control: let viewers press buttons

In the Relay dialog, below the seven lines, there is a separate checkbox, Allow control. It is off unless you tick it. With control on, the people who have the pairing code and the password can press the buttons of your dashboard (the boxes whose action is Press a Companion button) from anywhere. That can switch video, audio, lights or anything else Companion controls, so give the password only to people you trust with that.

• A viewer presses a box, and Dashboard looks the button up in your own dashboard. Only buttons you placed can be reached; other Companion buttons cannot.
• The flag on the screen says RELAY ON · CONTROL ON, and the Relay section keeps a viewer log of the last presses (who, which box, whether it worked).
• You can switch control on or off while Relay stays on (the checkbox in the Relay section). Switching it on asks you to accept the warning again.
• Limits: at most five presses per second from one viewer and twenty in total. Hidden boxes and boxes without a press action cannot be pressed.
• On the viewer page the buttons are clickable only when control is on. A small note shows Pressing… and then Pressed, or the reason it did not work (for example Companion not answering).

Good to know

• View only unless you allow control. Without it buttons do nothing on the viewer page, and the tap actions of your boxes are not even sent. With control on, a viewer can press the buttons you placed (see above).
• Private. The dashboard is encrypted on your computer with a key made from the password. The relay server only forwards it and cannot read it. It does see that a connection exists (the address it came from, the time and the pairing code); that is kept in its logs for a limited time.
• Not sent: the addresses of your Companion connections, imported fonts, and images or videos in boxes and in the background (the viewer shows the boxes without them).
• One server, no backup. Relay is a convenience. Do not rely on it for anything where late or missing information causes harm, and keep a local way to operate your show.
• A few viewers at once (up to five for one code).
• Wrong codes. If someone tries many wrong pairing codes from one network, that network is blocked for an hour. A venue Wi-Fi shares one address, so do not let people guess codes.
• While Relay is on, Dashboard reads the variables of all pages from Companion, not only the visible one, so viewers can open any page.

If something does not work

• This pairing code is not online yet. Relay is not on, or Dashboard is closed or asleep. Turn it on; the viewer connects by itself when it appears.
• Wrong password. Type the password again (letters in any case, dashes optional). A new password is made every time Relay is turned on, so an old one will not work.
• Too many wrong pairing codes. Wait an hour, or use another network (for example mobile data).
• No update from the host. The computer lost its internet connection or went to sleep. Keep it awake; it reconnects by itself.

Wide-screen mode: Dashboard beside KUMA

On a screen that is much wider than it is tall (2.3 : 1 or wider, such as a 2560×720 bar display) Dashboard shows a wide-screen button at the bottom of the menu rail. Tap it (or press Ctrl/Cmd + Shift + D anywhere) to turn the mode on: the window loses its title bar, takes the full usable height of the screen and snaps to a slot, so it can stand next to KUMA's own wide-screen strip.

Right-click the button, or press and hold it, to choose the options:

Beside KUMA needs KUMA on the same computer and uses KUMA's address from SYS → KUMA address (it works out the port by itself). In KUMA, switch on its own Wide-screen kiosk and choose where its strip sits; Dashboard fills the rest.

The mode is remembered and restored at start only while a wide screen is connected, so a laptop that is sometimes undocked is not left with a strange window. SYS → Window → Auto-fit window height to the screen additionally keeps a normal window from running off a short screen.

System: licence, files and updates

• Licence: your licence type, the seat Dashboard holds (for example seat 1 of 1), the code (partly hidden) and how long Dashboard keeps working offline. Give this seat back frees it to use on another computer.
• KUMA address: only for the Beside KUMA wide-screen mode (host and, optionally, port). Leave the port empty to find it automatically.
• Window → Auto-fit: keeps the window within a short screen.
• Window → Keep the screen awake: on by default. Like a slide show, Dashboard keeps the display and the computer from going to sleep while it is open, so a panel on the production desk does not go dark in the middle of an event. Switch it off if you want the normal power settings. In a browser tab (tablet, phone) Dashboard asks the browser for the same; browsers only allow that on a secure address (https or localhost), so on a plain http:// address on your network set the tablet's own auto-lock to Never for the event.
• Configuration → Save / Load: saves everything (pages, boxes, connections, imported images, videos and fonts) into one file and loads it back. Use it as a backup and to move your dashboards to another computer.
• Updates: Dashboard checks for a newer version by itself a little after it starts and every few hours. When there is one, Download and install fetches it (the version is shown), and Restart and install finishes the job. Nothing is installed without you pressing it, so a show is never interrupted by an update. Updates are installed on the computer that runs Dashboard; a tablet or phone just follows. Dashboard 0.1.0 RC4 and older cannot update themselves: install RC5 or newer once by hand.

Load & add (next to Load) adds the boxes of a saved file to the current page and keeps what you have; Load replaces everything. Keep this window above other applications (desktop app) keeps Dashboard on top.

The licence never stops you from working. KUMA Dashboard comes with your KUMA Timer licence (one Dashboard seat for every KUMA Timer seat) and may be used at commercial events, in client work and in paid productions.

Recipes for event production

Practical set-ups, from the simplest to a full multi-screen show. The finished example dashboard in this guide is built from these pieces.

1. Stage manager's panel

Goal: one screen that tells you the time, the state and the next cue, and lets you run the show with your thumb.

1. Add Timer with progress bar and Status and cue from the KUMA presets and make the timer the largest box.
2. Add rules to the timer: red when KUMA_Timer:overtime is true, orange when KUMA_Timer:progress is below 12.
3. Add START, PAUSE and RESET boxes with Press a Companion button pointing at the KUMA buttons in Companion; add boxes for your presets (5, 10, 15 minutes) with the same action.
4. Add a cue list: five boxes with $(KUMA_Timer:cue_1_name)…cue_5_name (or build one and Repeat as series). Give each a rule that highlights it when KUMA_Timer:cue_index equals its number.
5. Lock the layout. Put the screen where the stage manager can reach it.

2. Video operator's page

1. Add program and preview tiles from the switcher's presets (or two boxes with $(atem:pgm1_input) and $(atem:pvw1_input)), with a red and a green border and a bar label PROGRAM / PREVIEW.
2. Add the KUMA timer as a thin box with a progress bar, so the operator sees the clock without leaving the page.
3. Add source buttons and CUT / AUTO / FTB with button-press actions.
4. Give the page its place in the navigation, with a Go to a page box that is shown on all pages.

3. Status wall for technicians

Open SET and press Build my dashboard (or Add all for… for each connected module). Every module gets an OK / PROBLEM tile and modules with more detail (power supplies, cards) get their own tiles. Arrange them in a grid with the alignment tools. A single glance tells you which device dropped out.

4. Producer's tablet

Enable the web server, add a page drawn for the tablet's shape and open the address in the tablet's browser. Leave the password empty for a view-only status screen, or set one so the producer can also press buttons.

5. Confidence screen in the green room

Show the timer large, the running cue name and the clock on a TV or monitor through a browser in full screen. No password, no buttons, just information.

6. Several rooms, one screen

Add a connection for each Companion computer (LINK → Add connection, give each a clear name). Use the picker to pick variables from each: Dashboard writes the right alias for you. One screen can now show the main stage, the breakout room and the registration desk.

Troubleshooting

Still stuck? Write to support@kumatimer.app with a screenshot and a copy of your saved configuration file.

Tips

• Build once, then duplicate and change. Duplicating a box and using Find & replace in all rules is faster than starting over.
• Use Undo freely; use Save (SYS) before big changes.
• Name your Companion connections clearly; the names appear in the picker and in aliases.
• For readable timers: Auto-fit, bold, a high-contrast colour, and a rule for overtime.
• A progress bar behind the numbers shows how much time is left at a glance, even when you cannot read the digits.
• Keep one page per screen shape; scale the same layout up only if the screens have the same shape.

Glossary

Related: KUMA wide-screen kiosk · KUMA Companion module · Wide-screen walkthrough (blog) · Download Dashboard