send a colored status info from a batch file, for display with the SFKTray Windows GUI tool, with the sfk status command available on Windows, Mac OS X and Linux.
sfk status target[:port] "status text"
send a status to the SFKTray GUI tool for display.
this allows to run long scripts in background, like
- a script that produces several output packages
- a script that checks test devices if they're up
- a compile making binaries for 5 architectures
and to see their current state just by small lights
in the Windows system tray. a typical use is:
- show a yellow blinking light: a task is ongoing
- show a green light: task completed successfully
- show a red light: task failed
download SFKTray Free Edition now, which can
display two independent lights, by:
the lights are changed by the sfk status command.
the status is sent by UDP to the given target host,
or to "local" for your own machine.
v1 optional protocol version
slot=n target slot number 1-9
color=s set color s as one of:
red green blue yellow orangegray grey white cyan purple black
or with SFKTray Full only:
3- or 6 digit rgb hex value
e.g. f00 = red, dddddd = light gray
blink=s select 'slow' or 'fast' blink
timeout=n time in seconds to display status.
if not reconfirmed in that time
the slot color changes to gray.
display status for 15 seconds
then change slot color to orange
text='s' a text for display. must be surrounded
by any delimiter not part of the text,
normally single quotes ''
layout=n change layout to show 2, 4 or 9 slots.
requires SFKTray V1.0.2 or higher.
about the target machine
- use "local" if SFKTray runs on the same machine
- else supply hostname or IP
- default port used by SFKTray is 21343.
SFKTray Free cannot use a different port.
SFKTray Full can be run with a differen port like
then use: sfk status local:5000 ...
only one instance of SFKTray can be used per machine.
SFKTray Free supports 2 slots, i.e. slot=1 or slot=2.
SFKTray Full supports 9 status slots and is available from:
is supported without any chain input or output.
if a command behaves unexpected, compare exactly with the
examples given below. not every typing error is detected.
examplessfk status local "slot=1 color=yellow text='checking service'"
tell that a service is currently checked on slot 1
sfk status local "slot=1 color=green timeout=15,orange text='ok'"
tell that a service is currently running. the check must be
repeated within 15 seconds otherwise the status times out
and SFKTray changes the slot color to orange.
sfk status local "slot=1 color=red blink=slow text='service offline'"
tell about an offline service on localhost slot 1
sfk -var for i from 1 to 9 +status local "slot=#(i) color=gray" +endfor
reset all status slots