Repository files navigation

xbar (the BitBar reboot) lets you put the output from any script/program in your macOS menu bar.

• Complete rewrite from the ground up - in Go by @matryer and @leaanthony - usingWails.app (build cross-platform desktop apps using Go & HTML/CSS/JS)
• Completely open source
• Download latest xbar release - requires macOS Catalina or newer (>= 10.15)
• Visit the app homepage at https://xbarapp.com
• Get started andinstalling plugins

Digging deeper:

• Browse plugin repository
• Guide to writing your own plugins

And finally...

• Read the story about how xbar unexpectedly got going
• Contributing andspecial thanks

• Download the latest release of xbar.

From an xbar menu, choosePreferences > Plugins... to use the xbar app to discover and manage plugins.

You canbrowse all the plugins online, orwrite your own.

The plugin directory is folder on your Mac where the plugins live, located at~/Library/Application Support/xbar/plugins.

• If you're transitioning from Bitbar, move your plugins into this new folder to install them

If you'd like to contribute a plugin, head over tohttps://github.com/matryer/xbar-plugins to get started.

Please do not send pull requests to this repo. Open an issue and start a conversation first. PRs will likely not be accepted.

• Get started with ourWriting plugins guide

• Special thanks to@leaanthony at https://wails.app and@ianfoo,@gingerbeardman,@iosdeveloper,@muhqu,@m-cat,@mpicard,@tylerb for their help
• Thanks toChris Ryer for the app logo - and to@mazondo for the original
• Thanks for all ourplugin contributors who have come up with some pretty genius things