[New plugin request] Matrix Scroller

[mikeneiderhauser]

pluginInfo.json raw URL

https://raw.githubusercontent.com/mikeneiderhauser/fpp-matrixscroller/refs/heads/master/pluginInfo.json

Category

Messaging, Signage & Countdown

Contact token

FPPC1:
yxoLd3wtLLr2MmZY3l50DMwOem6ie/XUKisd9FL8bbirY7HaB3xFVcIzoJfhyOSNqTmS/H1l
5B57ryYM3Q6vNbuBHQSxBjfVOV+eSIYKe8LrI1UnhgUdfMt5J76Jf1pML8rgclpJCnBlxiiS
44AIsNs8586oinTy/jZLAN/Bk6fiBC6qtx8y8ulw5+FuGHW9CiXEKxnxzYlzu14BxrTTWwtI
2tTk7Z1w6dNFmJTe5Ghrsm+Ad1kMw5rWo9lf3HCyJzCsgD6NNqRMNT+hrtBAKFN7rk8MkYsU
QrhxcpWjWwClfSyUkF+fk8zx+4yq8uNzVd+0nV9qXPioW2tmwddKaA==

Acknowledgements

• This plugin is production release quality and I have tested it on both the latest released version of FPP and the current nightly build.
• My plugin does not interfere with core FPP functionality, stability, or real-time sequence playback, and installs cleanly (or refuses with an explanation) on hardware it can't support.
• My plugin is not malicious and does not and will not in future exfiltrate data or run unexpected remote code.
• I understand inclusion is at the FPP developers' discretion and is not guaranteed.

Community announcement

• I have announced this plugin to the FPP community (e.g. the FPP Facebook group) and considered feedback.

Anything else? (optional)

I've shown this plugin at the Ohio Mini 2026 and have adjusted based on some feedback.

[github-actions]

🛑 Automated plugin check: needs changes

Plugin: fpp-matrixscroller
Repo: https://github.com/mikeneiderhauser/fpp-matrixscroller
Owner: mikeneiderhauser
Category: Messaging, Signage & Countdown

@mikeneiderhauser found 3 issue(s) this must be fixed before the plugin can be listed:

• 🛑 Blocker - not-compatible-with-target - no versions[] entry declares support for the current FPP 10. Add one once you've confirmed it works, e.g. {"minFPPVersion": "10.0", "maxFPPVersion": "0", "branch": "master", "sha": ""}.

• ⚠️ Best practice - no-set-e - scripts/fpp_install.sh has no 'set -e' (or || exit) - without it, bash keeps running the rest of the script even after a command fails, so if an earlier step errors out (e.g. a dependency install fails), later steps still run against that broken state and the plugin ends up half-installed with no visible error. Add set -e (or set -euo pipefail) as the first line after the shebang so the script stops immediately on the first failure instead

• ⚠️ Best practice - no-icon - no icon.png in the repo root and no iconURL in pluginInfo.json - the Plugin Manager will show your initials instead of an icon. A local icon.png (128x128 or 256x256, repo root) is preferred since it renders offline once installed; iconURL is the fallback and the only option shown before install

Push a fix to your repo, then comment /recheck here (no need to edit this issue) to re-run the scan. If you believe these checks are wrong and want a maintainer to look anyway, comment /submit instead.

[mikeneiderhauser]

/recheck

[github-actions]

🛑 Automated plugin check: needs changes

Plugin: fpp-matrixscroller
Repo: https://github.com/mikeneiderhauser/fpp-matrixscroller
Owner: mikeneiderhauser
Category: Messaging, Signage & Countdown

@mikeneiderhauser found 3 issue(s) this must be fixed before the plugin can be listed:

• 🛑 Blocker - exec-bit - scripts/postStart.sh is not executable - commit it +x (git update-index --chmod=+x)

• 🛑 Blocker - exec-bit - scripts/preStop.sh is not executable - commit it +x (git update-index --chmod=+x)

• ⚠️ Best practice - blocking-sleep-in-hook - unconditional sleep in a lifecycle hook (scripts/preStop.sh:11: sleep 1) - this blocks fppd startup/shutdown for that long on every run. If you're waiting on a background process, poll for the actual condition (e.g. the PID file existing, or the port accepting connections) with a short bounded retry loop instead of a flat sleep

Push a fix to your repo, then comment /recheck here (no need to edit this issue) to re-run the scan. If you believe these checks are wrong and want a maintainer to look anyway, comment /submit instead.

[mikeneiderhauser]

/recheck

[github-actions]

🛑 Automated plugin check: needs changes

Plugin: fpp-matrixscroller
Repo: https://github.com/mikeneiderhauser/fpp-matrixscroller
Owner: mikeneiderhauser
Category: Messaging, Signage & Countdown

@mikeneiderhauser found 1 issue(s) this must be fixed before the plugin can be listed:

• ⚠️ Best practice - blocking-sleep-in-hook - unconditional sleep in a lifecycle hook (scripts/preStop.sh:13: sleep 0.1) - this blocks fppd startup/shutdown for that long on every run. If you're waiting on a background process, poll for the actual condition (e.g. the PID file existing, or the port accepting connections) with a short bounded retry loop instead of a flat sleep

Push a fix to your repo, then comment /recheck here (no need to edit this issue) to re-run the scan. If you believe these checks are wrong and want a maintainer to look anyway, comment /submit instead.

[mikeneiderhauser]

/recheck

[github-actions]

🛑 Automated plugin check: needs changes

Plugin: fpp-matrixscroller
Repo: https://github.com/mikeneiderhauser/fpp-matrixscroller
Owner: mikeneiderhauser
Category: Messaging, Signage & Countdown

@mikeneiderhauser found 1 issue(s) this must be fixed before the plugin can be listed:

• ⚠️ Best practice - blocking-sleep-in-hook - unconditional sleep in a lifecycle hook (scripts/preStop.sh:13: sleep 0.1) - this blocks fppd startup/shutdown for that long on every run. If you're waiting on a background process, poll for the actual condition (e.g. the PID file existing, or the port accepting connections) with a short bounded retry loop instead of a flat sleep

Push a fix to your repo, then comment /recheck here (no need to edit this issue) to re-run the scan. If you believe these checks are wrong and want a maintainer to look anyway, comment /submit instead.

[mikeneiderhauser]

/recheck

[github-actions]

✅ Automated plugin check: passed

Plugin: fpp-matrixscroller
Repo: https://github.com/mikeneiderhauser/fpp-matrixscroller
Owner: mikeneiderhauser
Category: Messaging, Signage & Countdown

@mikeneiderhauser no blocking issues found. A maintainer will still review this by hand before it's added to pluginList.json.

[github-actions]

📦 Listing PR: #46

Closing this issue - further discussion happens on the PR now. Merging it is a separate decision for a maintainer to make.