Menu bar/Sys tray indicator for OSX, Windows, and Linux
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Stopplicht is a menu bar/system tray indicator for osx, Windows, and Linux. There are four states available: red, green, yellow, and grey. These states make it great for showing test run status during TDD, but it could be used for anything.


Get it

Stopplicht requires Node.js. To install stopplicht, run npm install -g stopplicht.

Run it

Once stopplicht has been installed, it can be started by running stopplicht in the terminal. Stopplicht will start as a background process and is, as of yet, non-interactive. To quit stopplicht, run stopplicht-stop.

Use it

Stopplicht runs a tcp server on port 17357 and listens for short messages to change it's state. For example, to change the indicator to red using netcat:

> echo 1 | nc localhost 17357

The available messages are 0 (grey), 1 (red), 2 (green), 3 (yellow), and stop to kill the server. Short cut commands are provided so that integration with other scripts should be easier. Those commands are stopplicht-grey, stopplicht-red, stopplicht-green, stopplicht-yellow, and stopplicht-stop, respectively.

Additionally, you can use the stopplicht-exec command followed by your favorite command to turn the indicator yellow while the command runs and then red or green to indicate failure or success respectively. Failure is indicated by a non-zero exit code. For example:

> stopplicht-exec npm test

You can also throw in a file system watcher like wach for added excitement:

> wach stopplicht-exec npm test


There are some off the shelf test framework integrations if you don't feel like rolling your own.