LEDMatrix Official Plugins

Official plugin repository for LEDMatrix · Installation · Plugins · Development · Support

See it in action

_Football	_Hockey
_Weather	_Music
_{Christmas Countdown}	_{Football Scoreboard}

Each plugin links to its own README with more screenshots and configuration details.

Quick Install

Web Interface (Recommended):

Open http://your-pi-ip:5000
Open the Plugin Manager tab
Find the plugin you want in the Plugin Store section and click Install

API:

curl -X POST http://your-pi-ip:5000/api/v3/plugins/install \
-H "Content-Type: application/json" \
-d '{"plugin_id": "football-scoreboard"}'

Available Plugins

Sports (17)

Plugin	Description	Preview
Football Scoreboard	NFL & NCAA Football live scores, down/distance, possession
Hockey Scoreboard	NHL & NCAA Hockey live scores and schedules
Basketball Scoreboard	NBA, NCAA & WNBA live scores and schedules
Baseball Scoreboard	MLB, MiLB & NCAA Baseball live scores
Soccer Scoreboard	Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS
Lacrosse Scoreboard	NCAA lacrosse live scores and schedules
Cricket Scoreboard	Live, recent & upcoming international (Test/ODI/T20I) and major domestic cricket
AFL Scoreboard	Australian Football League live, recent & upcoming games
NRL Scoreboard	National Rugby League live, recent & upcoming games
F1 Scoreboard	Formula 1 race results, schedules, and standings
UFC Scoreboard	UFC/MMA live fights, fighter headshots, records, odds & results — by LegoGuy1000
Odds Ticker	Betting odds & lines across NFL, NBA, MLB, NHL, NCAA
Masters Tournament	Live Masters golf leaderboard, hole tracking, player cards
NFL Draft	Projected & live NFL draft picks from ESPN
March Madness	NCAA tournament bracket tracker with round branding and live scores
Sports Leaderboard	League standings, rankings, conference records
Olympics Countdown	Countdown to next Olympics with live medal counts

Financial (2)

Plugin	Description	Preview
Stocks Ticker	Real-time stock & crypto prices with charts
Stock News	Financial headlines from RSS feeds

Time & Calendar (4)

Plugin	Description	Preview
Simple Clock	Time and date display
7-Segment Clock	Retro-style 7-segment clock with customizable colors
Google Calendar	Upcoming events from Google Calendar
Geochron World Clock	World map with the real-time day/night terminator

Weather (2)

Plugin	Description	Preview
Weather Display	Current conditions, hourly & daily forecasts (Open-Meteo)
Tide Display	Coastal tides with animated wave level, schedule & 24-hour chart (NOAA)

Media (3)

Plugin	Description	Preview
Jellyfin Now Playing	Poster, title and playback progress from your Jellyfin server
Music Player	Now playing with album art (Spotify & YouTube Music)
Static Image Display	Image display with scaling and transparency

Content (2)

Plugin	Description	Preview
News Ticker	RSS news headlines from ESPN, NCAA, custom sources
Of The Day	Daily quotes, Bible verses, word of the day

Integrations (3)

Plugin	Description	Preview
BirdNET-Go	Live bird detections and daily species stats from a BirdNET-Go server
MQTT Notifications	HomeAssistant notifications via MQTT
On Air Light	Broadcast ON AIR tally light, triggered remotely via MQTT / Home Assistant

Productivity (1)

Plugin	Description	Preview
Pomodoro Timer	Focus/break timer with MQTT control and Home Assistant discovery

Productivity (1)

Plugin	Description	Preview
Incoming Packages	Rotating carrier cards for packages arriving today, via Home Assistant

Custom (3)

Plugin	Description	Preview
Flight Tracker	Real-time ADS-B aircraft tracking with map display
Countdown Display	Customizable countdowns for birthdays, events, holidays
Election Results	Live election results ticker with full-screen race interrupts

Holiday (1)

Plugin	Description	Preview
Christmas Countdown	Festive countdown with Christmas tree display

Social (1)

Plugin	Description	Preview
YouTube Stats	Channel subscriber count, total views

Text (1)

Plugin	Description	Preview
Scrolling Text	Custom scrolling/static text with configurable fonts and colors

System (1)

Plugin	Description	Preview
Web UI Info	Displays web UI URL for device access

Development (1)

Plugin	Description	Preview
Hello World	Plugin development example and starter template

Community Contributors

LEDMatrix is open to community plugin contributions! The following plugins were built or contributed by community members:

Plugin	Contributor	Contribution
UFC Scoreboard	@LegoGuy1000	Original UFC/MMA implementation (PR #137)

Third-party plugins in the registry

The plugin store also aggregates plugins hosted in their own repositories. These carry a Custom badge in the web UI and are installed the same way. They live outside this monorepo, so review their source before installing.

Plugin	Author	Repository
GIF Player	@ant456	ledmatrix-gif-player — animated GIFs with an upload portal
PGA Tour Leaderboard	@sarjent	ledmatrix-golf — PGA Tour leaderboard via ESPN
Plex Marquee	@ant456	ledmatrix-plex-marquee — cinema marquee art via Fanart.tv
Dresden Departures	@ryug0	ledmatrix-dresden-departures — Dresden VVO departure board
Tidbyt Baseball Scoreboard	@trsadler	MLB-Scoreboard-LEDMatrix — split team-color MLB live scoreboard

Want to see your plugin here? Check out 3rd Party Plugin Development below or submit a plugin via Discord.

Installation & Usage

Plugin Store (Recommended)

The Plugin Store in the LEDMatrix web interface automatically fetches the latest plugins from this registry:

Browse and search plugins
One-click installation
Automatic updates
Configuration management

Manual Installation

Clone this repository and copy the plugin you want into your LEDMatrix installation's configured plugins directory (default plugin-repos/):

git clone https://github.com/ChuckBuilds/ledmatrix-plugins.git
cp -r ledmatrix-plugins/plugins/football-scoreboard /path/to/LEDMatrix/plugin-repos/

The directory name on the destination must match the plugin's id in its manifest.json. Restart the LEDMatrix display service afterward so the loader picks up the new plugin.

Note: See individual plugin README files for detailed setup instructions and configuration.

Installing 3rd Party Plugins

LEDMatrix supports installing plugins from any GitHub repository, not just this registry.

Via Plugin Manager Tab

Open the LEDMatrix web interface (http://your-pi-ip:5000)
Navigate to Plugin Manager tab
Scroll to "Install from GitHub" section

Single Plugin Installation

Enter the GitHub repository URL (e.g., https://github.com/user/ledmatrix-my-plugin)
Optionally specify a branch
Click Install

Registry/Monorepo Installation

Enter a registry repository URL (e.g., https://github.com/user/their-plugins)
Click Load Registry to browse available plugins
Click Install on any plugin

Important Notes

3rd party plugins show a Custom badge in the web UI
Review plugin code before installing from untrusted sources
Manual updates required unless the repository is saved

For Maintainers

Repository Structure

ledmatrix-plugins/
plugins.json # Plugin registry (auto-updated from manifests)
update_registry.py # Sync registry versions from local manifests
plugins/
football-scoreboard/ # Each plugin has its own directory
manifest.json
manager.py
config_schema.json
requirements.txt
README.md
hockey-scoreboard/
...

Setup

Install the git pre-commit hook so plugins.json stays in sync automatically:

cp scripts/pre-commit .git/hooks/pre-commit

Updating Plugin Versions

After making changes to a plugin:

Bump version in the plugin's manifest.json
Commit — the pre-commit hook automatically syncs plugins.json

# Manual alternative (if hook isn't installed):
python update_registry.py # Update plugins.json
python update_registry.py --dry-run # Preview changes

3rd Party Plugin Development

Required Files

Your plugin repository must contain:

manifest.json — Plugin metadata (required)
Entry point file — Python file with your plugin class (default: manager.py)
Plugin class — Must inherit from BasePlugin and implement update() and display()

Optional but recommended:

requirements.txt — Python dependencies
config_schema.json — Configuration validation schema (JSON Schema Draft-7)
README.md — User documentation

Manifest Requirements

Field	Type	Description
`id`	string	Unique plugin identifier
`name`	string	Human-readable name
`class_name`	string	Plugin class name (must match class in entry point)
`display_modes`	array	Display mode names

See the manifest schema for complete field reference.

Getting Started

Read the Plugin Development Guide in this repo — anatomy, the core API, advanced features (live priority, dynamic duration, high-FPS scrolling, Vegas mode), styling/skins, adaptive layout, and the testing/CI workflow
Start with the Hello World plugin as a template
Test without hardware: run the LEDMatrix dev preview server (python3 scripts/dev_server.py from the LEDMatrix repo, then open http://localhost:5001) — see docs/DEV_PREVIEW.md. Or run the full display in emulator mode with EMULATOR=true python3 run.py.

Submitting a Plugin

To add your plugin to the official registry:

Open an issue on this repository or reach out on Discord
Include: repository URL, description, screenshots/video
After review, your plugin will be added to the registry

See SUBMISSION.md for full guidelines.

License

GNU General Public License v3.0 — see LICENSE for details.

Support & Community

Discord: Join the community
Issues: Report plugin issues
Security: see SECURITY.md — please don't open public issues for vulnerabilities
Contributing: see CONTRIBUTING.md for the dev setup and PR flow, or SUBMISSION.md for adding a brand-new plugin
LEDMatrix: Main repository

Connect with ChuckBuilds

YouTube: @ChuckBuilds
Instagram: @ChuckBuilds
Support the Project:

Note: Plugins are actively developed. Report bugs or feature requests on the issues page.

Name		Name	Last commit message	Last commit date
.github		.github
docs		docs
plugins		plugins
scripts		scripts
.cursorrules		.cursorrules
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
SUBMISSION.md		SUBMISSION.md
VERIFICATION.md		VERIFICATION.md
config_secrets.template.json		config_secrets.template.json
plugins.json		plugins.json
requirements.txt		requirements.txt
update_registry.py		update_registry.py

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

LEDMatrix Official Plugins

See it in action

Quick Install

Available Plugins

Sports (17)

Financial (2)

Time & Calendar (4)

Weather (2)

Media (3)

Content (2)

Integrations (3)

Productivity (1)

Productivity (1)

Custom (3)

Holiday (1)

Social (1)

Text (1)

System (1)

Development (1)

Community Contributors

Third-party plugins in the registry

Installation & Usage

Plugin Store (Recommended)

Manual Installation

Installing 3rd Party Plugins

Via Plugin Manager Tab

Single Plugin Installation

Registry/Monorepo Installation

Important Notes

For Maintainers

Repository Structure

Setup

Updating Plugin Versions

3rd Party Plugin Development

Required Files

Manifest Requirements

Getting Started

Submitting a Plugin

License

Support & Community

Connect with ChuckBuilds

About

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Contributors

Languages