Bitfocus AS
logo
logo
Bitfocus AS
logo
logo
Sign upSign in

Loading...

Bitfocus

Subscribe to our newsletter

The latest news, articles, and resources, sent to your inbox.

FacebookInstagramGitHubYouTubeLinkedIn

Products

  • Buttons
  • Companion

Integrations

  • Supported Devices
  • Developer Community
  • Connection Development

Support

  • Support Overview
  • Documentation
  • Video Tutorials
  • Community Forum

Sales

  • Resellers & Integrators
  • Buttons Pricing

Updates

  • Case Studies
  • Events & Trade Shows
  • Press Releases
  • Product Updates
  • Webinars

Legal

  • Legal Overview
  • Privacy Policy
  • Buttons EULA
  • Terms & Cookie Policy

Company

  • About us
  • Press kit
  • Careers

© 2026 Bitfocus AS. All rights reserved.

Find your way around Buttons
Docs for
Overview
Getting started
What is Bitfocus Buttons?
Install Buttons and get started
Manage your Buttons license
Activate Buttons offline
Find your way around Buttons
Create your first backup
Add an ATEM connection
Choose a control method
Choose an installation path
Install Buttons on Debian or Ubuntu
Understand HA clustering
Kubernetes HA
Update or remove Buttons
Positions
Understand positions
Create a position
Add controls and sections to a position
Create your first button
Use a connection's presets
Build more capable button actions
Add more feedback to a button
Organize controls in a section
Shift Section
Organize controls with a Folder Section
Add a Popover Section
Build and reuse a Shared Section
Build a Router Section
Understand Custom Routers
Custom Router panel
Surfaces
Surface compatibility
Add and attach a surface
Device orientation
Connections
Update a connection's module safely
Monitor and troubleshoot a connection
Router integrations
VideoHub and AJA KUMO
Utah Scientific BPS
Generic SW-P-08
Nevion VideoIPath
Arkona BLADE//runner
Routing
Physical routing
Configure ports and labels
Take a physical route
Understand route status
Topology graph
Routing Presets
Get started with virtual routing
Configure Nested Shapes
Reverse routing
Tielines
Routing Projects
Routing settings
Troubleshoot a route
Tally
Understand the Tally system
Send ATEM tally and labels to a UMD
Interpret Active Tally state
TSL/UMD connections
Diagnose tally problems
NMOS
Understand NMOS in Buttons
Connect Buttons to an NMOS Registry
Built-in Registry Server
Configure NMOS connections
Discover and adopt
Browse the NMOS inventory
Manage NMOS multicast addresses
Diagnose NMOS problems
Understand Cuelists
Build a Cuelist
Read and advance a running Cuelist
Control a Cuelist from a Position
Workflows
Understand workflows
Build your first workflow
Reuse a group of workflow nodes safely
Troubleshoot a workflow
Recipes
Sequence a timed automation
Call an HTTP endpoint from a workflow
REST endpoint
Use variables
Understand variable scope
Understand nested variables
Update expressions for v1.8
Plan and use Tags
Access
Create and manage users
Create roles and assign permissions
Grant access to specific resources
Show different controls by role
Sessions
Set up PIN and NFC sign-in
SSO
Get started with SSO
Connect a generic OIDC provider
Connect LDAP or Active Directory
Map identity claims to roles
Secure a Buttons deployment
Integrations
External control
Connect to Bitfocus Listener
USB Relay
Install USB Relay on Windows
Install USB Relay on macOS
Install USB Relay on Linux
Install USB Relay on a Raspberry Pi
Get started with the Control API
Secure and monitor the Control API
Control API reference
API reference
Administration
Enable and manage installable features
Services and health
Configure and monitor scheduled backups
Restore a backup and verify it
Export or import Buttons configuration
Store and rotate connection secrets
Replace the HTTPS certificate
HA backup and recovery
Settings
Collect support information
Reference
Glossary
Button Inspector reference
Network ports reference
Expressions
Internal actions reference
Routing Presets panel reference
Startup configuration reference
Workflow nodes
Connection workflow nodes
Workflow workflow nodes
Internal workflow nodes
Position workflow nodes
API workflow nodes
Utility workflow nodes

Loading...

Previous
← Activate Buttons offline
Next
Create your first backup →
Contact support →
You are viewing documentation for Buttons 1.8.See the docs for Buttons 1.6
Buttons/Getting started/Find your way around Buttons

Find your way around Buttons

After signing in, use this guide to choose the part of Buttons that matches what you want to accomplish.

Understand the navigation#

The main navigation runs down the left side of the interface. Buttons can move items into More when the browser window is not tall enough to display every item.
Some pages and subpages depend on the installed license or enabled features, so they may not appear in every installation.

Use the command palette#

