Skip to content

Widget player

The widget player is a config player that's used to add or remove widgets to existing slides on a display. (This player is part of the MPF media controller and only available if you're using MPF-MC for your media controller.)

Note that the widget player is a config_player, so everything mentioned below is valid in the widget_player: section of a config file and in the widgets: section of a show step.

Full instructions on how to use the slide_player are included in the Widgets section of the documentation. The stuff here in the config reference is for reference later. You can test slides and widgets interactively using Interactive MC (iMC).

Generically-speaking, there are two formats you can use for widget_player entries: "express" and "full" configs. Express configs will look like this:

#! widgets:
#!   widget1: []
#!   widget2: []
#!   widget3: []
widget_player:
  event1: widget1
  event2: widget2
  event3: widget3

Full configs will look like this:

widget_player:
   event1:
      widget1:
         <settings>
   event2:
      widget2:
         <settings>
   event3:
      widget3:
         <settings>

In both cases, these configurations are saying, "When event1 is posted, add widget widget1. When event2 is posted, add widget2. Etc."

This "express" config is down-and-dirty, with no options, to just add widgets to the current slide on the default display. The full config lets you specify additional options (based on the settings detailed below).

For example, the following config will add widget_1 when some_event is posted, but it will also override the default settings and add widget to the slide called slide_2, even if that's not the current slide that's showing.

#! widgets:
#!   widget_1: []
widget_player:
  some_event:
    widget_1:
      slide: slide_2

Usage in config files

In config files, the widget player is used via the widget_player: section.

Usage in shows

In shows, the widget player is used via the widgets: section of a step.

Config Options

See widget_player: for config details.

Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results