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:
Go:
Node:
PHP:
Java:
Python:
Ruby:
Rust:
Nim:
Erlang:
C:
C#:
Crystal:
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:
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
- 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
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).