Press ⌘K (macOS) or Ctrl+K (Windows/Linux) from anywhere in Buttons to open the command palette: a faster way to jump to a page, run a command, or find a resource by name without clicking through the menus.
  • Start typing to search. With no search text, the palette shows your Recent commands first, then a Context group of commands relevant to whatever page you're currently on, then every other command grouped by area (Navigation, Position, Connections, Workflow, Cuelist, Tags, Routing, Settings, Auth).
  • Once you type a search, matching commands stay grouped by area, and a separate Resources group appears below them with real positions, connections, and other named resources that match, not just menu items.
  • Use the arrow keys and Enter to select a result without touching the mouse, or Esc to close the palette without doing anything.
  • Results respect your access the same way the rest of the UI does: a command or resource you don't have permission for either doesn't appear, or appears greyed out with the reason shown in place of its usual description.

Choose the right area#

Home#

Use Home to get an overview of the system.
The home page shows system warnings, configured resources, the running Buttons version, and links to community and support information.
A warning on Home is a reason to inspect the affected resource or service before starting production work. It does not necessarily mean every control is unavailable.

Position#

Use Position to define the physical operating positions and workspaces in your system.
Depending on enabled features and your access, this area can include:
  • Position: create positions and edit their sections and controls.
  • Variables: inspect or manage position variables when that feature is enabled.
  • Shared: create sections that can be reused in multiple positions.
A position brings together the interfaces used by one person at a physical operating position. It makes those surfaces work together and interact as one workspace, while keeping that person's controls, actions, navigation, and position state separate from other positions. For example, the same sound position could be available through a hardware panel, a browser session, and an iPad.

Connect#

Use Connect to connect Buttons to external units and control hardware.
This area includes:
  • Connection: add and configure modules for devices, software, and services.
  • NMOS: discover, adopt, and configure NMOS resources.
  • Surface: add or adopt interfaces such as hardware panels and assign them to positions.
For example, add an audio mixer under Connection, confirm it is online, then use its actions, feedbacks, and variables in controls under Position.

Workflow#

Use Workflow when a task needs automation or custom logic beyond a direct button action. A workflow can respond to events, evaluate conditions and values, run actions, and exchange data through APIs. For example, it could check whether a connection is online and choose a fallback action.

Cuelist#

Use Cuelist to maintain a list of actions. Run them in a determined order for a show, or use the cuelist when a list is more practical than placing every action on an individual button. A cuelist can also be controlled from a position.

Tags#

Use Tags to organize and filter different resource types. An item can have tags from multiple collections (for example, Studio 1, Audio, and Shared), so plan names around how people find resources.

Routing#

Use Routing to configure routing resources and to control which source reaches a destination.
The basic pages are:
  • Route: select, stage, preview, and execute routes.
  • Presets: save and execute routing salvos. These are different from presets used to create position controls.
  • Labels: give routing resources clear, meaningful labels.
  • Ports: inspect routing ports and their configuration.
Depending on enabled routing features, the area can also include:
  • Virtual
  • Relations
  • Rules
  • Requests
  • Graph
  • Projects
  • Tally / UMD
A routing project groups routing activity so claimed resources, such as tielines, can be released together. Projects can expire automatically or be released manually.
Use Route or a prepared routing control to change an active source. Use the configuration pages to provide meaningful names, valid choices, and clear route status.

Auth#

Use Auth to manage people and access.
This area can include:
  • Users: create and maintain user accounts.
  • Roles: group permissions and assign access to resources.
  • Sessions: inspect or manage active sessions when that feature is enabled.
Unlike most license-gated areas, Auth stays visible without a paid license tier rather than disappearing from the navigation; it just isn't interactive until the system is licensed.
The first local administrator can access the complete system. Create separate user accounts and grant each account only the resources and operations it needs.

Settings#

Use Settings for system-wide configuration and maintenance. See Find your way around Settings for what each page covers.
Not every user or license sees every settings page. Read the task-specific guide before changing settings that affect authentication, routing, certificates, backups, or services.

Logout#

Use Logout when leaving a shared workstation. Closing the browser window is not a substitute for ending a session on a shared machine.

Before making a change#

Confirm:
  1. The highlighted main-navigation item matches the job you intend to perform.
  2. The page heading or submenu identifies the exact resource type.
  3. You are editing the intended system, position, connection, workflow, or route.
  4. You understand whether the change affects configuration or immediately controls a connected unit.
For example, changing a button's design under Position edits configuration. Taking a route under Routing → Route can immediately change the source feeding a real output.
If an item is absent, check whether its feature is enabled and included in the installed license.

Next steps#

Continue with the task that matches what you want to accomplish:
  • Add an ATEM connection to provide presets and routing ports.
  • Create a position, then add controls from the ATEM connection.
  • Create users and roles to control access.

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful