A plugin is a small web tool — clocks, calendars, weather, albums, tickers and more. This book covers adding, using, creating and publishing plugins.
What a Plugin Is Made Of
| Part | Notes |
|---|---|
| Display page | An HTML fragment that runs full-screen on the device (required) — what ends up on the screen |
| Control panel | An optional HTML fragment for configuration — the panel where users tweak parameters, producing a JSON payload |
| DATA | The JSON produced by the panel, pushed to the device as vars in the plugin command and persisted per area |
plugin:// Short Links
Every plugin has a fixed short address plugin://xxxxxxxx (an 8-char encoded ID). When pushed, the device resolves it to this site's address and downloads it for local hosting (a 127.0.0.1 local service): isolated from the site's login origin, offline-capable, free of mixed-content issues. A version parameter in the URL changes when the plugin is updated, and devices update automatically.
Two Sources
- Marketplace: plugins published by the team and community authors — click "Use It" to adopt one;
- My Plugins: plugins you write yourself (SuperScreen only accepts URLs, so the plugin system is where you host your own pages). Built for yourself first; share to the marketplace when it's worth it.