AnyBar: OS X menubar status indicator

AnyBar is a small indicator for your menubar that does one simple thing: it displays a colored dot. What the dot means and when to change it is up to you.

Download

Version 0.1.4:

Or using Homebrew Cask:

brew cask install anybar

Support us

Usage

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

open -a AnyBar

Once launched, you may send it a message to change the style of the dot:

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

The following default commands change the style of the dot:

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

Zsh with completion:

• wookayin/anybar-zsh

Fish shell with completion:

• matchai/anybar-fish

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
• Feliix42/anybar-rs

Nim:

• rgv151/anybar.nim

Erlang:

• kureikain/ebar

C:

• onderweg/anybar-cli

C#:

• jenyayel/anybar-client

Crystal:

• davydovanton/AnyBar_cr

Emacs:

• rmuslimov/anybar.el
• tie-rack/anybar-el (Also on Melpa)

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
• Idea plugin denofevil/AnyBarIdea
• Anybar-based CLI journal Andrew565/anybar-icon-journal
• Command monitoring rvirani1/with_anybar
• Monitor commands automatically, across several iterm tabs stacycurl/anybar_bash
• Extension for ipython/jupyter/ipython notebook ermakovpetr/ipython-anybar

Running multiple instances

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

ANYBAR_PORT=1738 open -na AnyBar
ANYBAR_PORT=1739 open -na AnyBar
ANYBAR_PORT=1740 open -na AnyBar

Custom images

AnyBar can detect and use local custom images stored in the ~/.AnyBar directory. For example, if you have a ~/.AnyBar/square@2x.png image, send square to port 1738 and it will be displayed. Images should be 19×19 pixels for standard resolution, and 38x38 pixels for retina (@2x).

Ports

• Ubuntu Unity limpbrains/somebar
• i3wm with i3pystatus enkore/i3pystatus
• Windows 10 PavelStefanov/NoteBar
• Emacs plexus/.../emybar.el

Changelog

0.1.4

• Bigger dots
• Render “black” on dark menubar as empty circle and “white” on dark as filled circle (#55)
• Compiled for OS X 10.11

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).