lw-who-uses
============

Copyright (c) HOPLA Productions 2026
Created by Vincent Verschuren

Standalone Windows diagnostic tool for Livewire ADVD source allocation.
No installation or separate .NET runtime is required.

Version: 1.0.0

Quick start
-----------

Inspect one Livewire channel:

    lw-who-uses.exe 25201

List all advertised Livewire sources and channels:

    lw-who-uses.exe --sources

List all channels whose usage status is known:

    lw-who-uses.exe --all

Listen without sending any ADVD, LWCP or LWCPss request:

    lw-who-uses.exe 25201 --passive

Keep monitoring and show changes:

    lw-who-uses.exe --all --watch

Show all options:

    lw-who-uses.exe --help

Network behavior
----------------

By default the tool discovers Livewire devices and sends bounded, read-only
requests for missing source, allocation and fader information. It never sends
WRIN or SET commands and therefore does not claim, renew or release sources,
change routes, or alter console configuration.

Use --passive when the tool must only receive multicast traffic and may not
make any ADVD, LWCP or LWCPss request. Passive results can take longer and may
remain UNKNOWN when the required state is not announced during the listening
period.

Result states
-------------

FREE     Allocation state was observed and no owner is present.
USED     Allocation state was observed with an owner.
UNKNOWN  The source was advertised but no allocation state was observed.

Package
-------

This package contains the standalone Win32/x86 executable. SHA256SUMS.txt
contains its SHA-256 checksum for integrity verification.

Windows Firewall can request permission when the tool first joins the
Livewire multicast group. Allow access only on the intended Livewire network
profile and follow the local network-management policy.
