Skip to main content

Introduction

MoBro is a modular application that is extensible by both plugins and widget packs.

Plugins mainly serve as data providers but are not limited to just that. They can also extend the functionality of MoBro in various ways.
Users can install and manage plugins directly from within MoBro via the marketplace.

Plugins for MoBro are written in C# using the MoBro Plugin SDK.

Quick start

You can get started right away by building your first, simple plugin by following the Getting started guide.

Plugin Fundamentals

info

This section will be available soon

Marketplace

The marketplace acts as a central official "store" for plugins and widgetpacks. Users can access the marketplace directly from within MoBro to install additional plugins on the fly.

To make a plugin available to all MoBro users, it needs to be published to the marketplace.

Plugin SDK

Active Development

The SDK is still in active development and only available as an early release.
While we are trying to avoid them, there might still be some breaking changes.

The SDK is used to develop plugins for MoBro and is available on Nuget.
The source code is publicly available on GitHub.

It allows the developer to focus on the actual important task (reading sensors or accessing external APIs to provide metrics) and takes care of the underlying infrastructure like:

  • Inter-process communication with MoBro (the plugins' parent process)
  • Resource management for file-based metrics (icons, images)
  • Plugin settings (incl. persistence)
  • Scheduling of repeated tasks (e.g. polling of sensors)
  • Error handling & logging
  • Localization
  • ...

Plugin CLI

The MoBro Plugin CLI provides an easy and convenient way to publish a plugin or install it to MoBro for testing purposes.
It also allows publishing a plugin to the official MoBro marketplace to make it publicly available.

The CLI is available on NuGet and can be installed by a single command:

dotnet tool install --global MoBro.Plugin.Cli