Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/matryer/xbar

Put the output from any script or program into your macOS Menu Bar (the BitBar reboot)
https://github.com/matryer/xbar

bitbar mac macos-menu macosx menubar scripting xbar

Last synced: 2 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/matryer/xbar
Owner: matryer
License: mit
Created: 2013-11-13T21:00:12.000Z (about 11 years ago)
Default Branch: main
Last Pushed: 2024-04-19T09:46:58.000Z (8 months ago)
Last Synced: 2024-05-02T00:49:30.776Z (7 months ago)
Topics: bitbar, mac, macos-menu, macosx, menubar, scripting, xbar
Language: Go
Homepage: https://xbarapp.com
Size: 61.8 MB
Stars: 17,340
Watchers: 176
Forks: 637
Open Issues: 168
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt

Awesome Lists containing this project

stars - matryer/xbar
my-awesome - matryer/xbar - menu,macosx,menubar,scripting,xbar pushed_at:2024-09 star:17.6k fork:0.6k Put the output from any script or program into your macOS Menu Bar (the BitBar reboot) (Go)
awesome-starred-test - matryer/xbar - Put the output from any script or program into your macOS Menu Bar (the BitBar reboot) (Go)
open-source-mac-os-apps - xbar - Put the output from any script or program into your macOS Menu Bar. ![objective_c_icon] (Applications / Menubar)
awesome-repositories - matryer/xbar - Put the output from any script or program into your macOS Menu Bar (the BitBar reboot) (Go)
awesome-starts - matryer/xbar - Put the output from any script or program into your macOS Menu Bar (the BitBar reboot) (Go)
go-awesome - xbar - macOS menu bar management based on [Wails.app](https://github.com/wailsapp/wails) (Open source library / Desktop Development)
open-source-mac-os-apps - xbar - Put the output from any script or program into your macOS Menu Bar. ![objective_c_icon] (Applications / Menubar)
awesome-hacking-lists - matryer/xbar - Put the output from any script or program into your macOS Menu Bar (the BitBar reboot) (Go)

README

        [![](xbarapp.com/public/img/xbar-menu-preview.png)](https://xbarapp.com/)

# 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)](https://wails.app)

  * Completely open source

  * [Download latest xbar release](https://github.com/matryer/xbar/releases/latest) - requires macOS Catalina or newer (>= 10.15)

  * [Visit the app homepage at https://xbarapp.com](https://xbarapp.com)

  * [Get started](#get-started) and [installing plugins](#installing-plugins)

Digging deeper:

  * [Browse plugin repository](https://xbarapp.com/)

  * [Guide to writing your own plugins](https://github.com/matryer/xbar-plugins/blob/main/CONTRIBUTING.md)

And finally...

  * [Read the story about how xbar unexpectedly got going](https://medium.com/@matryer/what-happens-when-your-old-open-source-project-unexpectedly-gets-to-the-top-of-hacker-news-31114c6c6efb#.fznvtgskb)

  * [Contributing](#contributing) and [special thanks](#thanks)

## Get started

### Install

* [Download the latest release of xbar](https://github.com/matryer/xbar/releases).

## 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](https://xbarapp.com/) online, or [write your own](https://github.com/matryer/xbar-plugins/blob/main/CONTRIBUTING.md).

### 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](https://github.com/matryer/xbar-plugins/blob/main/CONTRIBUTING.md)

## Thanks

  * Special thanks to [@leaanthony at https://wails.app](https://wails.app) and [@ianfoo](https://github.com/ianfoo), [@gingerbeardman](https://github.com/gingerbeardman), [@iosdeveloper](https://github.com/iosdeveloper), [@muhqu](https://github.com/muhqu), [@m-cat](https://github.com/m-cat), [@mpicard](https://github.com/mpicard), [@tylerb](https://github.com/tylerb) for their help

  * Thanks to [Chris Ryer](http://www.chrisryer.co.uk/) for the app logo - and to [@mazondo](https://twitter.com/mazondo) for the original

  * Thanks for all our [plugin contributors](https://xbarapp.com/) who have come up with some pretty genius things