signal_hunt
Find and rank signals in receiver audio like a contest operator, prioritizing steady CQ callers, and return frequency, mode, strength, persistence, and modem to tune.
Instructions
Find and name the signals in the receiver audio and rank them the way a contest operator reads the waterfall: the station that sits still and calls CQ scores highest.
method 'audio' (default): tap seconds of audio from the input device (FLDIGI_AUDIO_DEVICE,
the device fldigi listens on; or device as a name substring or index; wav analyses a
file instead). Needs the optional extra: pip install 'fldigi-mcp[hunt]'.
method 'devices': list the input devices the tap can open.
method 'browser': read fldigi's Signal Browser (needs the browser patch, see the
browser tool): one candidate per channel the decoder bank holds, with its text,
for the current modem family (PSK, RTTY or CW). Finds stations the spectrum
analyser ranks near the floor, but names no mode: it reports what fldigi is set to.
method 'api': blind fallback with no audio access; steps modem.search_up across the
passband for each modem (mode='RTTY,BPSK31,...') and reads modem.get_quality. Slow.
Each candidate carries carrier_hz, mode (RTTY with shift, CW, BPSK31/63/125, Olivia with tones and bw, MFSK16, DominoEX, MT63, or unknown), db_over_floor, persistence (fraction of the window it was present), periodicity (a CQ loop repeats), score, and fldigi_modem, the name tune_to needs. Nothing here transmits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | ||
| wav | No | ||
| mode | No | ||
| device | No | ||
| method | No | audio | |
| seconds | No |