Skip to content

Broox Media Player

Broox Media Player is an Electron-based application that can play content and react to events in an Interactive Broox Platform.

It supports images, video and HTML5 content.

It runs on Windows, Linux and MacOS.

Broox Mediaplayer Installation

Windows 10/11

  1. Download Mediaplayer Setup X.X.X.exe or the BrooxPlatform-X.X.exe combo installer.

  2. Double-click on the downloaded file to install.

  3. You can find the Media Player on the Start Menu.

Quitting the Mediaplayer

  1. Click on the media player window and press Ctrl-Q.

Kiosk mode Startup

The included mediaplayer.cmd script can be used to start the mediaplayer after user auto-login.

  1. Left-click on the taskbar and open Task Manager.
  2. Click on the bottom button to set it to Advanced mode if needed.
  3. In the "Startup" tab, add mediaplayer.cmd to the list of startup apps.

Note: **The script will kill explorer.exe. **

To get it back, press/send Ctrl+Alt+Del, start the task manager and select File→Run…: explorer.exe.

Linux (Ubuntu 20.04)

  1. Copy the mediaplayer_X.X.X_amd64.deb file to your user directory.
  2. Install with apt as root:
sudo apt install ./mediaplayer_X.X.X_amd64.deb
  • The executable will be located at /usr/bin/mediaplayer.
  • The package installs at /opt/MediaPlayer

You can start from the Ubuntu Applications Menu.

To start from the terminal just use:

mediaplayer

Automatic Startup

On Ubuntu desktop, open the application "Startup Applications" and add a startup item for /usr/bin/mediaplayer

Media Player Content

Broox Media Player can display:

  • Video.
  • Static Images.
  • Embedded HTML5 content.
  • Interactive HTML5 content.

Video

Broox Media Player supports H.264 video (with optional AAC/MP3 audio). Videos can be any size, and adapt to the display "canvas" (a region of the display) defined in Broox Studio.

The only directly supported container for direct video is MP4. Other formats might be supported by embedding them into an HTML5 page.

Static Images

For static announcements, Broox Media Player can display PDF, JPEG or PNG images, either continuously or on a carrousel loop, with set durations.

HTML5 Content

Broox Media Player uses the Chromium runtime to display HTML5 content. As such, most content supported by Chrome and Chromium based browsers can be also displayed on Broox Media Player.

HTML content can be delivered in two ways:

  • By embedding an existing webpage, using its URL.
  • By using a ZIP file containing the whole site structure.

Creating Content

See the Broox Media Player Developer Documentation for precise documentation on how to create content adapted to Broox Media Player.

Configuration and settings

C:\Users\USER_NAME\AppData\Roaming\Media Player\broox_mediaplayer\config.json

This file contains the last configuration for the Media Player (canvases, playlists, assets). If the Player fails to connect to the controller ir will use this configuration.

Caches directory

C:\Users\USER_NAME\AppData\Roaming\Media Player\broox_mediaplayer\media

This folders contains the downloaded assets

Controller settings

C:\Users\USER_NAME\AppData\Roaming\Media Player\broox_mediaplayer\media\device.ini

Edit the device.ini file if you need to overwrite any basic default parameter.

Troubleshooting

Quitting the Broox Media Player

Select the Media Player window and press: Ctrl-Q (Windows/Linux)/Cmd-Q(Mac)

Media Player cannot connect to the controller/Changed IP address of the PC

Select the Media Player window and press: Ctrl+D.

This will restart the mediaplayer to a default settings and a controller must be assigned again.