matryer /xbar

Put the output from any script or program into your macOS Menu Bar (the BitBar reboot)

★ 18,085⑂ 651👁 167⑃ 239● 705▤ 69
GoMITCreated 2013-11-13xbarapp.com
Download: v2.1.7-betav2.1.7-beta ↓v2.1.7-beta2021-10-29
+0
Daily
+1
Weekly
+9
Monthly
18,085
stars
651
forks
167
watchers
239
prs
705
issues
69
releases

README

Welcome to xbar

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 - using Wails.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 and installing plugins

Digging deeper:

   Browse plugin repository
   Guide to writing your own plugins

And finally...

   Read the story about how xbar unexpectedly got going
   Contributing and special thanks

 Get started

 Install

 Download the latest release of xbar.

 Installing plugins

From an xbar menu, choose Preferences  Plugins... to use the xbar app to discover and manage plugins.

You can browse all the plugins online, or write your own.

 The Plugin Directory

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

 Contributing

If you'd like to contribute a plugin, head over to https://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 our Writing plugins guide

 Thanks

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

Top issues

Latest release

v2.1.7-beta v2.1.7-beta 2021-10-29
What's Changed

 Increased plugin timeout from 1 minute to 2 minutes to address 735
 Update readme to add /usr/bin/env examples by @leaanthony in https://github.com/matryer/xbar/pull/766
 Fix links to the writing plugins guide at xbar-plugins by @ryan-mooore in https://github.com/matryer/xbar/pull/772
 Broken link in README by @zhovner in https://github.com/matryer/xbar/pull/768

 New Contributors
 @ryan-mooore made their first contribution in https://github.com/matryer/xbar/pull/772
 @zhovner made their first contribution in https://github.com/matryer/xbar/pull/768

Full Changelog:

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON