xbar - GitLite

KO | EN

gitlite — search

#javascript #ai #golang #android #machine-learning #linux #nodejs #cli #kubernetes #awesome-list #vue #mcp #ios #open-source

xbar

(★ 18,062)

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

File Explorer

Download Latest Version (.zip)

- - deploy-xbarappcom.yaml
- FUNDING.yml
- settings.json
- - appicon.png
  - README.md
- - .gitignore
  - package.json
  - postcss.config.js
  - rollup.config.js
  - tailwind.config.js
- .gitignore
- app.go
- build.sh
- categories_service.go
- categories_service_test.go
- command_service.go
- go.mod
- go.sum
- incoming_urls.go
- incoming_urls_test.go
- main.go
- menu_parser.go
- menu_parser_test.go
- package-lock.json
- package.json
- package.sh
- person_service.go
- plugins_service.go
- README.md
- settings.go
- settings_test.go
- test.sh
- wails.json
- - .gitignore
  - .gitmodules
  - .travis.yml
  - Makefile
  - README.md
- - categories_metadata.go
  - categories_metadata_test.go
  - go.mod
  - go.sum
  - plugin_metadata.go
  - plugin_metadata_test.go
- - action.go
  - action_test.go
  - colors.go
  - emoji.go
  - go.mod
  - go.sum
  - install.go
  - install_test.go
  - installed_plugins.go
  - installed_plugins_test.go
  - item_params.go
  - item_params_test.go
  - parse.go
  - parse_test.go
  - plugin.go
  - plugin_darwin.go
  - plugin_linux.go
  - plugin_test.go
  - plugin_windows.go
  - README.md
  - refresh_interval.go
  - refresh_interval_test.go
  - variables.go
  - variables_test.go
- - go.mod
  - go.sum
  - README.md
  - update.go
  - update_test.go
- - docs.go
  - go.mod
  - go.sum
  - images.go
  - main.go
  - README.md
  - repo.go
  - repo_test.go
  - run.sh
- - go.mod
  - go.sum
  - main.go
  - README.md
- - _layout.html
  - article.html
  - articles-index.html
  - category.html
  - contributor.html
  - contributors.html
  - index.html
  - plugin.html
- .gcloudignore
- app.yaml
- build.sh
- deploy.sh
- download.go
- gen.sh
- go.mod
- go.sum
- main.go
- main_test.go
- package.json
- postcss.config.js
- README.md
- run.sh
- styles.css
- tailwind.config.js
.gitignore
LICENSE.txt
README.md
talk-overview.md
xbar-logo-32.png
xbar-open-graph.png
xbar-preview.jpg

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![](https://raw.githubusercontent.com/matryer/xbar/main/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