SignalMe 2.0.0-preview.3

Version française

SignalMe

SignalMe is a small presence runtime for Luxafor devices. It runs in your terminal, shows your availability on the device, plays expressive light signals, and switches the device to away by itself while your Windows session is locked — no GUI, no tray icon.

_{Rendered from the LED sequence the code actually produces, slowed down to be readable. Not a recording of a device.}

$ signalme
SignalMe 2.0.0-preview.3
Luxafor device detected.
Mode: manual
Status: off
Commands: help
Press Ctrl+C to stop.

> busy
Status: busy

> happy
Playing: happy
Restored: busy

> 
Windows session locked.
Effective status: away
> 
Windows session unlocked.
Effective status: busy
> ^C
Stopping SignalMe...
SignalMe stopped.

Why SignalMe?

• No GUI. One process in a terminal, driven by short commands typed at its prompt, stopped with Ctrl+C.
• Presence-aware. Lock your Windows session and the device turns purple; unlock it and your status comes back, untouched. You never have to set away yourself.
• Expressive. Durable availability statuses plus temporary light signals that return to your status on their own; ready intentionally ends on available.
• Honest. One component drives the device, every command it sends is checked, and SignalMe never reports a status the LEDs did not show. The device is turned off when SignalMe stops.

Install

SignalMe targets .NET 10 and runs on Windows. Installing it as a global .NET tool requires the .NET 10 SDK: dotnet tool install ships with the SDK, not with the runtime alone.

dotnet tool install --global SignalMe --prerelease

SignalMe 2.0 is in preview: without --prerelease, dotnet tool install picks the latest stable version, which is still the 1.x command-line tool. Then use signalme from any shell. dotnet tool update --global SignalMe --prerelease to update, dotnet tool uninstall --global SignalMe to remove.

Quick start

Launch SignalMe and leave it running:

signalme                   # same as: signalme --mode manual

It finds your Luxafor device, shows the status it remembered from the last run (or stays off), and waits at a > prompt. Type a status or a signal, status to see where things stand, off to switch the device off, help for the list. Ctrl+C turns the device off and exits.

Durable statuses stay on until you change them. Temporary signals play an animation and then put your durable status back. ready is the exception: it ends on available.

Durable statuses

away (purple) is no longer something you type: SignalMe shows it by itself while your Windows session is locked, and goes back to your status when you unlock it.

Temporary signals

A signal plays over your durable status, so it needs one: with SignalMe off, or while the session is locked, a signal is refused with a message. A lock during a signal stops it at once.

SignalMe remembers your durable status in your local application data and starts from it the next time. It never reports success for a command the device refused, and every failure has its own exit code.

Documentation

• Command reference — the command line, every interactive command, and the exit codes
• Statuses and signals — what each signal does, and what happens when it is interrupted
• Hardware and platform support — tested devices, Windows-only, several devices, session monitoring
• Troubleshooting — what each message means and what to do
• Development and releases — build, tests, CI, publishing

License

Apache-2.0