Skip to main content

Connecting MagicMirror

The MMM-TBTGuest module retrieves active content for a mirror through the protected TBTGuest feed and displays it in the configured order.

Requirements

  • A configured MagicMirror² system
  • The MMM-TBTGuest module in the module directory
  • API endpoint and feed token from TBTGuest → Settings

If Tenbyte configured your display, the module is usually already installed. In this case, only check the connection values.

Configuration

Add the module to the MagicMirror config.js file:

{
module: "MMM-TBTGuest",
position: "middle_center",
config: {
apiUrl: "https://YOUR-TBTGUEST-DOMAIN/api/greetings",
feedToken: "YOUR-PRIVATE-FEED-TOKEN",
refreshInterval: 60 * 1000,
animationSpeed: 500,
},
}
SettingMeaning
apiUrlComplete API endpoint from TBTGuest
feedTokenPrivate token for the selected mirror
refreshIntervalTime between feed requests in milliseconds; default: 60 seconds
animationSpeedTransition duration for changes in milliseconds
danger

Never publish feedToken in a public repository. Every mirror requires its own token.

Apply Changes

Restart MagicMirror after changing config.js. The module then retrieves new content regularly. Reload the MagicMirror display to update it immediately.

Display Behaviour

  • Welcome messages use the font size selected in TBTGuest.
  • Images are scaled proportionally without distortion.
  • Each item's individual display duration controls the change to the next item.
  • Paused items are not delivered.
  • If the playlist is empty, the module area remains empty.