Skip to content
OS X menubar status indicator
Objective-C Other
Branch: master
Clone or download
Latest commit f32429f Jan 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
AnyBar.xcodeproj 0.1.4 Aug 29, 2016
AnyBar PNG optimization Nov 12, 2018
Tests Tests/control-anybar.applescript sample script added Mar 6, 2015
.gitignore .gitignore added Mar 3, 2015
LICENSE Eclipse License added (closes #6) Mar 4, 2015
README.md Added emybar Jan 23, 2019
anybar_patreon.png PNG optimization Nov 12, 2018
screenshot.png PNG optimization Nov 12, 2018

README.md

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:

Fish shell with completion:

Go:

Node:

PHP:

Java:

Python:

Ruby:

Rust:

Nim:

Erlang:

C:

C#:

Crystal:

Emacs:

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

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

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

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

License

Copyright © 2015 Nikita Prokopov

Licensed under Eclipse Public License (see LICENSE).

You can’t perform that action at this time.