AnyBar: OS X menubar status indicator

AnyBar is a small indicator for your menubar that does one simple thing: it displays color dot. What color means is up to you. When to change color is also up to you.

Download

Version 0.1.3:

Or using Homebrew-cask:

brew cask install anybar

Usage

AnyBar is controlled via UDP port (1738 by default). Before commands can be sent, AnyBar.app must be launched:

open /Users/yourusername/Applications/AnyBar.app

Once launched, send it a message and it will change a color:

echo -n "black" | nc -4u -w0 localhost 1738

Following commands change color:

white
red
orange
yellow
green
cyan
blue
purple
black
question
exclamation

And one special command forces AnyBar to quit: quit

Alternative clients

Bash alias:

$ function anybar { echo -n $1 | nc -4u -w0 localhost ${2:-1738}; }

$ anybar red
$ anybar green 1739

Go:

Node:

PHP:

2bj/Phanybar

Java:

cs475x/AnyBar4j

Python:

philipbl/pyanybar

Ruby:

davydovanton/AnyBar_rb

AppleScript:

tell application "AnyBar" to set image name to "blue"

tell application "AnyBar" to set current to get image name as Unicode text
display notification current

Integrations

Webpack build status plugin roman01la/anybar-webpack
boot-clj task tonsky/boot-anybar
Anybar-based CLI journal Andrew565/anybar-icon-journal

Running multiple instances

You can run several instances of AnyBar as long as they listen on different ports. Use ANYBAR_PORT environment variable to change port and open -n to run several instances:

ANYBAR_PORT=1738 open -n ./AnyBar.app
ANYBAR_PORT=1739 open -n ./AnyBar.app
ANYBAR_PORT=1740 open -n ./AnyBar.app

Custom images

AnyBar can use user-local images if you put them under ~/.AnyBar. E.g. if you have ~/.AnyBar/square@2x.png present, send square to 1738 and it will be displayed. Images should be 19×19px (or twice that for retina).

Ports

Ubuntu Unity limpbrains/somebar

Changelog

0.1.3

AppleScript support (PR #8, thx Oleg Kertanov)

0.1.2

Dark mode support. In dark mode AnyBar will first check for <image>_alt@2x.png or <image>_alt.png image first, then falls back to <image>.png
Support for Mavericks actually works

0.1.1

Support for Mavericks (PR #2, thx Oleg Kertanov)
Support for custom images via ~/.AnyBar (PR #1, thx Paul Boschmann)

License

Licensed under Eclipse Public License (see LICENSE).

geneticgrabbag/AnyBar