BitBar

BitBar (by Mat Ryer - @matryer) lets you put the output from any script/program in your Mac OS X Menu Bar.

Download and View plugin repository
Get started
Installing plugins
Contributing
Thanks

Example showing the latest Buy and Sell figures for BitCoins:

Click to see the full output, and more options:

Example showing your internal and external IP addresses:

Get started

Get the latest version of BitBar. Copy it to your Applications folder and run it - it will ask you to (create and) elect a plugins folder, do so.

Homebrew Cask users can, alternatively, install BitBar by running brew cask install bitbar.

Browse our plugins to find useful scripts, or write your own

It's free, so please donate

If you love this, any BitCoin donations are most welcome, to 1DGoNEYAnjE5DqK7y5zMPR4PLU5HLKpLNR or send something useful (Amazon Wishlist).

Installing plugins

Just download the plugin of your choice into your BitBar plugins directory and choose 'Reset' from one of the BitBar menus.

Configure the refresh time

The refresh time is in the filename of the plugin, following this format:

{name}.{time}.{ext}

name - The name of the file
time - The refresh rate (see below)
ext - The file extension

For example:

date.1m.sh would refresh every minute.

Most plugins will come with a default, but you can change it to anything you like:

10s - ten seconds
1m - one minute
2h - two hours
1d - a day

Ensure you have execution rights

Ensure the plugin is executable by running chmod +x plugin.sh.

Using symlinks

Because Git will ignore everything in Plugins/Enabled, you can use it to maintain your own plugins directory while still benefitting from tracking (upstream) changes.

Example

cd Plugins/Enabled

# Enable spotify plugin
ln -s ../Music/spotify.10s.sh

# Enable uptime plugin and change update interval to 30 seconds
ln -s ../System/uptime.1m.sh uptime.30s.sh

Then select the Enabled folder in your BitBar preferences.

Resetting Plugin Directory

In case you made the mistake of choosing a directory with thousands of files as the plugin directory and BitBar getting stuck forever, do this from terminal to reset it:

defaults delete com.matryer.BitBar

Contributing

If you want to contribute a plugin, please head over to the Plugin repository and submit a pull request

BitBar app

To work on the BitBar app, fork, then clone this repo.

In terminal, navigate to the project directory and run:

git submodule init && git submodule update

Thanks

Special thanks to @muhqu and @tylerb for all their help (see commit history for details)
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

alihalabyah / bitbar