/xbar-whats-up

An xbar app to track the status of services in your macOS menu bar

Primary LanguageGoMIT LicenseMIT

xbar Plugin: What's Up?

Code Quality & Tests Maintainability Test Coverage

What's Up plugin in action

This is a plugin for xbar to quickly show in your macOS menu bar the status of services you depend on. It currently understands the following formats:

Requirements

Configuration

make create-config

Using CodeClimate's status page and Slack's as examples, we would create an entry in the configuration file like this:

{
  "CodeClimate": {
    "url": "https://status.codeclimate.com/api/v2/status.json",
    "type": "statuspage.io"
  },
  "Slack": {
    "url": "https://status.slack.com/api/v2.0.0/current",
    "type": "slack"
  }
}

Usage

Clone this repo, install dependencies, and build the plugin.

git clone git@github.com:sprak3000/xbar-whats-up.git
make setup-osx-env
make build

Move the binary and configuration to your xbar plugins directory.

mv whats-up.1h ~/Library/Application\ Support/xbar/plugins/whats-up.1h.cgo
mv whats-up.json ~/Library/Application\ Support/xbar/plugins/.whats-up.json

Alternatively, create symbolic links.

cd ~/Library/Application Support/xbar/plugins
ln -s /path/to/what-up.1h whats-up.1h.cgo
ln -s /path/to/.whats-up.json .whats-up.json

Contributing

You want to contribute to the project? Welcome!

Since this is an open source project, we would love to have your feedback! If you are interested, we would also love to have your help! Whether helpful examples to add to the docs, or FAQ entries, everything helps. Read our guide on contributing, then set up the tooling necessary.