spaceicon

A small Go CLI that GETs a SpaceAPI endpoint, parses state.open, and prints a colourised status icon. Designed for status bars such as i3blocks.

No third-party dependencies — Go standard library only.

Build

make build           # produces ./bin/spaceicon
make install         # installs to ~/.local/bin/spaceicon

Usage

spaceicon https://example.org/spaceapi.json

Output is one line: a green icon if the space is open, a red icon if closed, a red error icon on any failure (network, parse, missing state.open).

i3blocks mode

spaceicon --i3block https://example.org/spaceapi.json

Emits the three-line format i3blocks expects:

<icon>
SpaceAPI
<#hex-color>

Wire it into your i3blocks config with a short interval (e.g. 30).

Other flags

• --version — print version, commit, build date.
• SPACEICON_DEBUG=1 — write parse diagnostics to stderr.

Releases

CI for spaceicon lives in this repo. The previous reference inside the spaceApiEndpoint repo's stashed CI workflow is obsolete.

License

GPL v3 — see LICENSE.