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.6-J:

This version download is not supported through Homebrew-cask!

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

Custom colour support is available send a message in format: #ffcc33

One command for receiving a response to localhost:3500: ping

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
$ anybar #ccff33

Go:

• justincampbell/anybar
• johntdyer/anybar-go

Node:

• rumpl/nanybar
• sindresorhus/anybar
• snippet by skibz

PHP:

• 2bj/Phanybar

Java:

• cs475x/AnyBar4j

Python:

• philipbl/pyanybar

Ruby:

• davydovanton/AnyBar_rb

Rust:

• urschrei/rust_anybar

Nim:

• rgv151/anybar.nim

Erlang:

• kureikain/ebar

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

Alfred:

• https://github.com/raguay/MyAlfred

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

You can set a title for each instance of AnyBar which will be shown after clicking on the menu bar icon.

ANYBAR_PORT=1738 ANYBAR_TITLE="This will be shown" open -n ./AnyBar.app
ANYBAR_PORT=1739 ANYBAR_TITLE="Something else here" open -n ./AnyBar.app
ANYBAR_PORT=1740 ANYBAR_TITLE="Yet another title" open -n ./AnyBar.app

You may specify port to which AnyBar will respond when pinged.

ANYBAR_RESPONSE_PORT=5432 ANYBAR_PORT=1738 ANYBAR_TITLE="This will be shown" 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.6-J

• Add ping command

0.1.5-J

• Support for custom colours

0.1.4-J

• J in version label means modified version from the main branch
• Support for title in menu after clicking on menu bar icon

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

Copyright © 2015 Nikita Prokopov

Licensed under Eclipse Public License (see LICENSE).