Official installable Lua widgets and reusable Lua libraries for EasyBar and EasyBar Native.
- Independently versioned widget and library packages
- Popups, Inbox publishers, system utilities, and developer-tool integrations
- Package manifests with EasyBarKit compatibility and external requirements
- Focused Lua tests and cross-package validation
- Automatic publication to the official EasyBar Widget Registry
Browse packages on easybar.dev or search from either frontend:
easybar widgets search
easybar-native widgets searchInstall a compatible package into the frontend where it should run:
easybar widgets install PACKAGE
easybar-native widgets install PACKAGECheck the package page for required commands, authentication, permissions, and frontend-specific behavior.
- Lua 5.5
- Python 3.11 or newer
- A sibling EasyBarKit checkout, or
EASYBAR_KIT_ROOTpointing to one fzffor the interactive multi-package release wizard- GitHub CLI (
gh) authenticated with access to the widgets and registry repositories
Run the complete validation suite before opening a pull request:
make checkTo release one or more packages interactively, run:
make release-wizardThe wizard discovers packages/*/package.toml and lets you select packages with fzf. If a
manifest's current version has never been released, the wizard publishes that version directly. If a
current version already has a release tag, it asks for a patch, minor, or major bump.
For a multi-package release, the wizard applies all requested version bumps first, validates the
repository once, commits all bumped manifests together, and pushes main once. It then publishes the
selected package tags and waits for every package release workflow to finish successfully. After all
package releases have completed, it synchronizes easybar-app/registry once, waits for that sync, and
finally triggers one documentation rebuild.
Licensed under the Apache License 2.0.