chore: release v0.26.3

app.go

@@ -794,6 +794,10 @@ type App struct {
 	catFlexDVKDax      bool // raise the Flex transmit DAX button around a voice message
 	catFlexDecodeSpots bool // push WSJT-X decodes (heard stations) to the panadapter
 	catFlexDecodeSecs  int  // decode spot display duration (seconds)
+	// The panadapter palette, parsed once and re-read when it is saved. Guarded
+	// because the cluster read loop touches it on every spot.
+	spotColorsMu    sync.Mutex
+	spotColorsCache *SpotColors
 	// catSig / catShareSig fingerprint the last APPLIED link and share
 	// configuration, so re-applying an identical one is a no-op instead of a
 	// reconnection. Empty at startup, which is what makes the first call connect.
@@ -803,19 +807,21 @@ type App struct {
 	liveFreqHz       int64      // last freq/band/mode the UI reported (fallback when CAT is off)
 	liveBand         string
 	liveMode         string
-	livePublishTimer *time.Timer   // debounced live-status publish on activity change
+	livePublishTimer *time.Timer    // debounced live-status publish on activity change
-	liveLastQSOAt    time.Time     // when this operator last logged a NEW contact — drives online/offline
+	liveLastQSOAt    time.Time      // when this operator last logged a NEW contact — drives online/offline
-	liveTableMu      sync.Mutex    // guards liveTableFor
+	liveTableMu      sync.Mutex     // guards liveTableFor
-	liveTableFor     *sql.DB       // logbook whose live_status DDL has been ensured (once per connection, not per call)
+	liveTableFor     *sql.DB        // logbook whose live_status DDL has been ensured (once per connection, not per call)
-	awardSnapMu      sync.Mutex    // guards the award QSO snapshot
+	awardSnapMu      sync.Mutex     // guards the award QSO snapshot
-	awardSnapBuild   sync.Mutex    // serialises BUILDING it — see awardSnapshot
+	awardSnapBuild   sync.Mutex     // serialises BUILDING it — see awardSnapshot
-	awardSnapCap     int           // rows the last build produced, the capacity hint for the next
+	awardSnapCap     int            // rows the last build produced, the capacity hint for the next
-	awardSnap        []qso.QSO     // light-scanned + enriched logbook snapshot reused across award computations
+	awardSnap        []qso.QSO      // light-scanned + enriched logbook snapshot reused across award computations
-	awardSnapRev     string        // logbook revision the snapshot was built at ("" = none)
+	awardSnapRev     string         // logbook revision the snapshot was built at ("" = none)
-	awardSnapUsed    time.Time     // last read — the snapshot is dropped once it goes cold (see awardSnapshotJanitor)
+	awardSnapUsed    time.Time      // last read — the snapshot is dropped once it goes cold (see awardSnapshotJanitor)
-	webpub           webPublisher  // log-to-website publishing: debounce timer, periodic ticker, last result
+	workedRefMu      sync.Mutex     // guards the worked-reference sets
-	bandOpen         bandOpenState // sporadic-E / band-opening detector over the spot stream
+	workedRef        workedRefIndex // per-award references already in the log — see awardnew.go
-	dataDir          string        // <exeDir>/data — holds config.json, logs, cty.dat
+	webpub           webPublisher   // log-to-website publishing: debounce timer, periodic ticker, last result
+	bandOpen         bandOpenState  // sporadic-E / band-opening detector over the spot stream
+	dataDir          string         // <exeDir>/data — holds config.json, logs, cty.dat
 
 	// shuttingDown gates beforeClose re-entry: the first user attempt to
 	// close fires shutdown tasks (backup, future LoTW upload, ...) while
@@ -4734,6 +4740,9 @@ func (a *App) invalidateAwardStats() {
 	a.qsoNumMu.Lock()
 	a.qsoNumbers = nil
 	a.qsoNumMu.Unlock()
+	// Reference lists, award definitions and bulk edits all land here, and any of
+	// them can change what counts as already worked.
+	a.invalidateWorkedRefs()
 	// Bulk QSO changes (import, delete, bulk edit) also land here — refresh the
 	// worked-index so alert "needed" checks stay accurate. Async: never block the
 	// mutation, and it's a single lightweight query.
@@ -5113,9 +5122,14 @@ func (a *App) materializeAwardRefs(q qso.QSO) {
 		return
 	}
 	ac := a.newAwardMatCtx()
-	if err := a.qso.SetAwardRefs(a.ctx, q.ID, a.awardRefsJSONFor(ac, q)); err != nil {
+	refs := a.awardRefsJSONFor(ac, q)
+	if err := a.qso.SetAwardRefs(a.ctx, q.ID, refs); err != nil {
 		applog.Printf("award_refs: store for qso %d failed: %v", q.ID, err)
 	}
+	// Keep the NEW-badge sets in step with the contact just logged, rather than
+	// letting the revision change discard them while the operator types the next
+	// callsign. Off the logging path: it re-matches the QSO against every award.
+	go a.noteWorkedQSO(q)
 }
 
 // materializeAwardRefsForIDs recomputes award_refs for a specific set of QSOs
@@ -8681,11 +8695,20 @@ func (a *App) clusterEventWorker() {
 		// panadapter tunes AND switches mode — a DX cluster line carries no mode,
 		// so without this the radio only moved frequency.
 		if a.catFlexSpots && a.cat != nil {
+			mode := alerts.InferMode(s.Comment, s.FreqHz)
+			// Coloured by what the spot IS, which is the only thing worth knowing
+			// at a glance on a waterfall. Resolved from the same index the cluster
+			// grid uses, so a spot is never one colour on screen and another on
+			// the radio — and the index is cached, so this costs a map lookup.
+			status := a.spotStatusName(s.DXCall, s.Band, mode, s.POTARef)
+			col := a.spotColorFor(status)
 			a.cat.SendSpot(cat.SpotInfo{
-				FreqHz:   s.FreqHz,
+				FreqHz:          s.FreqHz,
-				Callsign: s.DXCall,
+				Callsign:        s.DXCall,
-				Mode:     alerts.InferMode(s.Comment, s.FreqHz),
+				Mode:            mode,
-				Comment:  s.Comment,
+				Comment:         spotComment(s.Comment, status),
+				Color:           col.Text,
+				BackgroundColor: col.Bg,
 			})
 		}
 	}
@@ -14850,10 +14873,14 @@ func (a *App) reloadCAT() {
 		// Native FlexRadio (SmartSDR) TCP API — no OmniRig needed.
 		fb := cat.NewFlex(s.FlexHost, s.FlexPort, s.FlexSpots)
 		// Clicking one of our spots on the panadapter fills the entry form.
-		fb.OnSpotClick = func(call string, hz int64) {
+		fb.OnSpotClick = func(call string, hz int64, mode string) {
 			if a.ctx != nil {
 				wruntime.EventsEmit(a.ctx, "flex:spot_clicked", map[string]any{"call": call, "freq_hz": hz})
 			}
+			// A spot clicked ON the panadapter deserves the same zoom as one
+			// clicked in the band map: the operator did the same thing and is
+			// looking at the same signal, and only the click's origin differs.
+			a.FlexZoomForSpot(mode, hz)
 		}
 		a.cat.Start(fb)
 	case "xiegu":
@@ -16512,11 +16539,17 @@ func newMotorClient(s UltrabeamSettings) motorAntenna {
 		}
 		return steppirAdapter{c: steppir.New(tr), freqMin: s.FreqMinMHz, freqMax: s.FreqMaxMHz}
 	}
-	// Ultrabeam is TCP only.
+	// Ultrabeam: serial or TCP, same as the SteppIR. The controller has an RS232
-	if strings.TrimSpace(s.Host) == "" {
+	// port, so a plain FTDI cable is the direct route; the Ethernet adapter is
+	// for putting the antenna at the far end of a link.
+	tr := ultrabeam.Transport{Mode: s.Transport, Host: strings.TrimSpace(s.Host), Port: s.Port, COM: strings.TrimSpace(s.COM), Baud: s.Baud}
+	if tr.Mode == "serial" && tr.COM == "" {
 		return nil
 	}
-	return ubAdapter{c: ultrabeam.New(s.Host, s.Port), freqMin: s.FreqMinMHz, freqMax: s.FreqMaxMHz}
+	if tr.Mode != "serial" && tr.Host == "" {
+		return nil
+	}
+	return ubAdapter{c: ultrabeam.New(tr), freqMin: s.FreqMinMHz, freqMax: s.FreqMaxMHz}
 }
 
 // startUltrabeam stops any existing client and starts a fresh one if the
@@ -18795,12 +18828,19 @@ type SpotQuery struct {
 
 // SpotStatus is the per-tuple result. Status is one of:
 //
-//	"new"        — entity never worked
+//	"new"            — entity never worked
-//	"new-band"   — entity worked but never on this band
+//	"new-band-mode"  — entity worked, but neither this band NOR this mode
-//	"new-mode"   — band worked, but this MODE never worked on the entity (any band)
+//	"new-band"       — entity worked in this mode, never on this band
-//	"new-slot"   — band & mode each worked before, but not this band+mode together
+//	"new-mode"       — band worked, but this MODE never worked on the entity (any band)
-//	"worked"     — exact band+mode already in the log
+//	"new-slot"       — band & mode each worked before, but not this band+mode together
-//	""           — couldn't resolve the entity (no cty.dat match)
+//	"worked"         — exact band+mode already in the log
+//	""               — couldn't resolve the entity (no cty.dat match)
+//
+// They are EXCLUSIVE and tested in that order, from most wanted to least. The
+// distinction that matters and used to be missing: an entity that is new on
+// both counts is not the same catch as one that is new on the band alone, and
+// neither is a "slot" — a slot is the pair still missing when each half is
+// already in the log.
 type SpotStatus struct {
 	Call      string `json:"call"`
 	Band      string `json:"band"`
@@ -19193,6 +19233,88 @@ func (a *App) lookupDecodeGrid(call string) string {
 	return a.decodeGridsOld[call]
 }
 
+// spotEntityStatus decides ONE spot's status from what the entity already has
+// in the log. Pure, and separate from the query that feeds it, because the
+// ORDER of these tests is the whole meaning of the answer and it deserves to be
+// read — and tested — without a database.
+//
+// Most wanted first, exclusive:
+//
+//	new            the entity has never been worked at all
+//	new-band-mode  worked, but neither this band nor this mode
+//	new-band       worked in this mode, never on this band
+//	new-mode       worked on this band, never in this mode (on any band)
+//	new-slot       both halves already in the log, never this pair
+//	worked         this exact band and mode
+//
+// new-band-mode is NOT a slot, and that is the distinction that was missing:
+// a slot is the pair still missing when each half is already worked. A station
+// that is new on both counts is a better catch than either, and it used to be
+// reported as a plain "new band".
+func spotEntityStatus(entityWorked, haveBand, haveMode, haveSlot bool, mode string) string {
+	if !entityWorked {
+		return "new"
+	}
+	// Without a mode nothing below "band" can be told apart from worked, and
+	// claiming "new" on a guess is the one mistake that costs a QSO.
+	if mode == "" {
+		if !haveBand {
+			return "new-band"
+		}
+		return "worked"
+	}
+	switch {
+	case !haveBand && !haveMode:
+		return "new-band-mode"
+	case !haveBand:
+		return "new-band"
+	case !haveMode:
+		return "new-mode"
+	case !haveSlot:
+		return "new-slot"
+	}
+	return "worked"
+}
+
+// spotStatusName resolves ONE spot to the palette key it should be drawn with.
+//
+// The entity status first — it is the headline — then the orthogonal markers,
+// which only speak when the entity says nothing new: a park is worth a colour
+// on a station you have already worked, and worth nothing on one you have not,
+// where "new entity" is the better thing to say.
+func (a *App) spotStatusName(call, band, mode, potaRef string) string {
+	if a.qso == nil {
+		return "none"
+	}
+	st := a.ClusterSpotStatuses([]SpotQuery{{Call: call, Band: band, Mode: mode, POTARef: potaRef}})
+	if len(st) == 0 {
+		return "none"
+	}
+	r := st[0]
+	if a.profiles != nil {
+		if p, err := a.profiles.Active(a.ctx); err == nil &&
+			strings.EqualFold(strings.TrimSpace(p.Callsign), strings.TrimSpace(call)) {
+			return "my-call"
+		}
+	}
+	switch r.Status {
+	case "new", "new-band-mode", "new-band", "new-mode", "new-slot":
+		return r.Status
+	}
+	switch {
+	case r.NewPOTA:
+		return "new-pota"
+	case r.NewCounty:
+		return "new-county"
+	case r.NewPfx:
+		return "new-pfx"
+	}
+	if r.Status == "worked" {
+		return "worked"
+	}
+	return "none"
+}
+
 func (a *App) ClusterSpotStatuses(spots []SpotQuery) []SpotStatus {
 	out := make([]SpotStatus, len(spots))
 	if a.qso == nil {
@@ -19357,33 +19479,18 @@ func (a *App) ClusterSpotStatuses(spots []SpotQuery) []SpotStatus {
 			out[i].Status = "new"
 			continue
 		}
-		if _, b := e.Bands[out[i].Band]; !b {
+		// The check mode goes through the same normaliser as the slot map
-			out[i].Status = "new-band"
+		// (digital grouping), and is resolved before the band test because
-			continue
+		// "new band" and "new mode" are now asked TOGETHER.
-		}
-		// Without a mode we can't distinguish the rest from "worked";
-		// the safer default is "worked" so we never falsely claim "new".
-		if out[i].Mode == "" {
-			out[i].Status = "worked"
-			continue
-		}
-		// Band already worked. If this MODE was never worked on the entity (any
-		// band) → new-mode. If the mode was worked elsewhere but not on THIS
-		// band+mode → new-slot. Otherwise → worked. The check mode goes through
-		// the same normaliser as the slot map (digital grouping).
 		checkMode := out[i].Mode
 		if normMode != nil {
 			checkMode = normMode(checkMode)
 		}
-		if _, m := e.Modes[checkMode]; !m {
+		_, haveBand := e.Bands[out[i].Band]
-			out[i].Status = "new-mode"
+		_, haveMode := e.Modes[checkMode]
-			continue
+
-		}
+		_, haveSlot := e.Slots[out[i].Band][checkMode]
-		if _, ok := e.Slots[out[i].Band][checkMode]; !ok {
+		out[i].Status = spotEntityStatus(true, haveBand, haveMode, haveSlot, out[i].Mode)
-			out[i].Status = "new-slot"
-			continue
-		}
-		out[i].Status = "worked"
 	}
 	return out
 }

awardnew.go

@@ -0,0 +1,235 @@
+package main
+
+// "Have I worked this reference before?" — the NEW badge on a QSO's award
+// references.
+//
+// # Where the answer comes from, and where it must NOT come from
+//
+// The obvious source is the materialised award_refs column: it is already on
+// every row and one query reads it. It is also the wrong answer twice over.
+// That column holds DISPLAY LABELS, not references — depending on the award's
+// RefDisplay it can read "Krasnogvardeysky" or "ST-25 — Krasnogvardeysky", and
+// DXCC stores a country name — and it is a derived cache that lags: a QSO whose
+// references were back-filled (see BackfillRDA) counts on the Awards grid long
+// before anything recomputes its column. The first build of this badge used it
+// and marked a district worked on five bands as NEW.
+//
+// So the answer comes from the same place the Awards grid's answer comes from:
+// award.MatchQSO over the logbook. What is engineered here is the COST of that,
+// because the question is asked while the operator is logging:
+//
+//   - the set is per award CODE, and built only for codes actually asked about;
+//   - it reuses the award snapshot when one is already in memory, which it
+//     usually is (the Awards tab, the cluster status index);
+//   - otherwise it STREAMS the logbook rather than materialising a second copy
+//     of it — the references of one award are a few thousand short strings;
+//   - and it is built in the BACKGROUND. A caller that asks before the set is
+//     ready is told so and gets no badge, never a wait and never a wrong badge.
+//
+// A freshly logged QSO's references are folded into the sets, so a normal
+// evening of logging never rebuilds anything.
+
+import (
+	"strings"
+
+	"hamlog/internal/award"
+	"hamlog/internal/qso"
+)
+
+// workedRefIndex is the per-code set of references already in the log, plus the
+// logbook revision it describes.
+type workedRefIndex struct {
+	rev      string
+	byCode   map[string]map[string]struct{}
+	building map[string]bool
+}
+
+// AwardRefNewResult answers one badge request.
+type AwardRefNewResult struct {
+	// New maps "CODE@REF" to "never worked". An entry whose award set is still
+	// building is ABSENT rather than false: "not worked" and "not known yet"
+	// must not look the same to the badge.
+	New map[string]bool `json:"new"`
+	// Pending is true when at least one award set is still being built, and the
+	// caller should ask again shortly.
+	Pending bool `json:"pending"`
+}
+
+// AwardRefsNew reports which of the given "CODE@REF" entries have never been
+// worked. Returns immediately, always.
+func (a *App) AwardRefsNew(entries []string) AwardRefNewResult {
+	res := AwardRefNewResult{New: map[string]bool{}}
+	if a.qso == nil || len(entries) == 0 {
+		return res
+	}
+	rev, err := a.qso.Revision(a.ctx)
+	if err != nil {
+		return res // logbook unreachable: no badge is the honest answer
+	}
+
+	// Group the request by award code, so one code is looked up once however
+	// many of its references are on the QSO.
+	want := map[string][]string{}
+	for _, e := range entries {
+		code, _, ok := splitRefEntry(e)
+		if !ok {
+			continue
+		}
+		want[code] = append(want[code], e)
+	}
+
+	a.workedRefMu.Lock()
+	if a.workedRef.rev != rev || a.workedRef.byCode == nil {
+		// The logbook moved on: every set describes a log that no longer exists.
+		a.workedRef = workedRefIndex{rev: rev, byCode: map[string]map[string]struct{}{}, building: map[string]bool{}}
+	}
+	var build []string
+	for code := range want {
+		set, ready := a.workedRef.byCode[code]
+		if !ready {
+			if !a.workedRef.building[code] {
+				a.workedRef.building[code] = true
+				build = append(build, code)
+			}
+			res.Pending = true
+			continue
+		}
+		for _, e := range want[code] {
+			_, ref, _ := splitRefEntry(e)
+			_, worked := set[ref]
+			res.New[e] = !worked
+		}
+	}
+	a.workedRefMu.Unlock()
+
+	for _, code := range build {
+		go a.buildWorkedRefs(code, rev)
+	}
+	return res
+}
+
+// splitRefEntry splits "RDA@ST-25" into its uppercased code and reference.
+func splitRefEntry(e string) (code, ref string, ok bool) {
+	at := strings.Index(e, "@")
+	if at <= 0 {
+		return "", "", false
+	}
+	code = strings.ToUpper(strings.TrimSpace(e[:at]))
+	ref = strings.ToUpper(strings.TrimSpace(e[at+1:]))
+	return code, ref, code != "" && ref != ""
+}
+
+// buildWorkedRefs collects every reference of one award already in the log.
+func (a *App) buildWorkedRefs(code string, rev string) {
+	set := map[string]struct{}{}
+	defer func() {
+		a.workedRefMu.Lock()
+		// Publish only against the revision we were asked for: a QSO logged while
+		// this ran has already reset the index, and a set built from the older log
+		// would claim to describe the newer one.
+		if a.workedRef.rev == rev && a.workedRef.byCode != nil {
+			a.workedRef.byCode[code] = set
+		}
+		delete(a.workedRef.building, code)
+		a.workedRefMu.Unlock()
+	}()
+
+	var def *award.Def
+	for _, d := range a.awardDefs() {
+		if strings.EqualFold(d.Code, code) {
+			dd := d
+			def = &dd
+			break
+		}
+	}
+	if def == nil {
+		return // unknown award: an empty set, so nothing is ever badged NEW
+	}
+	metas := a.awardRefMetas([]award.Def{*def})[strings.ToUpper(def.Code)]
+	collect := func(q *qso.QSO) {
+		for _, r := range award.MatchQSO(*def, metas, q) {
+			set[strings.ToUpper(strings.TrimSpace(r))] = struct{}{}
+		}
+	}
+
+	// The snapshot is already enriched and already in memory whenever the Awards
+	// tab has been open — by far the common case, and free.
+	if snap := a.awardSnapshotIfLoaded(); snap != nil {
+		for i := range snap {
+			collect(&snap[i])
+		}
+		return
+	}
+	// Otherwise stream. One pass, nothing retained but the reference strings.
+	_ = a.qso.IterateForAwards(a.ctx, func(q qso.QSO) error {
+		a.enrichQSOForAwards(&q)
+		collect(&q)
+		return nil
+	})
+}
+
+// awardSnapshotIfLoaded returns the award snapshot ONLY if one is already built
+// and current. Never builds one: the caller is a background convenience, and
+// reading the whole logbook for it is the cost this file exists to avoid.
+func (a *App) awardSnapshotIfLoaded() []qso.QSO {
+	rev, err := a.qso.Revision(a.ctx)
+	if err != nil {
+		return nil
+	}
+	a.awardSnapMu.Lock()
+	defer a.awardSnapMu.Unlock()
+	if a.awardSnap != nil && a.awardSnapRev == rev {
+		return a.awardSnap
+	}
+	return nil
+}
+
+// noteWorkedQSO folds a just-logged contact's references into the built sets, so
+// logging does not throw away work already done.
+func (a *App) noteWorkedQSO(q qso.QSO) {
+	a.workedRefMu.Lock()
+	codes := make(map[string]bool, len(a.workedRef.byCode))
+	for c := range a.workedRef.byCode {
+		codes[c] = true
+	}
+	a.workedRefMu.Unlock()
+	if len(codes) == 0 {
+		return
+	}
+	rev, err := a.qso.Revision(a.ctx)
+	if err != nil {
+		return
+	}
+	a.enrichQSOForAwards(&q)
+	found := map[string][]string{}
+	for _, d := range a.awardDefs() {
+		code := strings.ToUpper(d.Code)
+		if !codes[code] {
+			continue
+		}
+		metas := a.awardRefMetas([]award.Def{d})[code]
+		for _, r := range award.MatchQSO(d, metas, &q) {
+			found[code] = append(found[code], strings.ToUpper(strings.TrimSpace(r)))
+		}
+	}
+	a.workedRefMu.Lock()
+	defer a.workedRefMu.Unlock()
+	// Carry the sets forward to the new revision rather than dropping them: they
+	// were correct one contact ago, and that contact is what is being added.
+	a.workedRef.rev = rev
+	for code, refs := range found {
+		if set := a.workedRef.byCode[code]; set != nil {
+			for _, r := range refs {
+				set[r] = struct{}{}
+			}
+		}
+	}
+}
+
+// invalidateWorkedRefs drops every set. For the changes a revision cannot see —
+// award definitions edited, reference lists updated, QSLs confirmed.
+func (a *App) invalidateWorkedRefs() {
+	a.workedRefMu.Lock()
+	a.workedRef = workedRefIndex{}
+	a.workedRefMu.Unlock()
+}

awardnew_test.go

@@ -0,0 +1,22 @@
+package main
+
+import "testing"
+
+func TestSplitRefEntry(t *testing.T) {
+	code, ref, ok := splitRefEntry("rda@st-25")
+	if !ok || code != "RDA" || ref != "ST-25" {
+		t.Fatalf("got %q %q %v", code, ref, ok)
+	}
+	// The picker writes what the operator typed, spacing included.
+	if _, ref, _ = splitRefEntry("POTA@ fr-1234 "); ref != "FR-1234" {
+		t.Fatalf("not trimmed: %q", ref)
+	}
+	// A reference can contain the separator characters of a label; only the
+	// FIRST @ splits, so "IOTA@EU-064" survives and a stray one does not create
+	// an award out of nothing.
+	for _, bad := range []string{"", "RDA", "@ST-25", "RDA@", "RDA@  "} {
+		if _, _, ok := splitRefEntry(bad); ok {
+			t.Fatalf("%q accepted", bad)
+		}
+	}
+}

changelog.json

@@ -1,4 +1,40 @@
 [
+  {
+    "version": "0.26.3",
+    "date": "",
+    "en": [
+      "Ultrabeam: the controller can be reached over a plain serial port, not only over the network. It has an RS232 port and the PC is usually beside it, so an FTDI cable is the direct route — the RS232-to-Ethernet adapter is now only needed to put the antenna at the far end of a link. Same choice the SteppIR has always had, in the same place.",
+      "Docked band map: FIT and FTx are now two labelled buttons in its header. Fit-to-band was hidden behind the px/kHz readout — a control whose label is a measurement does not look like one, and switching it off left nothing on screen saying the option existed. Hiding the digital spots is available there too, and both follow the Band Map tab.",
+      "Stats: the Entities tile now says which entity was added to the log most recently, with the callsign and date that did it. Judged against the whole log — a contact is the first with its country once, and does not become the first again because a date filter hides the ones before it.",
+      "Docked band map: in fit-to-band the header no longer printed FIT twice, once as the readout and once as the button beside it.",
+      "Settings: what OpsLog does with a FlexRadio — panadapter spots, decode spots and the DAX switch for voice messages — now lives in the FlexRadio page with the per-band antennas and power, instead of at the foot of the CAT page. CAT keeps the link itself: an address and a port, as for every other backend.",
+      "Cluster settings: four paragraphs of explanation removed. The options they described are unchanged.",
+      "A spot that is a new band AND a new mode for an entity is now its own status, NEW BAND+MODE, ranked with NEW DXCC. It used to be reported as a plain new band, which reads as \"you have worked this entity in this mode, just not here\" — the opposite of the truth. It is not a new slot either: a slot is the pair still missing when each half is already in the log. The cluster, the band map, the decodes panel, the filters and the auto-call criteria all tell the two apart now.",
+      "Cluster filters: a \"my bands\" link selects every band from your own band list in one click. With nothing selected the filter lets every band through — including 4 m and 70 cm off the RBN feeds, which the list could not offer you to untick because they are not bands you have.",
+      "FlexRadio: cluster spots on the panadapter are now coloured by what they are. A text colour and a background colour per status — new entity, new band+mode, new band, new mode, new slot, new park, new county, new prefix, your own callsign, already worked — set in Settings → FlexRadio, with a preview of each pair. Every spot used to be the same orange, which threw away the only thing worth knowing at a glance on a waterfall.",
+      "FlexRadio: clicking a spot can resize the panadapter to suit the mode — 25 kHz for CW, 200 for phone, 50 for digital by default, each configurable, with an option to re-centre on the spot as well. A CW signal is a hair at 200 kHz and an FT8 window shows an eighth of its sub-band at 25 kHz; one width cannot serve all three. Settings → FlexRadio, off by default.",
+      "FlexRadio: panadapter spots now carry their status in the comment as well as their colour — [NEW DXCC], [NEW BAND+MODE], [NEW BAND] and so on.",
+      "FlexRadio: the panadapter zoom now also applies when you click a spot on the panadapter itself, not just in the band map or cluster.",
+      "FlexRadio: fixed the panadapter zoom leaving the clicked spot off screen. The display now re-centres whenever the spot would fall outside the new window, and stays put when it would not.",
+      "Awards (F3): a NEW badge marks each award reference on the current QSO that has never been worked, picked or detected alike."
+    ],
+    "fr": [
+      "Ultrabeam : le contrôleur se joint par un simple port série, plus seulement par le réseau. Il a une prise RS232 et le PC est en général juste à côté : un câble FTDI suffit — l'adaptateur RS232 vers Ethernet ne sert plus qu'à mettre l'antenne au bout d'une liaison. Le même choix que le SteppIR a toujours eu, au même endroit.",
+      "Bandmap ancrée : FIT et FTx sont désormais deux boutons nommés dans son en-tête. L'ajustement à la bande se cachait derrière l'indicateur px/kHz — un contrôle dont le libellé est une mesure n'a pas l'air d'un contrôle, et une fois désactivé plus rien à l'écran ne disait que l'option existait. Le masquage des spots numériques y est aussi, et les deux suivent l'onglet Bandmap.",
+      "Statistiques : la tuile Entités indique désormais quelle entité a été ajoutée au journal en dernier, avec l'indicatif et la date qui l'ont fait. Jugé sur le journal entier — un contact n'est le premier avec son pays qu'une fois, et ne le redevient pas parce qu'un filtre de date masque ceux d'avant.",
+      "Bandmap ancrée : en mode ajusté, l'en-tête n'affiche plus FIT deux fois, une comme indicateur et une comme bouton juste à côté.",
+      "Réglages : ce qu'OpsLog fait avec un FlexRadio — spots panadapter, spots de décodages et la bascule DAX pour les messages vocaux — se trouve désormais sur la page FlexRadio, avec les antennes et la puissance par bande, au lieu du bas de la page CAT. La page CAT garde la liaison elle-même : une adresse et un port, comme pour tous les autres backends.",
+      "Réglages du cluster : quatre pavés d'explication retirés. Les options qu'ils décrivaient sont inchangées.",
+      "Un spot qui est à la fois une nouvelle bande ET un nouveau mode pour une entité a désormais son propre statut, NOUVEAU BANDE+MODE, au même rang que NOUVEAU DXCC. Il était annoncé comme une simple nouvelle bande, ce qui se lit « tu as déjà fait cette entité dans ce mode, juste pas ici » — l'inverse de la vérité. Ce n'est pas non plus un nouveau slot : un slot est la paire qui manque quand chaque moitié est déjà au journal. Le cluster, la bandmap, le panneau des décodages, les filtres et les critères d'appel automatique font maintenant la différence.",
+      "Filtres du cluster : un lien « mes bandes » sélectionne d'un clic toutes les bandes de ta propre liste. Sans sélection, le filtre laisse passer toutes les bandes — y compris le 4 m et le 70 cm des flux RBN, que la liste ne pouvait pas te proposer de décocher puisque ce ne sont pas des bandes que tu as.",
+      "FlexRadio : les spots cluster sur le panadapter sont désormais colorés selon ce qu'ils sont. Une couleur de texte et une couleur de fond par statut — nouvelle entité, nouvelle bande+mode, nouvelle bande, nouveau mode, nouveau slot, nouveau parc, nouveau comté, nouveau préfixe, ton propre indicatif, déjà contacté — réglées dans Réglages → FlexRadio, avec un aperçu de chaque paire. Tous les spots étaient de la même couleur orange, ce qui jetait la seule chose qui compte au premier coup d'œil sur une cascade.",
+      "FlexRadio : cliquer un spot peut redimensionner le panadapter selon le mode — 25 kHz en CW, 200 en phonie, 50 en numérique par défaut, chacun réglable, avec une option pour recentrer aussi sur le spot. Un signal CW est un cheveu à 200 kHz et une fenêtre FT8 montre un huitième de sa sous-bande à 25 kHz ; une seule largeur ne peut pas servir les trois. Réglages → FlexRadio, désactivé par défaut.",
+      "FlexRadio : les spots du panadapter portent maintenant leur statut dans le commentaire en plus de la couleur — [NEW DXCC], [NEW BAND+MODE], [NEW BAND], etc.",
+      "FlexRadio : le zoom du panadapter s'applique aussi quand on clique un spot sur le panadapter lui-même, et plus seulement dans la bandmap ou le cluster.",
+      "FlexRadio : correction du zoom du panadapter qui laissait parfois le spot hors écran. L'affichage se recentre désormais dès que le spot sortirait de la nouvelle fenêtre, et ne bouge pas sinon.",
+      "Diplômes (F3) : un badge NEW signale chaque référence du QSO en cours jamais contactée, choisie à la main ou détectée."
+    ]
+  },
   {
     "version": "0.26.2",
     "date": "",

flexzoom.go

@@ -0,0 +1,122 @@
+package main
+
+// Panadapter auto-zoom on a spot click.
+//
+// A CW signal is 100 Hz wide, an FT8 slot 50 Hz in a 3 kHz sub-band, an SSB
+// station 2.7 kHz. One panadapter width cannot serve all three: at 200 kHz the
+// CW station you clicked is a hair, and at 25 kHz an FT8 window shows one
+// eighth of the traffic. So the width follows the MODE of the spot, which is
+// the only thing that determines how much spectrum is worth looking at.
+//
+// The command is SmartSDR's own: "display pan s <pan> bandwidth=<MHz>", with an
+// optional re-centre. Same approach as DXHunter, which is where the defaults
+// below come from.
+
+import (
+	"encoding/json"
+	"strings"
+
+	"hamlog/internal/cat"
+)
+
+const keyFlexZoom = "flex.spot_zoom"
+
+// FlexZoomSettings is the per-mode-group visible width, in kHz.
+//
+// kHz and not MHz: an operator thinks "25 kHz of CW", and a form asking for
+// 0.025 invites a zero too many — which on a panadapter is not an error message
+// but a display that has silently gone somewhere else.
+type FlexZoomSettings struct {
+	Enabled bool `json:"enabled"`
+	CWkHz   int  `json:"cw_khz"`
+	SSBkHz  int  `json:"ssb_khz"`
+	DigikHz int  `json:"digi_khz"`
+	// Centre re-centres the panadapter on EVERY spot, not just the ones that
+	// would otherwise fall outside the new window — the display always follows.
+	// Off by default: an operator who has arranged their window around a run
+	// frequency does not necessarily want it moved every time they look at
+	// someone else, and a spot already on screen stays where it is either way.
+	Centre bool `json:"centre"`
+}
+
+// defaultFlexZoom — the widths DXHunter settled on, in kHz.
+var defaultFlexZoom = FlexZoomSettings{Enabled: false, CWkHz: 25, SSBkHz: 200, DigikHz: 50, Centre: false}
+
+// flexZoomGroup maps a spot's mode to the three widths worth distinguishing.
+//
+// The mode arrives as whatever the cluster comment implied — "CW", "FT8",
+// "USB", "RTTY" — so this takes the ADIF-ish name, not the Flex one. Anything
+// unrecognised is digital, which is the safe end: a 50 kHz window is readable
+// for every mode, where 25 kHz is not.
+func flexZoomGroup(mode string) string {
+	switch strings.ToUpper(strings.TrimSpace(mode)) {
+	case "CW", "CWR", "CWL", "CWU":
+		return "cw"
+	case "SSB", "USB", "LSB", "AM", "FM", "NFM", "DFM", "SAM", "PHONE", "DV":
+		return "ssb"
+	}
+	return "digi"
+}
+
+// GetFlexZoom returns the settings, defaults included.
+func (a *App) GetFlexZoom() FlexZoomSettings {
+	out := defaultFlexZoom
+	if raw := a.settingOr(keyFlexZoom, ""); raw != "" {
+		var s FlexZoomSettings
+		if err := json.Unmarshal([]byte(raw), &s); err == nil {
+			out = normFlexZoom(s)
+		}
+	}
+	return out
+}
+
+// normFlexZoom clamps the widths to something a panadapter can actually show.
+// 1 kHz is narrower than most filters; 14 MHz is a whole HF spectrum.
+func normFlexZoom(s FlexZoomSettings) FlexZoomSettings {
+	clamp := func(v, def int) int {
+		if v < 1 || v > 14000 {
+			return def
+		}
+		return v
+	}
+	s.CWkHz = clamp(s.CWkHz, defaultFlexZoom.CWkHz)
+	s.SSBkHz = clamp(s.SSBkHz, defaultFlexZoom.SSBkHz)
+	s.DigikHz = clamp(s.DigikHz, defaultFlexZoom.DigikHz)
+	return s
+}
+
+// SaveFlexZoom persists the settings.
+func (a *App) SaveFlexZoom(s FlexZoomSettings) error {
+	b, err := json.Marshal(normFlexZoom(s))
+	if err != nil {
+		return err
+	}
+	a.setSetting(keyFlexZoom, string(b))
+	return nil
+}
+
+// FlexZoomForSpot resizes the panadapter for a spot that was just clicked.
+//
+// Called from the click handler, AFTER the rig has been tuned: the zoom is a
+// view change and must never delay the frequency change an operator is waiting
+// for. Does nothing at all unless the option is on and the backend is a Flex —
+// no other radio has a panadapter to zoom.
+func (a *App) FlexZoomForSpot(mode string, freqHz int64) {
+	if a.cat == nil {
+		return
+	}
+	z := a.GetFlexZoom()
+	if !z.Enabled {
+		return
+	}
+	khz := z.DigikHz
+	switch flexZoomGroup(mode) {
+	case "cw":
+		khz = z.CWkHz
+	case "ssb":
+		khz = z.SSBkHz
+	}
+	_ = a.cat.FlexDo(func(fc cat.FlexController) error {
+		return fc.ZoomPan(float64(khz)/1000, float64(freqHz)/1e6, z.Centre)
+	})
+}

flexzoom_test.go

@@ -0,0 +1,32 @@
+package main
+
+import "testing"
+
+// The width follows the mode, and an unrecognised mode must land on the widest
+// of the three: a 50 kHz window is readable for everything, where 25 kHz shows
+// one eighth of an FT8 sub-band.
+func TestFlexZoomGroup(t *testing.T) {
+	for mode, want := range map[string]string{
+		"CW": "cw", "cw": "cw", "CWR": "cw",
+		"SSB": "ssb", "USB": "ssb", "LSB": "ssb", "FM": "ssb", "AM": "ssb",
+		"FT8": "digi", "FT4": "digi", "RTTY": "digi", "JS8": "digi", "PSK31": "digi",
+		"": "digi", "something new": "digi",
+	} {
+		if got := flexZoomGroup(mode); got != want {
+			t.Errorf("flexZoomGroup(%q) = %q, want %q", mode, got, want)
+		}
+	}
+}
+
+// A width of zero would command "bandwidth=0.000000" and take the panadapter
+// somewhere the operator cannot get back from by eye.
+func TestNormFlexZoomClamps(t *testing.T) {
+	got := normFlexZoom(FlexZoomSettings{CWkHz: 0, SSBkHz: -5, DigikHz: 99999})
+	if got.CWkHz != defaultFlexZoom.CWkHz || got.SSBkHz != defaultFlexZoom.SSBkHz || got.DigikHz != defaultFlexZoom.DigikHz {
+		t.Errorf("out-of-range widths not replaced by the defaults: %+v", got)
+	}
+	ok := normFlexZoom(FlexZoomSettings{CWkHz: 10, SSBkHz: 150, DigikHz: 40})
+	if ok.CWkHz != 10 || ok.SSBkHz != 150 || ok.DigikHz != 40 {
+		t.Errorf("valid widths must be kept as they are: %+v", ok)
+	}
+}

frontend/src/App.tsx

@@ -22,7 +22,7 @@ import {
   GetSecretStatus, UnlockSecrets,
   RotatorGoTo, RotatorStop, SetActiveRotor,
   GetDBConnectionInfo, GetLogbookRevision,
-  GetUltrabeamStatus, SetUltrabeamDirection, UILog,
+  GetUltrabeamStatus, SetUltrabeamDirection, UILog, FlexZoomForSpot,
   GetAntGeniusStatus, GetAntGeniusSettings, AntGeniusActivate,
   GetTunerGeniusStatus, GetTunerGeniusSettings, TunerGeniusAutotune, TunerGeniusSetBypass, TunerGeniusSetOperate, TunerGeniusActivate,
   GetScpStatus, ScpLookup,
@@ -1690,7 +1690,7 @@ export default function App() {
   const [clusterLockMode, setClusterLockMode] = useState(() => lsBool('opslog.clusterLockMode', false));
   // Status filter chips. Empty set = show every status (including
   // already-worked). Otherwise only matching spots pass.
-  type SpotStatusKey = 'new' | 'new-band' | 'new-mode' | 'new-slot' | 'worked';
+  type SpotStatusKey = 'new' | 'new-band-mode' | 'new-band' | 'new-mode' | 'new-slot' | 'worked';
   // What the cluster can be FILTERED on. A superset of the entity status: a new
   // county or a new park is not a DXCC state, it is another dimension of the
   // same spot — which is why the grid shows them as separate badges. Filtering
@@ -3059,6 +3059,10 @@ export default function App() {
     }
     if (s.band) setBand(s.band);
     if (catState.connected) tuneRigCAT(s.freq_hz, m);
+    // The panadapter width follows the MODE of the spot, when the option is on.
+    // AFTER the tune, deliberately: a view change must never delay the frequency
+    // change the operator is waiting for. A no-op on any backend but a Flex.
+    FlexZoomForSpot(m ?? '', s.freq_hz ?? 0).catch(() => {});
     if (m) applyModeFromSpot(m);
     onCallsignInput(s.dx_call, { force: true });
     applySpotPOTA((s as any).pota_ref);
@@ -5676,6 +5680,20 @@ export default function App() {
               >
                 {clusterLockBand ? <Lock className="size-2.5" /> : <Unlock className="size-2.5" />} {band}
               </button>
+              {/* "My bands" in one click.
+                  
+                  No selection means EVERY band, which is what an operator wants
+                  the first time and never again: an RBN feed carries 4 m and
+                  70 cm, and the list above can only offer the bands you have
+                  configured — so a band you do not own could not be unticked,
+                  because it was never there to tick. Selecting your own list
+                  makes the filter finite, and the spot goes. */}
+              {clusterBands.size !== bands.length && (
+                <button type="button"
+                  onClick={() => setClusterBands(new Set(bands))}
+                  title={t('clu.myBandsTitle')}
+                  className="text-[10px] text-muted-foreground hover:text-foreground underline">{t('clu.myBands')}</button>
+              )}
               {clusterBands.size > 0 && (
                 <button type="button" onClick={() => setClusterBands(new Set())} className="text-[10px] text-muted-foreground hover:text-foreground underline">{t('clu.clear')}</button>
               )}
@@ -5687,6 +5705,9 @@ export default function App() {
           <div className="flex flex-wrap gap-1">
             {([
               { k: 'new'      as SpotFilterKey, label: 'NEW',       cls: 'bg-danger-muted text-danger-muted-foreground border-danger-border' },
+              // NEW BAND+MODE sits between NEW and NEW BAND, which is where it
+              // ranks: the entity is worked, but neither this band nor this mode.
+              { k: 'new-band-mode' as SpotFilterKey, label: 'NEW B+M', cls: 'bg-danger-muted text-danger-muted-foreground border-danger-border' },
               { k: 'new-band' as SpotFilterKey, label: 'NEW BAND',  cls: 'bg-warning-muted text-warning-muted-foreground border-warning-border' },
               { k: 'new-mode' as SpotFilterKey, label: 'NEW MODE',  cls: 'bg-caution-muted text-caution-muted-foreground border-caution-border' },
               { k: 'new-slot' as SpotFilterKey, label: 'NEW SLOT',  cls: 'bg-caution-muted text-caution-muted-foreground border-caution-border' },
@@ -7940,6 +7961,8 @@ export default function App() {
               // place a band map happens to be drawn.
               fitToBand={bandMapFit}
               onToggleFit={toggleBandMapFit}
+              hideDigital={bandMapHideFt}
+              onToggleHideDigital={toggleBandMapHideFt}
               keyNav
             />
           </div>

frontend/src/components/AwardRefSelector.tsx

@@ -1,6 +1,6 @@
 import { useEffect, useMemo, useState } from 'react';
 import { X, Plus, Loader2 } from 'lucide-react';
-import { SearchAwardReferences, GetAwardDefs, GetAwardReferenceMeta } from '../../wailsjs/go/main/App';
+import { SearchAwardReferences, GetAwardDefs, GetAwardReferenceMeta, AwardRefsNew } from '../../wailsjs/go/main/App';
 import {
   Select, SelectTrigger, SelectValue, SelectContent, SelectItem,
 } from '@/components/ui/select';
@@ -54,6 +54,34 @@ export function AwardRefSelector({ dxcc, value, onChange, fieldValues, heightCla
 
   const entries = value ? value.split(';').filter(Boolean) : [];
 
+  // Which of the picked references have never been worked. Asked of the backend
+  // only when the list of references actually changes — a handful of times per
+  // QSO — and it answers from an in-memory set (see awardnew.go).
+  //
+  // The first question about an award may arrive before its set is built, in
+  // which case the answer is "pending" and carries no verdict for it: we ask
+  // again rather than badge on a guess. Attempts are capped so a logbook that
+  // never finishes building cannot leave a timer running for the session.
+  const [isNew, setIsNew] = useState<Record<string, boolean>>({});
+  const entriesKey = entries.join(';');
+  useEffect(() => {
+    if (!entriesKey) { setIsNew({}); return; }
+    let alive = true;
+    let timer: number | undefined;
+    let tries = 0;
+    const ask = () => {
+      AwardRefsNew(entriesKey.split(';'))
+        .then((r: any) => {
+          if (!alive) return;
+          setIsNew(r?.new ?? {});
+          if (r?.pending && ++tries < 10) timer = window.setTimeout(ask, 700);
+        })
+        .catch(() => { if (alive) setIsNew({}); }); // no badge beats a wrong one
+    };
+    ask();
+    return () => { alive = false; if (timer) window.clearTimeout(timer); };
+  }, [entriesKey]);
+
   // When the reference set is cleared (a QSO was logged or the call was reset),
   // also blank the picker's own state — the search box and the highlighted /
   // selected reference — so the Awards tab starts fresh for the next contact.
@@ -256,7 +284,16 @@ export function AwardRefSelector({ dxcc, value, onChange, fieldValues, heightCla
                 }`}
                 onClick={() => setSelectedEntry(selectedEntry === entry ? null : entry)}
               >
-                <span className="font-mono font-semibold flex-1 truncate">{entry}</span>
+                <span className="font-mono font-semibold truncate">{entry}</span>
+                {isNew[entry] && (
+                  <span
+                    title={t('awrs.newRefHint')}
+                    className="shrink-0 px-1 rounded-sm text-[9px] leading-[14px] font-semibold tracking-wide bg-success-muted text-success border border-success-border"
+                  >
+                    {t('awrs.new')}
+                  </span>
+                )}
+                <span className="flex-1" />
                 <button
                   className="shrink-0 hover:text-destructive"
                   onClick={(e) => { e.stopPropagation(); removeEntry(entry); }}

frontend/src/components/BandMap.tsx

@@ -25,6 +25,16 @@ interface Spot {
   band?: string;
   comment?: string;
   spotter?: string;
+  // The park reference the POTA poller tagged this spot with. The map never
+  // reads it — the click handler upstream turns it into the QSO's POTA award
+  // reference — but it is declared so it cannot be lost by accident.
+  //
+  // It travelled only because the spot objects are passed through by reference
+  // and the type was erased. The first refactor to copy a spot field by field
+  // would have dropped the park silently, and the only symptom would be an
+  // activation logged without its reference. Same mistake as the status entry
+  // below, whose extra markers were arriving and undeclared.
+  pota_ref?: string;
 }
 
 // The FULL status entry, not the two fields the map used to declare. The extra
@@ -83,11 +93,12 @@ interface Props {
   // globally from the band-map tab toolbar.
   hideDigital?: boolean;
   fitToBand?: boolean;
-  // onToggleFit turns the zoom readout into the fit-to-band switch. Only the
+  // onToggleFit and onToggleHideDigital add the two switches to this map's own
-  // docked map passes it: the Band Map tab has the same control in its own
+  // header. Only the docked map passes them: the Band Map tab has both in its
-  // toolbar, above maps that all obey it at once, and a second switch inside
+  // toolbar, above maps that all obey them at once, and a switch inside each
-  // each card would be four ways to change one setting.
+  // card as well would be four ways to change one setting.
   onToggleFit?: () => void;
+  onToggleHideDigital?: () => void;
   // Mark stations that upload to LoTW (Settings → Appearance).
   showLotw?: boolean;
   // keyNav enables Ctrl+↑ / Ctrl+↓ to hop to the next spot above / below the rig
@@ -164,6 +175,7 @@ function LegendDot({ cls, colour, label }: { cls?: string; colour?: string; labe
 function statusLabel(s: string, t: (k: string) => string): string {
   switch (s) {
     case 'new':      return t('bmp.statusNew');
+    case 'new-band-mode': return t('bmp.statusNewBandMode');
     case 'new-band': return t('bmp.statusNewBand');
     case 'new-mode': return t('bmp.statusNewMode');
     case 'new-slot': return t('bmp.statusNewSlot');
@@ -191,7 +203,11 @@ function statusStyle(s: string): { pill: string; bar: string; line: string; dot:
   // line = SVG leader stroke (visible on hover)
   // dot  = small marker on the freq scale
   switch (s) {
-    case 'new':      return {
+    // NEW and NEW BAND+MODE share the strongest colour: both mean "there is
+    // something here you have never had", and a sixth shade in a palette read at
+    // a glance is a shade nobody can name.
+    case 'new':
+    case 'new-band-mode': return {
       pill: 'bg-danger-muted text-danger-muted-foreground border-danger-border hover:bg-danger-muted',
       bar:  'bg-danger',
       line: 'stroke-danger',
@@ -268,7 +284,7 @@ const BOT_PAD = 14;    // the top-most freq label isn't clipped at y=0
 // last; ties broken by closeness to the rig freq).
 const MAX_VISIBLE_SPOTS = 30;
 
-export function BandMap({ band, spots, spotStatus: spotStatusRaw, currentFreqHz, onSpotClick, onClose, side = 'right', onToggleSide, hideDigital = false, fitToBand = false, onToggleFit, keyNav = false, showLotw = false }: Props) {
+export function BandMap({ band, spots, spotStatus: spotStatusRaw, currentFreqHz, onSpotClick, onClose, side = 'right', onToggleSide, hideDigital = false, fitToBand = false, onToggleFit, onToggleHideDigital, keyNav = false, showLotw = false }: Props) {
   const { t } = useI18n();
 
   // The two display options are applied ONCE here, on the whole map, so the
@@ -366,6 +382,7 @@ export function BandMap({ band, spots, spotStatus: spotStatusRaw, currentFreqHz,
       const k = spotStatusKey(s.dx_call, s.band ?? '', s.comment ?? '', s.freq_hz);
       switch (spotStatus[k]?.status ?? '') {
         case 'new':      return 0;
+        case 'new-band-mode': return 0;
         case 'new-band': return 1;
         case 'new-slot': return 2;
         case 'new-call': return 2;
@@ -564,16 +581,18 @@ export function BandMap({ band, spots, spotStatus: spotStatusRaw, currentFreqHz,
           title={t('bmp.zoomOut')}>
           <Minus className="size-3" />
         </button>
-        {/* The readout IS the switch when the parent offers one — the header is
+        {/* A readout, not a switch.
-            already tight with four maps side by side, and a separate chip would
+            
-            cost width to say what this text says anyway. */}
+            It WAS the switch for a day: clicking the px/kHz value toggled
-        {onToggleFit ? (
+            fit-to-band, and in fit it read "FIT". Nobody found it — a control
-          <button type="button" onClick={onToggleFit} title={t('bmp.fitTitle')}
+            whose label is a measurement does not look like a control, and once
-            className={cn('shrink-0 font-mono text-[10px] normal-case tracking-normal whitespace-nowrap px-1 rounded border transition-colors',
+            switched off there was no longer anything on screen saying the option
-              fitToBand ? 'border-primary bg-primary text-primary-foreground' : 'border-border hover:bg-muted')}>
+            existed. The switches below say what they are. */}
-            {fitToBand ? t('bmp.fit') : `${pxPerKHz}px/kHz`}
+        {/* In fit mode the readout has nothing left to say — the lit FIT button
-          </button>
+            says it, and printing the word twice side by side is just noise. The
-        ) : (
+            Band Map tab's cards have no button, so there the readout keeps
+            reporting both states. */}
+        {(!fitToBand || !onToggleFit) && (
           <span className="shrink-0 font-mono text-[10px] normal-case tracking-normal whitespace-nowrap px-0.5">{fitToBand ? t('bmp.fit') : `${pxPerKHz}px/kHz`}</span>
         )}
         <button type="button" onClick={() => changeZoom(1)} disabled={fitToBand || zoomIdx === PX_PER_KHZ.length - 1}
@@ -581,6 +600,20 @@ export function BandMap({ band, spots, spotStatus: spotStatusRaw, currentFreqHz,
           title={t('bmp.zoomIn')}>
           <Plus className="size-3" />
         </button>
+        {onToggleFit && (
+          <button type="button" onClick={onToggleFit} title={t('bmp.fitTitle')}
+            className={cn('shrink-0 text-[10px] font-semibold normal-case tracking-normal px-1 rounded border transition-colors',
+              fitToBand ? 'border-primary bg-primary text-primary-foreground' : 'border-border text-muted-foreground hover:bg-muted')}>
+            {t('bmp.fit')}
+          </button>
+        )}
+        {onToggleHideDigital && (
+          <button type="button" onClick={onToggleHideDigital} title={t('bmp.hideFtTitle')}
+            className={cn('shrink-0 text-[10px] font-semibold normal-case tracking-normal px-1 rounded border transition-colors',
+              hideDigital ? 'border-primary bg-primary text-primary-foreground' : 'border-border text-muted-foreground hover:bg-muted')}>
+            {t('bmp.ftx')}
+          </button>
+        )}
         <button type="button" onClick={recenterOnRig}
           className="size-5 inline-flex items-center justify-center rounded hover:bg-muted"
           title={t('bmp.scrollToRig')}>

frontend/src/components/ChaseNewPanel.tsx

@@ -62,6 +62,7 @@ const CATEGORIES: Array<{ key: Category; labelKey: string; colour: string }> = [
 function categoryOf(s: ChaseNewSpot): Category | null {
   switch (s.status) {
     case 'new': return 'dxcc';
+    case 'new-band-mode': return 'band';
     case 'new-band': return 'band';
     case 'new-mode': return 'mode';
     case 'new-slot': return 'slot';

frontend/src/components/ClusterGrid.tsx

@@ -174,6 +174,7 @@ function cellText(value: any, color: string | null): any {
 function statusColor(s: SpotStatusEntry | undefined): string | null {
   switch (s?.status) {
     case 'new':
+    case 'new-band-mode':
     case 'new-band':
     case 'new-mode':
     case 'new-slot':
@@ -193,7 +194,7 @@ function statusColor(s: SpotStatusEntry | undefined): string | null {
 // (still loading, or entity unknown) are NOT dimmed — that would flicker.
 function isDull(s: SpotStatusEntry | undefined): boolean {
   if (!s || !s.status) return false;
-  if (s.status === 'new' || s.status === 'new-band' || s.status === 'new-mode' || s.status === 'new-slot' || s.status === 'new-call') return false;
+  if (s.status === 'new' || s.status === 'new-band-mode' || s.status === 'new-band' || s.status === 'new-mode' || s.status === 'new-slot' || s.status === 'new-call') return false;
   return !(s.worked_call || s.new_pota || s.new_county || s.new_pfx || s.new_grid);
 }
 
@@ -259,6 +260,7 @@ const makeColCatalog = (t: TFn): ColEntry[] => [
       const s = statusFor(p);
       const parts: string[] = [];
       if (s?.status === 'new') parts.push(t('clg2.newDxcc'));
+      else if (s?.status === 'new-band-mode') parts.push(t('clg2.newBandMode'));
       else if (s?.status === 'new-band') parts.push(t('clg2.newBand'));
       else if (s?.status === 'new-mode') parts.push(t('clg2.newMode'));
       else if (s?.status === 'new-slot') parts.push(t('clg2.newSlot'));
@@ -276,6 +278,7 @@ const makeColCatalog = (t: TFn): ColEntry[] => [
       const main = statusColor(s);
       if (main) {
         const label = s?.status === 'new' ? t('clg2.newDxcc')
+          : s?.status === 'new-band-mode' ? t('clg2.newBandMode')
           : s?.status === 'new-band' ? t('clg2.newBand')
             : s?.status === 'new-mode' ? t('clg2.newMode')
               : s?.status === 'new-slot' ? t('clg2.newSlot')
@@ -310,6 +313,7 @@ const makeColCatalog = (t: TFn): ColEntry[] => [
     tooltipValueGetter: (p: any) => {
       const s = statusFor(p);
       if (s?.status === 'new') return t('clg2.tipNewDxcc', { country: s?.country ?? '' });
+      if (s?.status === 'new-band-mode') return t('clg2.tipNewBandMode');
       if (s?.status === 'new-band') return t('clg2.tipNewBand');
       if (s?.status === 'new-slot') return t('clg2.tipNewSlotBand');
       if (s?.status === 'new-call') return t('clg2.tipNewCall');
@@ -338,10 +342,18 @@ const makeColCatalog = (t: TFn): ColEntry[] => [
     headerName: t('clg2.c.band'), field: 'band' as any, width: 75,
     defaultVisible: true,
     cellClass: 'font-mono',
-    // NEW BAND for this entity → the band cell is filled.
+    // NEW BAND for this entity → the band cell is filled. NEW BAND+MODE fills
-    cellStyle: (p: any) => (statusFor(p)?.status === 'new-band' ? fillStyle(NEW) : null) as any,
+    // it too: the band really is new, and leaving it plain would say the
+    // opposite of the status column beside it.
+    cellStyle: (p: any) => {
+      const st = statusFor(p)?.status;
+      return (st === 'new-band' || st === 'new-band-mode' ? fillStyle(NEW) : null) as any;
+    },
     cellRenderer: (p: any) => cellText(p.value, null),
-    tooltipValueGetter: (p: any) => (statusFor(p)?.status === 'new-band' ? t('clg2.tipNewBand') : undefined),
+    tooltipValueGetter: (p: any) => {
+      const st = statusFor(p)?.status;
+      return st === 'new-band-mode' ? t('clg2.tipNewBandMode') : st === 'new-band' ? t('clg2.tipNewBand') : undefined;
+    },
   },
   {
     group: 'Spot', label: t('clg2.c.mode'), colId: 'mode',
@@ -349,14 +361,18 @@ const makeColCatalog = (t: TFn): ColEntry[] => [
     defaultVisible: true,
     cellClass: 'font-mono',
     valueGetter: (p: any) => p.data ? inferSpotMode(p.data.comment ?? '', p.data.freq_hz) : '',
-    // Only NEW MODE pills the mode cell — there the mode itself is genuinely new
+    // NEW MODE and NEW BAND+MODE pill the mode cell — in both the mode itself is
-    // for the entity. NEW SLOT means band AND mode were each worked before (just
+    // genuinely new for the entity. NEW SLOT means band AND mode were each worked
-    // not together), so highlighting the mode cell would wrongly imply "CW is new";
+    // before (just not together), so highlighting the mode cell would wrongly
-    // that case is signalled by the Status badge alone.
+    // imply "CW is new"; that case is signalled by the Status badge alone.
-    cellStyle: (p: any) => (statusFor(p)?.status === 'new-mode' ? fillStyle('var(--caution)') : null) as any,
+    cellStyle: (p: any) => {
+      const st = statusFor(p)?.status;
+      return (st === 'new-mode' || st === 'new-band-mode' ? fillStyle('var(--caution)') : null) as any;
+    },
     cellRenderer: (p: any) => cellText(p.value, null),
     tooltipValueGetter: (p: any) => {
       const st = statusFor(p)?.status;
+      if (st === 'new-band-mode') return t('clg2.tipNewBandMode');
       if (st === 'new-mode') return t('clg2.tipNewMode');
       if (st === 'new-slot') return t('clg2.tipNewSlot');
       return undefined;

frontend/src/components/DecodesPanel.tsx

@@ -132,6 +132,9 @@ function catsOf(e: StatusEntry | undefined): Set<NewCat> {
   if (!e) return out;
   switch (e.status) {
     case 'new': out.add('dxcc'); break;
+    // NEW BAND+MODE lights BOTH badges: the two facts are true at once, and
+    // showing one of them would say the entity is already worked in the other.
+    case 'new-band-mode': out.add('band'); out.add('mode'); break;
     case 'new-band': out.add('band'); break;
     case 'new-mode': out.add('mode'); break;
     case 'new-slot': out.add('slot'); break;

frontend/src/components/SettingsModal.tsx

@@ -49,6 +49,7 @@ import {
   GetScpStatus, SetScpEnabled, DownloadScp,
   DownloadULSCounties, ULSStatus, BackfillUSCounties, BackfillRDA, RDADatabaseCount,
   GetCtyDatInfo, RefreshCtyDat, GetAwardReferenceMeta, UpdateAwardReferenceList,
+  GetSpotColors, SaveSpotColors, ResetSpotColors, GetFlexZoom, SaveFlexZoom,
   ComputeStationInfo,
   GetUIPref, SetUIPref,
   GetFlexState, GetFlexBandAntennas, SaveFlexBandAntennas, GetFlexBandPower, SaveFlexBandPower,
@@ -1283,6 +1284,54 @@ function ComingSoon({ id, icon: Icon }: { id: SectionId; icon?: any }) {
   );
 }
 
+// The panadapter statuses, in the order the cluster ranks them: most wanted
+// first, then the markers that are orthogonal to the entity, then the two
+// "nothing here" cases. Must match spotColorOrder in spotcolors.go — the Go side
+// is the authority, this list only decides the order of the rows.
+const SPOT_COLOR_ROWS = [
+  'new', 'new-band-mode', 'new-band', 'new-mode', 'new-slot',
+  'new-pota', 'new-county', 'new-pfx',
+  'my-call', 'worked', 'none',
+];
+
+// SmartSDR colours are #AARRGGBB — the alpha FIRST, which is not what CSS or an
+// <input type="color"> expects. These two convert between the radio's order and
+// the browser's, so the operator picks a colour in a normal picker and the radio
+// gets what it understands.
+function argbToCss(argb?: string): string {
+  const v = (argb ?? '').trim();
+  if (!/^#[0-9a-fA-F]{8}$/.test(v)) return '';
+  return `#${v.slice(3)}${v.slice(1, 3)}`; // #AARRGGBB → #RRGGBBAA
+}
+function cssToArgb(rgb: string, alpha: string): string {
+  const v = (rgb || '#000000').trim();
+  if (!/^#[0-9a-fA-F]{6}$/.test(v)) return '';
+  return `#${alpha}${v.slice(1)}`.toUpperCase();
+}
+
+// ArgbInput edits one #AARRGGBB value as what it really is: a colour and an
+// opacity. A single text field would be asking an operator to type eight hex
+// digits in an order no other program uses.
+function ArgbInput({ label, value, onChange }: { label: string; value: string; onChange: (v: string) => void }) {
+  const valid = /^#[0-9a-fA-F]{8}$/.test((value ?? '').trim());
+  const alpha = valid ? value.slice(1, 3).toUpperCase() : 'FF';
+  const rgb = valid ? `#${value.slice(3)}` : '#808080';
+  return (
+    <span className="flex items-center gap-1 shrink-0" title={label}>
+      <input type="color" value={rgb}
+        onChange={(e) => onChange(cssToArgb(e.target.value, alpha))}
+        className="size-6 rounded border border-border bg-transparent p-0 cursor-pointer" />
+      <select value={alpha}
+        onChange={(e) => onChange(cssToArgb(rgb, e.target.value))}
+        className="h-6 rounded border border-border bg-background text-[10px] px-0.5">
+        {[['FF', '100%'], ['C0', '75%'], ['80', '50%'], ['40', '25%'], ['20', '12%'], ['00', 'off']].map(([a, l]) => (
+          <option key={a} value={a}>{l}</option>
+        ))}
+      </select>
+    </span>
+  );
+}
+
 // FlexBandPanel — everything that follows the band, in ONE row per band:
 // antennas and TX power.
 //
@@ -1747,6 +1796,26 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
   };
   // cty.dat is not downloaded by OpsLog — it is shipped and reloaded from disk —
   // so the page reports it rather than offering a button it cannot honour.
+  // Panadapter spot palette. Saved on its own — it is a table of colours, not a
+  // form: waiting for the modal's Save to see a colour on the waterfall would
+  // make picking one a guessing game.
+  type SpotColor = { text: string; bg?: string };
+  const [spotColors, setSpotColors] = useState<{ enabled: boolean; colors: Record<string, SpotColor> }>({ enabled: true, colors: {} });
+  useEffect(() => { GetSpotColors().then((c: any) => setSpotColors(c ?? { enabled: true, colors: {} })).catch(() => {}); }, []);
+  const saveSpotColors = (next: { enabled: boolean; colors: Record<string, SpotColor> }) => {
+    setSpotColors(next);
+    SaveSpotColors(next as any).catch(() => {});
+  };
+  const setSpotColor = (k: string, patch: Partial<SpotColor>) => saveSpotColors({
+    ...spotColors,
+    colors: { ...spotColors.colors, [k]: { ...(spotColors.colors[k] ?? { text: '' }), ...patch } },
+  });
+  // Panadapter auto-zoom. Saved immediately for the same reason as the palette:
+  // the only way to judge a width is to click a spot and look at the radio.
+  const [flexZoom, setFlexZoom] = useState<{ enabled: boolean; cw_khz: number; ssb_khz: number; digi_khz: number; centre: boolean }>(
+    { enabled: false, cw_khz: 25, ssb_khz: 200, digi_khz: 50, centre: false });
+  useEffect(() => { GetFlexZoom().then((z: any) => setFlexZoom(z)).catch(() => {}); }, []);
+  const saveFlexZoom = (next: typeof flexZoom) => { setFlexZoom(next); SaveFlexZoom(next as any).catch(() => {}); };
   const [ctyInfo, setCtyInfo] = useState<{ entities: number; file_mod_time?: string }>({ entities: 0 });
   const [ctyBusy, setCtyBusy] = useState(false);
   useEffect(() => { GetCtyDatInfo().then((i) => setCtyInfo(i as any)).catch(() => {}); }, []);
@@ -2983,27 +3052,11 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
               <div className="col-span-2">
                 <FlexDiscover onPick={(ip, port) => setCatCfg((s) => ({ ...s, flex_host: ip, flex_port: port }))} />
               </div>
-              <label className="col-span-2 flex items-center gap-2 text-sm cursor-pointer">
+              {/* What OpsLog DOES with a Flex — panadapter spots, decode spots,
-                <Checkbox checked={!!catCfg.flex_spots} onCheckedChange={(c) => setCatCfg((s) => ({ ...s, flex_spots: !!c }))} />
+                  the DAX switch for voice messages — moved to Settings →
-                {t('cat.flexSpots')} <span className="text-xs text-muted-foreground">{t('cat.flexSpotsHint')}</span>
+                  FlexRadio, with the per-band antennas and power. What stays
-              </label>
+                  here is the link itself: an address and a port, which is what
-              <label className="col-span-2 flex items-center gap-2 text-sm cursor-pointer">
+                  this page is about for every other backend too. */}
-                <Checkbox checked={!!catCfg.flex_decode_spots} onCheckedChange={(c) => setCatCfg((s) => ({ ...s, flex_decode_spots: !!c }))} />
-                {t('cat.flexDecodeSpots')} <span className="text-xs text-muted-foreground">{t('cat.flexDecodeSpotsHint')}</span>
-              </label>
-              {catCfg.flex_decode_spots && (
-                <div className="col-span-2 flex items-center gap-2 pl-6">
-                  <Label className="text-sm">{t('cat.flexDecodeSecs')}</Label>
-                  <Input type="number" className="w-24" min={10} max={3600}
-                    value={catCfg.flex_decode_secs || 120}
-                    onChange={(e) => setCatCfg((s) => ({ ...s, flex_decode_secs: parseInt(e.target.value) || 120 }))} />
-                  <span className="text-xs text-muted-foreground">{t('cat.flexDecodeSecsHint')}</span>
-                </div>
-              )}
-              <label className="col-span-2 flex items-start gap-2 text-sm cursor-pointer">
-                <Checkbox className="mt-0.5" checked={!!catCfg.flex_dvk_dax} onCheckedChange={(c) => setCatCfg((s) => ({ ...s, flex_dvk_dax: !!c }))} />
-                <span>{t('cat.flexDvkDax')} <span className="text-xs text-muted-foreground">{t('cat.flexDvkDaxHint')}</span></span>
-              </label>
             </>
             )}
             {catCfg.backend === 'xiegu' && (
@@ -3480,7 +3533,10 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
 
   function UltrabeamPanel() {
     const isSteppir = ultrabeam.type === 'steppir';
-    const isSerial = isSteppir && ultrabeam.transport === 'serial';
+    // Serial is no longer a SteppIR-only route: an Ultrabeam controller has an
+    // RS232 port too, and a plain FTDI cable reaches it without the Ethernet
+    // adapter the TCP route needs.
+    const isSerial = ultrabeam.transport === 'serial';
     return (
       <>
         <SectionHeader
@@ -3494,10 +3550,10 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
           <div className="grid grid-cols-2 gap-3">
             <div className="space-y-1">
               <Label>{t('hw.motorType')}</Label>
-              {/* Ultrabeam is TCP only; picking it forces the transport back to TCP
+              {/* Both antennas take either route now, so picking a type no longer
-                  so the serial fields never apply to it. */}
+                  forces the transport. */}
               <Select value={ultrabeam.type ?? 'ultrabeam'}
-                onValueChange={(v) => setUltrabeam((s) => ({ ...s, type: v, transport: v === 'ultrabeam' ? 'tcp' : s.transport }))}>
+                onValueChange={(v) => setUltrabeam((s) => ({ ...s, type: v }))}>
                 <SelectTrigger className="h-9"><SelectValue /></SelectTrigger>
                 <SelectContent>
                   <SelectItem value="ultrabeam">Ultrabeam</SelectItem>
@@ -3505,7 +3561,7 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
                 </SelectContent>
               </Select>
             </div>
-            {isSteppir && (
+            {(
               <div className="space-y-1">
                 <Label>{t('hw.motorTransport')}</Label>
                 <Select value={ultrabeam.transport ?? 'tcp'}
@@ -4728,7 +4784,7 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
         {t(`ftx.c_${k}`)}
       </label>
     );
-    const KEYS: (keyof AutoCallCriteria)[] = ['dxcc', 'band', 'mode', 'slot', 'grid', 'county', 'pota', 'pfx'];
+    const KEYS: (keyof AutoCallCriteria)[] = ['dxcc', 'bandmode', 'band', 'mode', 'slot', 'grid', 'county', 'pota', 'pfx'];
     return (
       <>
         <SectionHeader title={t('sec.ftx')} hint={t('ftx.hint')} />
@@ -4898,7 +4954,6 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
           <div className="border-t border-border/60 pt-3 space-y-2">
             <div>
               <span className="text-sm font-medium">{t('clu.macros')}</span>
-              <p className="text-xs text-muted-foreground">{t('clu.macrosHint')}</p>
             </div>
             {/* Two columns of six: twelve rows stacked would push everything else
                 in this panel off the screen. */}
@@ -5012,7 +5067,6 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
                   </SelectContent>
                 </Select>
               </div>
-              <p className="text-[11px] text-muted-foreground leading-relaxed">{t('gsc.hint')}</p>
             </div>
           </div>
 
@@ -5074,7 +5128,6 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
                   />
                   <span className="text-xs text-muted-foreground">km</span>
                 </div>
-                <p className="text-[11px] text-muted-foreground leading-relaxed">{t('bo.nearKmHint')}</p>
 
                 {/* A live count, because a feed that is connected but silent looks
                     exactly like one that is broken until a number moves. */}
@@ -5117,7 +5170,6 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
                 </div>
               )}
             </div>
-            <p className="text-xs text-muted-foreground leading-relaxed">{t('clu.selfSpotHint')}</p>
           </div>
         </div>
 
@@ -7150,7 +7202,110 @@ export function SettingsModal({ onClose, onSaved, initialSection, onMainPaneChan
     tunergenius:    TunerGeniusPanelSettings,
     psu:            PSUPanelSettings,
     pgxl:           PGXLPanelSettings,
-    flex:           () => <FlexBandPanel bands={lists.bands ?? []} />,
+    flex:           () => (
+      <div className="space-y-6">
+        <FlexBandPanel bands={lists.bands ?? []} />
+        {/* Rendered here rather than inside FlexBandPanel so these keep writing
+            to the modal's own CAT settings, saved by its Save button. A panel
+            that saved them itself would be overwritten by that same Save a
+            moment later, using the values it had read on opening. */}
+        <div className="border-t border-border/60 pt-4 space-y-2">
+          <h4 className="text-sm font-semibold text-foreground">{t('cat.flexOptions')}</h4>
+          <label className="flex items-center gap-2 text-sm cursor-pointer">
+            <Checkbox checked={!!catCfg.flex_decode_spots} onCheckedChange={(c) => setCatCfg((s) => ({ ...s, flex_decode_spots: !!c }))} />
+            {t('cat.flexDecodeSpots')} <span className="text-xs text-muted-foreground">{t('cat.flexDecodeSpotsHint')}</span>
+          </label>
+          {catCfg.flex_decode_spots && (
+            <div className="flex items-center gap-2 pl-6">
+              <Label className="text-sm">{t('cat.flexDecodeSecs')}</Label>
+              <Input type="number" className="w-24" min={10} max={3600}
+                value={catCfg.flex_decode_secs || 120}
+                onChange={(e) => setCatCfg((s) => ({ ...s, flex_decode_secs: parseInt(e.target.value) || 120 }))} />
+              <span className="text-xs text-muted-foreground">{t('cat.flexDecodeSecsHint')}</span>
+            </div>
+          )}
+          <label className="flex items-start gap-2 text-sm cursor-pointer">
+            <Checkbox className="mt-0.5" checked={!!catCfg.flex_dvk_dax} onCheckedChange={(c) => setCatCfg((s) => ({ ...s, flex_dvk_dax: !!c }))} />
+            <span>{t('cat.flexDvkDax')} <span className="text-xs text-muted-foreground">{t('cat.flexDvkDaxHint')}</span></span>
+          </label>
+        </div>
+
+        {/* Auto-zoom on a spot click. Its own block: it changes the RADIO's
+            display, where everything above changes what OpsLog draws on it. */}
+        <div className="border-t border-border/60 pt-4 space-y-2">
+          <h4 className="text-sm font-semibold text-foreground">{t('flexzoom.title')}</h4>
+          <label className="flex items-center gap-2 text-sm cursor-pointer">
+            <Checkbox checked={flexZoom.enabled} onCheckedChange={(c) => saveFlexZoom({ ...flexZoom, enabled: !!c })} />
+            {t('flexzoom.enable')}
+          </label>
+          {flexZoom.enabled && (
+            <div className="pl-6 space-y-2">
+              <div className="flex items-center gap-3 flex-wrap">
+                {([['cw_khz', 'flexzoom.cw'], ['ssb_khz', 'flexzoom.ssb'], ['digi_khz', 'flexzoom.digi']] as const).map(([k, lbl]) => (
+                  <label key={k} className="flex items-center gap-1.5 text-xs">
+                    <span className="text-muted-foreground">{t(lbl)}</span>
+                    <Input type="number" min={1} max={14000} className="h-8 w-20"
+                      value={String((flexZoom as any)[k] ?? '')}
+                      onChange={(e) => saveFlexZoom({ ...flexZoom, [k]: parseInt(e.target.value, 10) || 0 } as any)} />
+                    <span className="text-muted-foreground">kHz</span>
+                  </label>
+                ))}
+              </div>
+              <label className="flex items-start gap-2 text-xs cursor-pointer">
+                <Checkbox className="mt-0.5" checked={flexZoom.centre} onCheckedChange={(c) => saveFlexZoom({ ...flexZoom, centre: !!c })} />
+                <span>{t('flexzoom.centre')} <span className="text-muted-foreground">{t('flexzoom.centreHint')}</span></span>
+              </label>
+            </div>
+          )}
+        </div>
+
+        {/* Spot colours, one row per status.
+            
+            Saved on the spot rather than on the modal's Save: this is a table of
+            colours, and having to close a dialog to see what a colour looks like
+            on the waterfall turns picking one into a guessing game. */}
+        <div className="border-t border-border/60 pt-4 space-y-2">
+          <div className="flex items-center justify-between gap-2">
+            <h4 className="text-sm font-semibold text-foreground">{t('spotcol.title')}</h4>
+            <button type="button" className="text-[11px] text-muted-foreground hover:text-foreground underline"
+              onClick={() => ResetSpotColors().then((c: any) => setSpotColors(c)).catch(() => {})}>
+              {t('spotcol.reset')}
+            </button>
+          </div>
+          {/* Whether spots are drawn at all comes first: colouring them is the
+              next question, and the two were on different pages. */}
+          <label className="flex items-center gap-2 text-sm cursor-pointer">
+            <Checkbox checked={!!catCfg.flex_spots} onCheckedChange={(c) => setCatCfg((s) => ({ ...s, flex_spots: !!c }))} />
+            {t('cat.flexSpots')}
+          </label>
+          <label className="flex items-center gap-2 text-sm cursor-pointer">
+            <Checkbox checked={spotColors.enabled}
+              onCheckedChange={(c) => saveSpotColors({ ...spotColors, enabled: !!c })} />
+            {t('spotcol.enable')}
+          </label>
+          {spotColors.enabled && (
+            <div className="rounded-md border border-border divide-y divide-border max-w-2xl">
+              {SPOT_COLOR_ROWS.map((k) => {
+                const c = spotColors.colors[k] ?? { text: '', bg: '' };
+                return (
+                  <div key={k} className="flex items-center gap-3 px-3 py-1.5">
+                    <span className="text-xs flex-1 min-w-0">{t('spotcol.s_' + k)}</span>
+                    {/* The preview is the point of the row: two colour boxes say
+                        nothing about what the pair looks like together. */}
+                    <span className="text-xs font-mono px-2 py-0.5 rounded"
+                      style={{ color: argbToCss(c.text) || undefined, background: argbToCss(c.bg) || undefined }}>
+                      DL1ABC
+                    </span>
+                    <ArgbInput label={t('spotcol.text')} value={c.text} onChange={(v) => setSpotColor(k, { text: v })} />
+                    <ArgbInput label={t('spotcol.bg')} value={c.bg ?? ''} onChange={(v) => setSpotColor(k, { bg: v })} />
+                  </div>
+                );
+              })}
+            </div>
+          )}
+        </div>
+      </div>
+    ),
     audio:          AudioPanel,
   };
 

frontend/src/components/StatsPanel.tsx

@@ -29,6 +29,7 @@ type ContestRun = { id: string; year: number; count: number; start: string; end:
 type Stats = {
   total: number; unique_calls: number; entities: number; continents: number;
   first_qso: string; last_qso: string;
+  last_new_dxcc: string; last_new_dxcc_num: number; last_new_dxcc_call: string; last_new_dxcc_date: string;
   confirmed_lotw: number; confirmed_eqsl: number; confirmed_qsl: number; confirmed_any: number;
   by_mode: Bucket[]; by_band: Bucket[]; by_band_category: BandCat[]; by_operator: Bucket[]; by_station: Bucket[];
   by_continent: Bucket[]; top_entities: Bucket[]; by_year: Bucket[]; by_month: Bucket[];
@@ -681,6 +682,16 @@ export function StatsPanel() {
   // real operating session (which is exactly when an hourly rate chart exists).
   const windowed = contest !== '' || (period === 'custom' && (stats?.rate?.length ?? 0) > 1);
 
+  // "last new: France - F5ABC - 2019-03-01": the entity most recently added to
+  // the log, and the contact that added it. Empty when no dated entity exists.
+  const lastNew = useMemo(() => {
+    if (!stats?.last_new_dxcc_date) return '';
+    const day = stats.last_new_dxcc_date.slice(0, 10);
+    const who = stats.last_new_dxcc_call ? ` · ${stats.last_new_dxcc_call}` : '';
+    const what = stats.last_new_dxcc || String(stats.last_new_dxcc_num || '');
+    return `${t('stats.lastNewDxcc')}: ${what}${who} · ${day}`;
+  }, [stats, t]);
+
   const span = useMemo(() => {
     if (!stats?.first_qso) return '';
     const f = new Date(stats.first_qso), l = new Date(stats.last_qso);
@@ -774,7 +785,11 @@ export function StatsPanel() {
       <div className="grid grid-cols-2 md:grid-cols-5 gap-2.5 mb-3">
         <StatTile label={t('stats.qsos')} value={nf(stats.total)} sub={span} accent="var(--chart-1)" />
         <StatTile label={t('stats.uniqueCalls')} value={nf(stats.unique_calls)} accent="var(--chart-2)" />
-        <StatTile label={t('stats.entities')} value={nf(stats.entities)} sub="DXCC" accent="var(--chart-5)" />
+        {/* The last one ADDED rides on the entities tile: it is the same
+            subject, and a tile of its own would push the five headline figures
+            onto two rows for one line of text. */}
+        <StatTile label={t('stats.entities')} value={nf(stats.entities)}
+          sub={lastNew || "DXCC"} accent="var(--chart-5)" />
         <StatTile label={t('stats.continents')} value={nf(stats.continents)} sub="/ 7" accent="var(--chart-8)" />
         <StatTile label={t('stats.confirmed')} value={`${stats.total ? ((stats.confirmed_any / stats.total) * 100).toFixed(0) : 0}%`}
           sub={`${nf(stats.confirmed_any)} / ${nf(stats.total)}`} accent="var(--success)" />

frontend/src/lib/autocall.ts

@@ -9,6 +9,7 @@
 
 export type AutoCallCriteria = {
   dxcc: boolean;      // entity never worked
+  bandmode: boolean;  // entity worked, but neither this band nor this mode
   band: boolean;      // entity never worked on this band
   mode: boolean;      // entity never worked in this mode
   slot: boolean;      // band and mode each worked, never together
@@ -37,7 +38,7 @@ export type AutoCallSettings = {
 };
 
 export const emptyCriteria: AutoCallCriteria = {
-  dxcc: false, band: false, mode: false, slot: false,
+  dxcc: false, bandmode: false, band: false, mode: false, slot: false,
   grid: false, county: false, pota: false, pfx: false,
 };
 
@@ -101,6 +102,10 @@ function anyCriterion(c: AutoCallCriteria): boolean {
 // meets reports whether a decode satisfies at least one ticked criterion.
 function meets(c: AutoCallCriteria, e: DecodeStatus): boolean {
   if (c.dxcc && e.status === 'new') return true;
+  // Each status is exclusive, so a station that is new on both counts matches
+  // ONLY this criterion — ticking "new band" alone would not catch it, which is
+  // the wrong way round: it is the better catch of the two.
+  if (c.bandmode && e.status === 'new-band-mode') return true;
   if (c.band && e.status === 'new-band') return true;
   if (c.mode && e.status === 'new-mode') return true;
   if (c.slot && e.status === 'new-slot') return true;

frontend/src/version.ts

@@ -1,6 +1,6 @@
 // Single source of truth for the app version shown in the UI (header + About).
 // Bump this on a release (the release script updates it alongside telemetry.go).
-export const APP_VERSION = '0.26.2';
+export const APP_VERSION = '0.26.3';
 
 // Author / credits, shown in Help -> About.
 export const APP_AUTHOR = 'F4BPO';

frontend/wailsjs/go/main/App.d.ts

@@ -89,6 +89,8 @@ export function AwardMissingQSOs(arg1:string):Promise<Array<qso.QSO>>;
 
 export function AwardRefsForQSOs(arg1:Array<number>):Promise<Record<number, Record<string, string>>>;
 
+export function AwardRefsNew(arg1:Array<string>):Promise<main.AwardRefNewResult>;
+
 export function AwardsFolder():Promise<string>;
 
 export function BackfillDistances():Promise<main.BackfillDistancesResult>;
@@ -365,6 +367,8 @@ export function FlexTXOnBand(arg1:string):Promise<void>;
 
 export function FlexTune(arg1:boolean):Promise<void>;
 
+export function FlexZoomForSpot(arg1:string,arg2:number):Promise<void>;
+
 export function GetACOMStatus():Promise<acom.Status>;
 
 export function GetADIFMonitor():Promise<main.ADIFMonitorConfig>;
@@ -459,6 +463,8 @@ export function GetFlexBandPower():Promise<Record<string, main.FlexBandPower>>;
 
 export function GetFlexState():Promise<cat.FlexTXState>;
 
+export function GetFlexZoom():Promise<main.FlexZoomSettings>;
+
 export function GetFolderSync():Promise<main.FolderSyncConfig>;
 
 export function GetFolderSyncStatus():Promise<main.FolderSyncStatus>;
@@ -539,6 +545,8 @@ export function GetSlotStats():Promise<qso.SlotStats>;
 
 export function GetSolarData():Promise<solar.Data>;
 
+export function GetSpotColors():Promise<main.SpotColors>;
+
 export function GetSpotTTLMinutes():Promise<number>;
 
 export function GetStartupStatus():Promise<main.StartupStatus>;
@@ -905,6 +913,8 @@ export function ResetDatabaseToDefault():Promise<void>;
 
 export function ResetRotorPresets():Promise<Array<main.RotorPreset>>;
 
+export function ResetSpotColors():Promise<main.SpotColors>;
+
 export function RestartApp():Promise<void>;
 
 export function RestartQSORecorder():Promise<void>;
@@ -967,6 +977,8 @@ export function SaveFlexBandAntennas(arg1:Record<string, main.FlexBandAnt>):Prom
 
 export function SaveFlexBandPower(arg1:Record<string, main.FlexBandPower>):Promise<void>;
 
+export function SaveFlexZoom(arg1:main.FlexZoomSettings):Promise<void>;
+
 export function SaveFolderSync(arg1:main.FolderSyncConfig):Promise<void>;
 
 export function SaveGridScopeSettings(arg1:main.GridScopeSettings):Promise<void>;
@@ -1003,6 +1015,8 @@ export function SaveRowColors(arg1:main.RowColorSettings):Promise<void>;
 
 export function SaveSelfSpotSettings(arg1:main.SelfSpotSettings):Promise<void>;
 
+export function SaveSpotColors(arg1:main.SpotColors):Promise<void>;
+
 export function SaveStationDevices(arg1:Array<main.StationDevice>):Promise<void>;
 
 export function SaveStationSettings(arg1:main.StationSettings):Promise<void>;

frontend/wailsjs/go/main/App.js

@@ -118,6 +118,10 @@ export function AwardRefsForQSOs(arg1) {
   return window['go']['main']['App']['AwardRefsForQSOs'](arg1);
 }
 
+export function AwardRefsNew(arg1) {
+  return window['go']['main']['App']['AwardRefsNew'](arg1);
+}
+
 export function AwardsFolder() {
   return window['go']['main']['App']['AwardsFolder']();
 }
@@ -670,6 +674,10 @@ export function FlexTune(arg1) {
   return window['go']['main']['App']['FlexTune'](arg1);
 }
 
+export function FlexZoomForSpot(arg1, arg2) {
+  return window['go']['main']['App']['FlexZoomForSpot'](arg1, arg2);
+}
+
 export function GetACOMStatus() {
   return window['go']['main']['App']['GetACOMStatus']();
 }
@@ -858,6 +866,10 @@ export function GetFlexState() {
   return window['go']['main']['App']['GetFlexState']();
 }
 
+export function GetFlexZoom() {
+  return window['go']['main']['App']['GetFlexZoom']();
+}
+
 export function GetFolderSync() {
   return window['go']['main']['App']['GetFolderSync']();
 }
@@ -1018,6 +1030,10 @@ export function GetSolarData() {
   return window['go']['main']['App']['GetSolarData']();
 }
 
+export function GetSpotColors() {
+  return window['go']['main']['App']['GetSpotColors']();
+}
+
 export function GetSpotTTLMinutes() {
   return window['go']['main']['App']['GetSpotTTLMinutes']();
 }
@@ -1750,6 +1766,10 @@ export function ResetRotorPresets() {
   return window['go']['main']['App']['ResetRotorPresets']();
 }
 
+export function ResetSpotColors() {
+  return window['go']['main']['App']['ResetSpotColors']();
+}
+
 export function RestartApp() {
   return window['go']['main']['App']['RestartApp']();
 }
@@ -1874,6 +1894,10 @@ export function SaveFlexBandPower(arg1) {
   return window['go']['main']['App']['SaveFlexBandPower'](arg1);
 }
 
+export function SaveFlexZoom(arg1) {
+  return window['go']['main']['App']['SaveFlexZoom'](arg1);
+}
+
 export function SaveFolderSync(arg1) {
   return window['go']['main']['App']['SaveFolderSync'](arg1);
 }
@@ -1946,6 +1970,10 @@ export function SaveSelfSpotSettings(arg1) {
   return window['go']['main']['App']['SaveSelfSpotSettings'](arg1);
 }
 
+export function SaveSpotColors(arg1) {
+  return window['go']['main']['App']['SaveSpotColors'](arg1);
+}
+
 export function SaveStationDevices(arg1) {
   return window['go']['main']['App']['SaveStationDevices'](arg1);
 }

frontend/wailsjs/go/models.ts

@@ -1873,6 +1873,20 @@ export namespace main {
 	        this.can_update = source["can_update"];
 	    }
 	}
+	export class AwardRefNewResult {
+	    new: Record<string, boolean>;
+	    pending: boolean;
+	
+	    static createFrom(source: any = {}) {
+	        return new AwardRefNewResult(source);
+	    }
+	
+	    constructor(source: any = {}) {
+	        if ('string' === typeof source) source = JSON.parse(source);
+	        this.new = source["new"];
+	        this.pending = source["pending"];
+	    }
+	}
 	export class AwardStatRow {
 	    label: string;
 	    cells: number[];
@@ -2501,6 +2515,26 @@ export namespace main {
 	        this.body = source["body"];
 	    }
 	}
+	export class FlexZoomSettings {
+	    enabled: boolean;
+	    cw_khz: number;
+	    ssb_khz: number;
+	    digi_khz: number;
+	    centre: boolean;
+	
+	    static createFrom(source: any = {}) {
+	        return new FlexZoomSettings(source);
+	    }
+	
+	    constructor(source: any = {}) {
+	        if ('string' === typeof source) source = JSON.parse(source);
+	        this.enabled = source["enabled"];
+	        this.cw_khz = source["cw_khz"];
+	        this.ssb_khz = source["ssb_khz"];
+	        this.digi_khz = source["digi_khz"];
+	        this.centre = source["centre"];
+	    }
+	}
 	export class FolderSyncConfig {
 	    enabled: boolean;
 	    folder: string;
@@ -3408,6 +3442,52 @@ export namespace main {
 	        this.minutes = source["minutes"];
 	    }
 	}
+	export class SpotColor {
+	    text: string;
+	    bg?: string;
+	
+	    static createFrom(source: any = {}) {
+	        return new SpotColor(source);
+	    }
+	
+	    constructor(source: any = {}) {
+	        if ('string' === typeof source) source = JSON.parse(source);
+	        this.text = source["text"];
+	        this.bg = source["bg"];
+	    }
+	}
+	export class SpotColors {
+	    enabled: boolean;
+	    colors: Record<string, SpotColor>;
+	
+	    static createFrom(source: any = {}) {
+	        return new SpotColors(source);
+	    }
+	
+	    constructor(source: any = {}) {
+	        if ('string' === typeof source) source = JSON.parse(source);
+	        this.enabled = source["enabled"];
+	        this.colors = this.convertValues(source["colors"], SpotColor, true);
+	    }
+	
+		convertValues(a: any, classs: any, asMap: boolean = false): any {
+		    if (!a) {
+		        return a;
+		    }
+		    if (a.slice && a.map) {
+		        return (a as any[]).map(elem => this.convertValues(elem, classs));
+		    } else if ("object" === typeof a) {
+		        if (asMap) {
+		            for (const key of Object.keys(a)) {
+		                a[key] = new classs(a[key]);
+		            }
+		            return a;
+		        }
+		        return new classs(a);
+		    }
+		    return a;
+		}
+	}
 	export class SpotQuery {
 	    call: string;
 	    band: string;
@@ -5016,6 +5096,10 @@ export namespace qso {
 	    continents: number;
 	    first_qso: string;
 	    last_qso: string;
+	    last_new_dxcc: string;
+	    last_new_dxcc_num: number;
+	    last_new_dxcc_call: string;
+	    last_new_dxcc_date: string;
 	    confirmed_lotw: number;
 	    confirmed_eqsl: number;
 	    confirmed_qsl: number;
@@ -5066,6 +5150,10 @@ export namespace qso {
 	        this.continents = source["continents"];
 	        this.first_qso = source["first_qso"];
 	        this.last_qso = source["last_qso"];
+	        this.last_new_dxcc = source["last_new_dxcc"];
+	        this.last_new_dxcc_num = source["last_new_dxcc_num"];
+	        this.last_new_dxcc_call = source["last_new_dxcc_call"];
+	        this.last_new_dxcc_date = source["last_new_dxcc_date"];
 	        this.confirmed_lotw = source["confirmed_lotw"];
 	        this.confirmed_eqsl = source["confirmed_eqsl"];
 	        this.confirmed_qsl = source["confirmed_qsl"];

internal/cat/cat.go

@@ -290,12 +290,20 @@ func (m *Manager) SetSplit(on bool, txHz int64) error {
 // the backend picks a default when it's empty. (Status-based colouring can be
 // driven later by setting Color per spot.)
 type SpotInfo struct {
-	FreqHz      int64
+	FreqHz   int64
-	Callsign    string
+	Callsign string
-	Mode        string
+	Mode     string
-	Color       string
+	// Color is the TEXT colour of the callsign on the panadapter, BackgroundColor
-	Comment     string
+	// the plate behind it. Both are #AARRGGBB — the alpha channel first, which is
-	LifetimeSec int // panadapter display seconds before auto-removal (0 = backend default)
+	// SmartSDR's order and not the web's.
+	//
+	// Two colours rather than one because that is what makes a spot readable at a
+	// glance on a busy waterfall: the fill carries the status and the text stays
+	// legible against it. An empty background leaves the radio's own default.
+	Color           string
+	BackgroundColor string
+	Comment         string
+	LifetimeSec     int // panadapter display seconds before auto-removal (0 = backend default)
 }
 
 // Spotter is an OPTIONAL backend capability: show cluster spots on the radio
@@ -475,7 +483,10 @@ type FlexController interface {
 	SetRXAntenna(string) error
 	SetTXAntenna(string) error
 	SetActiveSlice(int) error // focus slice idx so commands target it
-	SetTXSlice(int) error     // make slice idx the transmitter (tx=1)
+	// ZoomPan sets the visible width (MHz) of the active slice's panadapter and
+	// keeps freqMHz inside it, re-centring when it must. See Flex.ZoomPan.
+	ZoomPan(bandwidthMHz, freqMHz float64, centre bool) error
+	SetTXSlice(int) error // make slice idx the transmitter (tx=1)
 	SetSplit(bool) error
 	SetNB(bool) error
 	SetNBLevel(int) error

internal/cat/flex.go

@@ -66,18 +66,36 @@ type Flex struct {
 	pendingSplit    map[int]bool   // seq → awaiting the new TX slice's index (split create)
 	spotCall        map[int]string // spot index → callsign (to fill the call on a panadapter click)
 	spotMode        map[int]string // spot index → ADIF mode, so a click can also set the slice mode (SmartSDR tunes the spot's freq but not its mode)
-	spotByCall      map[string]int // callsign → live spot index, so re-spotting a call replaces its old spot (WSJT decodes re-fire every cycle)
+	spotFreq        map[int]int64  // spot index → Hz, so a click can report where it was (the trigger message carries only the index)
-	sentCmds        map[int]string // seq → command text, so an R<seq> error names the command
+	pendingSpotFreq map[int]int64  // seq → Hz, paired with pendingSpot
+	// panWindow is what each panadapter is currently showing, from its own status
+	// (centre and width, both MHz). Tracked because a zoom that only changes the
+	// WIDTH keeps the old centre, and the frequency the operator just clicked can
+	// end up outside the new window — see ZoomPan.
+	panWindow map[string]panView
+
+	spotByCall map[string]int // callsign → live spot index, so re-spotting a call replaces its old spot (WSJT decodes re-fire every cycle)
+	sentCmds   map[int]string // seq → command text, so an R<seq> error names the command
 
 	// OnSpotClick is called (off the reader goroutine's hot path) when the user
-	// clicks one of our spots on the panadapter, with the spot's callsign and
+	// clicks one of our spots on the panadapter, with the spot's callsign, its
-	// frequency. The host wires this to fill the entry form. Set before Connect.
+	// frequency and the mode it was spotted in — everything the host knows about
-	OnSpotClick func(callsign string, freqHz int64)
+	// the spot, since the radio's own notification carries only an index. The host
+	// wires this to fill the entry form and to size the panadapter. Set before Connect.
+	OnSpotClick func(callsign string, freqHz int64, mode string)
 }
 
+// panView is one panadapter's visible window, in MHz.
+type panView struct{ centre, width float64 }
+
 type flexSlice struct {
 	freqHz int64
 	mode   string // raw Flex mode (USB/LSB/CW/DIGU/…)
+	// pan is the panadapter this slice is displayed on ("0x40000000"), taken
+	// from the slice status. Kept PER SLICE rather than as one radio-wide id:
+	// with two slices on two bands there are two panadapters, and zooming the
+	// wrong one moves a display the operator is not looking at.
+	pan    string
 	active bool
 	tx     bool
 	inUse  bool
@@ -187,7 +205,7 @@ func NewFlex(host string, port int, spotsEnabled bool) *Flex {
 	return &Flex{
 		host: strings.TrimSpace(host), port: port,
 		slices: map[int]*flexSlice{}, spotsEnabled: spotsEnabled,
-		spotIdx: map[int]bool{}, pendingSpot: map[int]string{}, pendingSpotMode: map[int]string{}, spotCall: map[int]string{}, spotMode: map[int]string{}, spotByCall: map[string]int{}, pendingSplit: map[int]bool{},
+		spotIdx: map[int]bool{}, pendingSpot: map[int]string{}, pendingSpotMode: map[int]string{}, spotCall: map[int]string{}, spotMode: map[int]string{}, spotFreq: map[int]int64{}, pendingSpotFreq: map[int]int64{}, panWindow: map[string]panView{}, spotByCall: map[string]int{}, pendingSplit: map[int]bool{},
 		meterMeta: map[int]meterInfo{}, meterVal: map[int]float64{}, meterSub: map[int]bool{},
 		sentCmds: map[int]string{}, txSetAt: map[string]time.Time{},
 		pinnedSlice: -1,
@@ -248,6 +266,7 @@ func (f *Flex) Connect() error {
 	f.send("sub cwx all")       // CWX: the LIVE CW speed/pitch/break-in (transmit holds only a static default)
 	f.send("sub profile all")   // mic/global/tx profiles (for the mic-profile dropdown)
 	f.send("profile mic info")  // request the current mic profile list + selection
+	f.send("sub pan all")       // panadapter centre/bandwidth, so a zoom knows where the display already is
 	f.send("sub client all")    // learn the GUI client (SmartSDR) so we can bind to it (below)
 	f.startMeters(conn)         // open the UDP VITA-49 stream for live meters
 	if f.spotsEnabled {
@@ -341,11 +360,12 @@ func (f *Flex) reader(conn net.Conn) {
 				f.mu.Lock()
 				call := f.spotCall[idx]
 				mode := f.spotMode[idx]
+				hz := f.spotFreq[idx]
 				handler := f.OnSpotClick
 				f.mu.Unlock()
 				if call != "" && handler != nil {
 					debugLog.Printf("Flex: spot %d triggered → %s (mode %s)", idx, call, mode)
-					go handler(call, 0)
+					go handler(call, hz, mode)
 					// SmartSDR tunes the spot's frequency on click but does NOT apply
 					// its mode=, so set the slice mode ourselves from what we spotted.
 					if mode != "" {
@@ -388,14 +408,17 @@ func (f *Flex) reader(conn net.Conn) {
 			f.mu.Lock()
 			call, pending := f.pendingSpot[seq]
 			spotMode := f.pendingSpotMode[seq]
+			spotFreq := f.pendingSpotFreq[seq]
 			if pending {
 				delete(f.pendingSpot, seq)
 				delete(f.pendingSpotMode, seq)
+				delete(f.pendingSpotFreq, seq)
 			}
 			if pending && ok && len(parts) >= 3 {
 				if idx, e := strconv.Atoi(strings.TrimSpace(parts[2])); e == nil {
 					f.spotCall[idx] = call
 					f.spotMode[idx] = spotMode
+					f.spotFreq[idx] = spotFreq
 					f.spotIdx[idx] = true
 					f.spotByCall[strings.ToUpper(call)] = idx
 				}
@@ -692,6 +715,32 @@ func (f *Flex) handleStatus(payload string) {
 			}
 			f.mu.Unlock()
 		}
+		// Panadapter — "display pan 0x40000000 center=14.075 bandwidth=0.2 …".
+		// Only the window matters here; everything else about the display is
+		// SmartSDR's business.
+		if len(fields) >= 3 && fields[0] == "display" && fields[1] == "pan" {
+			id := fields[2]
+			f.mu.Lock()
+			w := f.panWindow[id]
+			for _, kv := range fields[3:] {
+				key, val, ok := splitKV(kv)
+				if !ok {
+					continue
+				}
+				switch key {
+				case "center":
+					if v, err := strconv.ParseFloat(val, 64); err == nil && v > 0 {
+						w.centre = v
+					}
+				case "bandwidth":
+					if v, err := strconv.ParseFloat(val, 64); err == nil && v > 0 {
+						w.width = v
+					}
+				}
+			}
+			f.panWindow[id] = w
+			f.mu.Unlock()
+		}
 		// Meter definitions — "meter <num>.src=… <num>.nam=… <num>.unit=… …".
 		// The unit scales the UDP values, the name labels them; subscribe to each
 		// new id so the radio streams it.
@@ -813,6 +862,7 @@ func (f *Flex) handleStatus(payload string) {
 					delete(f.spotIdx, idx)
 					delete(f.spotCall, idx)
 					delete(f.spotMode, idx)
+					delete(f.spotFreq, idx)
 				} else {
 					f.spotIdx[idx] = true
 				}
@@ -847,6 +897,8 @@ func (f *Flex) handleStatus(payload string) {
 			}
 		case "mode":
 			s.mode = val
+		case "pan":
+			s.pan = val
 		case "active":
 			s.active = val == "1"
 		case "tx":
@@ -1241,6 +1293,74 @@ func (f *Flex) SetMode(mode string) error {
 	return nil
 }
 
+// ZoomPan sets the visible width of the ACTIVE slice's panadapter, and puts the
+// frequency the operator clicked inside it.
+//
+// bandwidthMHz is the whole visible span, which is how SmartSDR expresses it —
+// not a zoom factor.
+//
+// Re-centring is the subtle part. SmartSDR keeps the panadapter's CENTRE when
+// only the width changes, so narrowing from 200 kHz to 25 for a CW spot — or
+// jumping to a spot clicked in the band map — regularly left the very signal the
+// operator asked for outside the new window: the radio had tuned to it, but the
+// display was showing somewhere else. So the centre moves when it must:
+//
+//	centre == true   always re-centre (the operator asked for it)
+//	centre == false  re-centre ONLY when freqMHz would fall outside the new
+//	                 window, leaving a settled display alone the rest of the time
+//
+// The test uses 40% of the width either side rather than the full half: a spot
+// pinned to the last pixel of the panadapter is visible in the arithmetic and
+// useless in practice.
+//
+// A no-op when the slice reports no panadapter, which is the case on a slice
+// that exists but is not displayed. Silent, because that is not a fault.
+// needRecentre decides whether the panadapter has to move for freqMHz to be
+// comfortably visible in a window of bandwidthMHz. forced short-circuits it.
+//
+// An unknown current centre (no pan status seen yet) counts as "would fall
+// outside": the display is more likely wrong than right, and re-centring on the
+// spot the operator just clicked is never the surprising answer.
+func needRecentre(cur panView, freqMHz, bandwidthMHz float64, forced bool) bool {
+	if freqMHz <= 0 {
+		return false // nothing to centre on
+	}
+	if forced {
+		return true
+	}
+	return cur.centre <= 0 || math.Abs(freqMHz-cur.centre) > bandwidthMHz*0.4
+}
+
+func (f *Flex) ZoomPan(bandwidthMHz, freqMHz float64, centre bool) error {
+	f.mu.Lock()
+	pan := ""
+	// The operator's slice, by the same rule as everything else — see
+	// mainSliceLocked. Zooming any other panadapter would move a display the
+	// operator is not looking at.
+	if _, sl := f.mainSliceLocked(); sl != nil {
+		pan = sl.pan
+	}
+	cur := f.panWindow[pan]
+	connected := f.conn != nil && f.gotHandle
+	f.mu.Unlock()
+	if !connected {
+		return fmt.Errorf("flex: not connected")
+	}
+	if pan == "" || bandwidthMHz <= 0 {
+		return nil
+	}
+	recentre := needRecentre(cur, freqMHz, bandwidthMHz, centre)
+	// Centre first, then width: SmartSDR clamps a window that would run past the
+	// end of the spectrum, and moving to the right place before widening leaves
+	// nothing to clamp.
+	if recentre {
+		f.send(fmt.Sprintf("display pan s %s center=%.6f", pan, freqMHz))
+	}
+	f.send(fmt.Sprintf("display pan s %s bandwidth=%.6f", pan, bandwidthMHz))
+	debugLog.Printf("Flex: zoom pan %s → %.4f MHz (centre=%v on %.6f, was %.6f)", pan, bandwidthMHz, recentre, freqMHz, cur.centre)
+	return nil
+}
+
 // SendSpot renders a cluster spot on the panadapter via "spot add". Spots carry
 // a lifetime so the radio expires them on its own (the API has no "spot clear").
 // Per the SmartSDR API, spaces inside a field value are encoded as 0x7F.
@@ -1276,6 +1396,7 @@ func (f *Flex) SendSpot(s SpotInfo) error {
 		delete(f.spotByCall, upperCall)
 		delete(f.spotCall, old)
 		delete(f.spotMode, old)
+		delete(f.spotFreq, old)
 		delete(f.spotIdx, old)
 	}
 	f.mu.Unlock()
@@ -1291,6 +1412,12 @@ func (f *Flex) SendSpot(s SpotInfo) error {
 	if m := flexEncode(adifModeToFlex(s.Mode, s.FreqHz)); m != "" {
 		cmd += " mode=" + m
 	}
+	// background_color is optional in the API and empty means "the radio's own".
+	// Sent only when set, so a spot with no configured background does not blank
+	// the default to nothing.
+	if bg := flexEncode(s.BackgroundColor); bg != "" {
+		cmd += " background_color=" + bg
+	}
 	if c := flexEncode(s.Comment); c != "" {
 		cmd += " comment=" + c
 	}
@@ -1302,6 +1429,7 @@ func (f *Flex) SendSpot(s SpotInfo) error {
 		f.mu.Lock()
 		f.pendingSpot[seq] = s.Callsign
 		f.pendingSpotMode[seq] = s.Mode
+		f.pendingSpotFreq[seq] = s.FreqHz
 		f.mu.Unlock()
 	}
 	return nil
@@ -1335,6 +1463,7 @@ func (f *Flex) ClearSpots() error {
 	f.spotIdx = map[int]bool{}
 	f.spotCall = map[int]string{}
 	f.spotMode = map[int]string{}
+	f.spotFreq = map[int]int64{}
 	f.spotByCall = map[string]int{}
 	connected := f.conn != nil
 	f.mu.Unlock()

internal/cat/flex_test.go

@@ -0,0 +1,34 @@
+package cat
+
+import "testing"
+
+func TestNeedRecentre(t *testing.T) {
+	pan := panView{centre: 14.100, width: 0.200}
+	// A spot the display is already showing comfortably: leave the window alone,
+	// which is the whole point of the option being off.
+	if needRecentre(pan, 14.110, 0.200, false) {
+		t.Fatal("moved a display that was already on the spot")
+	}
+	// Narrowing for a CW spot 40 kHz away: 25 kHz around the old centre would not
+	// reach it, so the centre must follow.
+	if !needRecentre(pan, 14.060, 0.025, false) {
+		t.Fatal("spot would have been left outside the new window")
+	}
+	// Near the very edge of the new window — visible in the arithmetic, useless
+	// in practice.
+	if !needRecentre(pan, 14.199, 0.200, false) {
+		t.Fatal("spot pinned to the edge counts as outside")
+	}
+	// The operator asked for it.
+	if !needRecentre(pan, 14.110, 0.200, true) {
+		t.Fatal("forced centring ignored")
+	}
+	// No pan status yet: assume the display is elsewhere.
+	if !needRecentre(panView{}, 14.110, 0.200, false) {
+		t.Fatal("unknown centre must re-centre")
+	}
+	// Nothing to centre on.
+	if needRecentre(pan, 0, 0.200, true) {
+		t.Fatal("centred on nothing")
+	}
+}

internal/qso/lastnewdxcc_test.go

@@ -0,0 +1,54 @@
+package qso
+
+import (
+	"testing"
+	"time"
+)
+
+// "When did I last add an entity" is judged against the whole log. A QSO that
+// was the fifth with its country must not become the first because the four
+// before it fall outside a date filter — that would announce a new one every
+// time the operator changed the period.
+func TestLastNewDXCCIgnoresThePeriodFilter(t *testing.T) {
+	firstByEntity := map[int]entityFirst{}
+	// Two entities, worked twice each, out of chronological order on purpose.
+	rows := []struct {
+		dxcc    int
+		at      string
+		call    string
+		country string
+	}{
+		{227, "2019-03-01", "F5ABC", "France"},
+		{291, "2021-07-04", "W1AW", "United States"},
+		{227, "2024-06-01", "F6XYZ", "France"},        // later, same entity
+		{291, "2018-01-01", "K1ZZ", "United States"},  // EARLIER than the one above
+	}
+	for _, r := range rows {
+		at, _ := time.Parse("2006-01-02", r.at)
+		if cur, seen := firstByEntity[r.dxcc]; !seen || at.Before(cur.at) {
+			firstByEntity[r.dxcc] = entityFirst{at: at, call: r.call, country: r.country}
+		}
+	}
+	if got := firstByEntity[291].call; got != "K1ZZ" {
+		t.Errorf("first US contact = %q, want K1ZZ (the earliest, whatever the row order)", got)
+	}
+	if got := firstByEntity[227].call; got != "F5ABC" {
+		t.Errorf("first French contact = %q, want F5ABC", got)
+	}
+
+	// The last new entity is the NEWEST of those firsts: France in 2019, not the
+	// 2024 French contact, and not the 2021 US one.
+	var s Stats
+	for num, f := range firstByEntity {
+		if f.at.After(parseTimeLoose(s.LastNewDXCCDate)) {
+			s.LastNewDXCC, s.LastNewDXCCNum, s.LastNewDXCCCall = f.country, num, f.call
+			s.LastNewDXCCDate = f.at.Format(time.RFC3339)
+		}
+	}
+	if s.LastNewDXCC != "France" || s.LastNewDXCCNum != 227 || s.LastNewDXCCCall != "F5ABC" {
+		t.Errorf("last new entity = %q/%d/%q, want France/227/F5ABC", s.LastNewDXCC, s.LastNewDXCCNum, s.LastNewDXCCCall)
+	}
+	if s.LastNewDXCCDate[:10] != "2019-03-01" {
+		t.Errorf("date = %q, want 2019-03-01", s.LastNewDXCCDate)
+	}
+}

internal/qso/stats.go

@@ -137,6 +137,13 @@ const gapThreshold = 30 * time.Minute
 const rateMaxHours = 7 * 24
 
 // Stats is the whole dashboard payload.
+// entityFirst is the first contact ever made with one DXCC entity.
+type entityFirst struct {
+	at      time.Time
+	call    string
+	country string
+}
+
 type Stats struct {
 	// Headline figures.
 	Total       int    `json:"total"`
@@ -146,6 +153,19 @@ type Stats struct {
 	FirstQSO    string `json:"first_qso"`  // RFC3339, "" when the log is empty
 	LastQSO     string `json:"last_qso"`
 
+	// The most recent entity worked for the FIRST time, and the contact that did
+	// it. "When did I last add one" is the question a DX chaser asks of a log,
+	// and it was the one figure the panel could not answer.
+	//
+	// Judged against the WHOLE log, never the selected period: an entity is new
+	// once, and a QSO that was the fifth with its country does not become the
+	// first because the four before it fall outside a date filter. Only the
+	// period filter decides whether that contact is SHOWN.
+	LastNewDXCC     string `json:"last_new_dxcc"`     // country name
+	LastNewDXCCNum  int    `json:"last_new_dxcc_num"` // ADIF entity number
+	LastNewDXCCCall string `json:"last_new_dxcc_call"`
+	LastNewDXCCDate string `json:"last_new_dxcc_date"` // RFC3339, "" if none
+
 	// Confirmations (of Total).
 	ConfirmedLoTW int `json:"confirmed_lotw"`
 	ConfirmedEQSL int `json:"confirmed_eqsl"`
@@ -331,6 +351,8 @@ func (r *Repo) Stats(ctx context.Context, from, to time.Time, contestID string,
 		monthC      = map[string]int{}
 		times       []entry // every dated QSO (+ its operator), for the rate / gap maths
 		first, last time.Time
+		// The earliest contact with each entity, for "last new DXCC".
+		firstByEntity = map[int]entityFirst{}
 	)
 
 	for rows.Next() {
@@ -346,6 +368,22 @@ func (r *Repo) Stats(ctx context.Context, from, to time.Time, contestID string,
 			return s, err
 		}
 
+		// The first contact with each entity, over the WHOLE log — recorded before
+		// every filter below, because being new is a property of the log and not
+		// of the period on screen.
+		if dxcc.Valid && dxcc.Int64 > 0 {
+			if t := parseTimeLoose(dateStr.String).UTC(); !t.IsZero() {
+				n := int(dxcc.Int64)
+				if cur, seen := firstByEntity[n]; !seen || t.Before(cur.at) {
+					firstByEntity[n] = entityFirst{
+						at:      t,
+						call:    strings.ToUpper(strings.TrimSpace(call.String)),
+						country: strings.TrimSpace(country.String),
+					}
+				}
+			}
+		}
+
 		// Contest filter first — same reasoning as the window below: a QSO that
 		// isn't in this contest must not reach ANY bucket.
 		if contestID != "" && strings.ToUpper(strings.TrimSpace(contestID2.String)) != contestID {
@@ -459,6 +497,16 @@ func (r *Repo) Stats(ctx context.Context, from, to time.Time, contestID string,
 		return s, err
 	}
 
+	// The newest of the first-contacts: the last entity added to the log.
+	for num, f := range firstByEntity {
+		if f.at.After(parseTimeLoose(s.LastNewDXCCDate)) {
+			s.LastNewDXCC = f.country
+			s.LastNewDXCCNum = num
+			s.LastNewDXCCCall = f.call
+			s.LastNewDXCCDate = f.at.Format(time.RFC3339)
+		}
+	}
+
 	s.UniqueCalls = len(calls)
 	s.Entities = len(entities)
 	s.Continents = len(contC)

internal/ultrabeam/transport_test.go

@@ -0,0 +1,57 @@
+package ultrabeam
+
+import (
+	"errors"
+	"io"
+	"net"
+	"testing"
+	"time"
+)
+
+// The two transports report a slow reply differently, and neither means the
+// link is gone: a remote TCP hop and a controller busy moving its motors both
+// look like silence. Getting this wrong tears the connection down on every poll.
+func TestTransientRead(t *testing.T) {
+	if !transientRead(timeoutErr{}) {
+		t.Errorf("a TCP read timeout must be transient")
+	}
+	// A serial port that stays silent returns (0, nil) forever; bufio gives up
+	// after a hundred empty reads with ErrNoProgress.
+	if !transientRead(io.ErrNoProgress) {
+		t.Errorf("a silent serial port must be transient")
+	}
+	if transientRead(io.EOF) {
+		t.Errorf("EOF is the link closing, not a slow reply")
+	}
+	if transientRead(errors.New("access denied")) {
+		t.Errorf("an open failure is not a slow reply")
+	}
+}
+
+// open must refuse a configuration it cannot honour rather than dial nothing.
+func TestOpenRejectsEmptyConfig(t *testing.T) {
+	if _, err := New(Transport{Mode: "serial"}).open(); err == nil {
+		t.Errorf("serial with no COM port must fail")
+	}
+	if _, err := New(Transport{Mode: "tcp"}).open(); err == nil {
+		t.Errorf("tcp with no host must fail")
+	}
+}
+
+// A missing baud is the controller's default, not zero — serial.Open would
+// reject 0 and the operator would see "invalid speed" for a field they never
+// knew existed.
+func TestDefaultBaud(t *testing.T) {
+	if got := New(Transport{Mode: "serial", COM: "COM3"}).tr.Baud; got != 9600 {
+		t.Errorf("default baud = %d, want 9600", got)
+	}
+}
+
+type timeoutErr struct{}
+
+func (timeoutErr) Error() string   { return "i/o timeout" }
+func (timeoutErr) Timeout() bool   { return true }
+func (timeoutErr) Temporary() bool { return true }
+
+var _ net.Error = timeoutErr{}
+var _ = time.Second

internal/ultrabeam/ultrabeam.go

@@ -1,19 +1,39 @@
-// Package ultrabeam drives an Ultrabeam remote-controlled antenna over TCP
+// Package ultrabeam drives an Ultrabeam remote-controlled antenna over SERIAL
-// (typically via an RS232↔Ethernet adapter). The wire protocol (STX/ETX
+// or TCP. The wire protocol (STX/ETX framing, DLE escaping, XOR checksum) and
-// framing, DLE escaping, XOR checksum) and command codes are the manufacturer's.
+// command codes are the manufacturer's, and identical on both: the Ethernet
+// route is an RS232↔Ethernet adapter passing the same bytes.
+//
+// Serial came second, which is the wrong way round for most stations: the
+// controller has an RS232 port and the PC is usually right next to it, so a
+// plain FTDI cable does the job and the adapter is only needed to put the
+// antenna at the other end of a link.
 package ultrabeam
 
 import (
 	"bufio"
 	"errors"
 	"fmt"
+	"io"
 	"log"
 	"net"
 	"runtime"
 	"sync"
 	"time"
+
+	"go.bug.st/serial"
 )
 
+// Transport says how to reach the controller. Mirrors internal/steppir, which
+// has had both routes from the start — one shape for the two antennas rather
+// than two shapes to remember.
+type Transport struct {
+	Mode string // "tcp" | "serial"
+	Host string // tcp
+	Port int    // tcp
+	COM  string // serial device (COM3, /dev/ttyUSB0)
+	Baud int    // serial baud
+}
+
 // Connection tuning. Remote operation (the antenna controller reached over the
 // internet, not the LAN) sees real latency and jitter, so the read timeout is
 // generous and a few transient timeouts are tolerated before the link is torn
@@ -64,9 +84,8 @@ const (
 )
 
 type Client struct {
-	host       string
+	tr         Transport
-	port       int
+	conn       io.ReadWriteCloser
-	conn       net.Conn
 	connMu     sync.Mutex
 	reader     *bufio.Reader
 	lastStatus *Status
@@ -129,15 +148,75 @@ type Status struct {
 	Connected        bool  `json:"connected"`
 }
 
-func New(host string, port int) *Client {
+func New(tr Transport) *Client {
+	if tr.Baud <= 0 {
+		tr.Baud = 9600
+	}
 	return &Client{
-		host:     host,
+		tr:       tr,
-		port:     port,
 		stopChan: make(chan struct{}),
 		seqNum:   0,
 	}
 }
 
+// open dials the transport. Callers hold connMu.
+func (c *Client) open() (io.ReadWriteCloser, error) {
+	if c.tr.Mode == "serial" {
+		if c.tr.COM == "" {
+			return nil, fmt.Errorf("ultrabeam: no serial port configured")
+		}
+		p, err := serial.Open(c.tr.COM, &serial.Mode{BaudRate: c.tr.Baud})
+		if err != nil {
+			return nil, err
+		}
+		// A finite read timeout so a silent controller cannot wedge the poll
+		// loop. Replaced per exchange by setReadTimeout below.
+		_ = p.SetReadTimeout(ubReadTimeout)
+		return p, nil
+	}
+	if c.tr.Host == "" {
+		return nil, fmt.Errorf("ultrabeam: no host configured")
+	}
+	dialer := net.Dialer{Timeout: 5 * time.Second, KeepAlive: ubKeepAlive}
+	return dialer.Dial("tcp", net.JoinHostPort(c.tr.Host, fmt.Sprintf("%d", c.tr.Port)))
+}
+
+// target names what the client is talking to, for the log.
+func (c *Client) target() string {
+	if c.tr.Mode == "serial" {
+		return fmt.Sprintf("%s @ %d baud", c.tr.COM, c.tr.Baud)
+	}
+	return fmt.Sprintf("%s:%d", c.tr.Host, c.tr.Port)
+}
+
+// setReadTimeout bounds the next read, whichever transport is open.
+//
+// TCP takes a deadline (an instant) and serial a timeout (a duration) — the two
+// libraries disagree, and the caller should not have to care.
+func (c *Client) setReadTimeout(d time.Duration) {
+	switch t := c.conn.(type) {
+	case net.Conn:
+		_ = t.SetReadDeadline(time.Now().Add(d))
+	case serial.Port:
+		_ = t.SetReadTimeout(d)
+	}
+}
+
+// transientRead reports a read that timed out rather than failed.
+//
+// The two transports say it differently. TCP returns a net.Error with
+// Timeout(); a serial port that stays silent returns (0, nil) on every read,
+// which bufio turns into io.ErrNoProgress after a hundred empty attempts.
+// Neither means the link is gone — over a remote link, or with a controller
+// busy moving its motors, a slow reply is ordinary.
+func transientRead(err error) bool {
+	var ne net.Error
+	if errors.As(err, &ne) && ne.Timeout() {
+		return true
+	}
+	return errors.Is(err, io.ErrNoProgress)
+}
+
 func (c *Client) Start() error {
 	c.running = true
 	go c.pollLoop()
@@ -174,9 +253,8 @@ func (c *Client) pollLoop() {
 			// Try to connect if not connected
 			c.connMu.Lock()
 			if c.conn == nil {
-				log.Printf("Ultrabeam: Not connected, attempting connection...")
+				log.Printf("Ultrabeam: Not connected, attempting connection to %s...", c.target())
-				dialer := net.Dialer{Timeout: 5 * time.Second, KeepAlive: ubKeepAlive}
+				conn, err := c.open()
-				conn, err := dialer.Dial("tcp", net.JoinHostPort(c.host, fmt.Sprintf("%d", c.port)))
 				if err != nil {
 					log.Printf("Ultrabeam: Connection failed: %v", err)
 					c.connMu.Unlock()
@@ -190,7 +268,7 @@ func (c *Client) pollLoop() {
 				c.conn = conn
 				c.reader = bufio.NewReader(c.conn)
 				pollFails = 0
-				log.Printf("Ultrabeam: Connected to %s:%d", c.host, c.port)
+				log.Printf("Ultrabeam: Connected to %s", c.target())
 			}
 			c.connMu.Unlock()
 
@@ -200,8 +278,7 @@ func (c *Client) pollLoop() {
 				// A single slow/lost reply over a remote link is normal — keep
 				// the connection (and the last status) for a few tries before
 				// tearing it down, so we don't churn reconnect/disconnect.
-				var ne net.Error
+				transient := transientRead(err)
-				transient := errors.As(err, &ne) && ne.Timeout()
 				pollFails++
 				if transient && pollFails < ubMaxPollTimeout {
 					log.Printf("Ultrabeam: status timeout (%d/%d), keeping link: %v", pollFails, ubMaxPollTimeout, err)
@@ -430,7 +507,7 @@ func (c *Client) sendCommand(cmd byte, data []byte) ([]byte, error) {
 	}
 
 	// Read the reply with a timeout generous enough for a remote link.
-	c.conn.SetReadDeadline(time.Now().Add(ubReadTimeout))
+	c.setReadTimeout(ubReadTimeout)
 	buffer, err := c.readPacket()
 	if err != nil {
 		return nil, err
@@ -467,7 +544,8 @@ func (c *Client) sendCommand(cmd byte, data []byte) ([]byte, error) {
 // behind by a command that timed out. A short read deadline lets it consume what
 // is there and stop quickly when the stream is clean. Caller holds connMu.
 func (c *Client) drainStale() {
-	c.conn.SetReadDeadline(time.Now().Add(5 * time.Millisecond))
+	c.setReadTimeout(5 * time.Millisecond)
+	defer c.setReadTimeout(ubReadTimeout) // leave the link on its normal budget
 	buf := make([]byte, 256)
 	for {
 		n, err := c.reader.Read(buf)

spotcolors.go

@@ -0,0 +1,225 @@
+package main
+
+// Panadapter spot colours, per status.
+//
+// A FlexRadio draws every OpsLog spot in one colour today, which throws away the
+// only thing worth knowing at a glance on a waterfall: whether the station is
+// worth stopping for. The radio's own API has always taken a text colour AND a
+// background colour per spot — see internal/cat/flex.go — so the information can
+// be carried without a single extra pixel of screen.
+//
+// The statuses are the ones the cluster already computes (see spotEntityStatus),
+// plus the three orthogonal markers an operator chases separately.
+
+import (
+	"encoding/json"
+	"strings"
+)
+
+// keySpotColors holds the per-status palette.
+const keySpotColors = "flex.spot_colors"
+
+// SpotColor is one status's pair. Both are #AARRGGBB — alpha FIRST, which is
+// SmartSDR's order, not the web's. An empty background leaves the radio's own.
+type SpotColor struct {
+	Text string `json:"text"`
+	Bg   string `json:"bg,omitempty"`
+}
+
+// SpotColors is the whole palette, keyed by the status names the cluster uses.
+//
+// Stored as a map rather than a struct with nine fields so a status added later
+// (a new award marker, say) needs no migration: an unknown key is ignored and a
+// missing one falls back to the default below.
+type SpotColors struct {
+	// Enabled off sends no colour at all, which is the behaviour before this
+	// existed: every spot in the radio's default orange. Kept as a real switch so
+	// turning it off is a genuine revert rather than "some other palette".
+	Enabled bool                 `json:"enabled"`
+	Colors  map[string]SpotColor `json:"colors"`
+}
+
+// spotColorOrder is the palette's canonical order — most wanted first, then the
+// orthogonal markers, then the two "nothing here" cases. The settings panel
+// renders it in this order, and it is the order the resolver tries.
+var spotColorOrder = []string{
+	"new", "new-band-mode", "new-band", "new-mode", "new-slot",
+	"new-pota", "new-county", "new-pfx",
+	"my-call", "worked", "none",
+}
+
+// defaultSpotColors is the shipped palette.
+//
+// Text colours are opaque and bright, backgrounds are the same hue at a fifth of
+// the alpha: a waterfall is dark and busy, and a solid plate behind the callsign
+// hides the very signal the operator is looking at. The scale runs red → amber →
+// blue for "never had it" → "missing a piece" → "already yours".
+var defaultSpotColors = map[string]SpotColor{
+	"new":           {Text: "#FFFF3B30", Bg: "#40FF3B30"}, // entity never worked — the one you stop for
+	"new-band-mode": {Text: "#FFFF6B22", Bg: "#40FF6B22"}, // neither band nor mode: nearly as good
+	"new-band":      {Text: "#FFFFCC00", Bg: "#40FFCC00"},
+	"new-mode":      {Text: "#FFFFA500", Bg: "#40FFA500"},
+	"new-slot":      {Text: "#FF5AC8FA", Bg: "#405AC8FA"},
+	"new-pota":      {Text: "#FF34C759", Bg: "#4034C759"},
+	"new-county":    {Text: "#FF30D158", Bg: "#4030D158"},
+	"new-pfx":       {Text: "#FFAF52DE", Bg: "#40AF52DE"},
+	"my-call":       {Text: "#FFFF2D55", Bg: "#60FF2D55"}, // someone spotted YOU
+	"worked":        {Text: "#FF9CA3AF", Bg: "#209CA3AF"}, // already in the log — present, quiet
+	"none":          {Text: "#FF9CA3AF", Bg: ""},          // status unresolved
+}
+
+// hexARGB accepts #AARRGGBB and nothing else. The Flex refuses anything shorter
+// with a command error the operator never sees, so a half-typed value must not
+// reach the radio — it is dropped here and the default is used instead.
+func hexARGB(s string) bool {
+	s = strings.TrimSpace(s)
+	if len(s) != 9 || s[0] != '#' {
+		return false
+	}
+	for i := 1; i < len(s); i++ {
+		c := s[i]
+		if !(c >= '0' && c <= '9' || c >= 'a' && c <= 'f' || c >= 'A' && c <= 'F') {
+			return false
+		}
+	}
+	return true
+}
+
+// normSpotColors drops anything that is not a valid colour, so the stored
+// palette can never make the radio reject a spot.
+func normSpotColors(s SpotColors) SpotColors {
+	out := SpotColors{Enabled: s.Enabled, Colors: map[string]SpotColor{}}
+	known := map[string]bool{}
+	for _, k := range spotColorOrder {
+		known[k] = true
+	}
+	for k, v := range s.Colors {
+		if !known[k] {
+			continue
+		}
+		c := SpotColor{}
+		if hexARGB(v.Text) {
+			c.Text = strings.ToUpper(strings.TrimSpace(v.Text))
+		}
+		if hexARGB(v.Bg) {
+			c.Bg = strings.ToUpper(strings.TrimSpace(v.Bg))
+		}
+		if c.Text != "" || c.Bg != "" {
+			out.Colors[k] = c
+		}
+	}
+	return out
+}
+
+// GetSpotColors returns the palette, filled with the defaults for every status
+// the operator has not overridden — so the panel always has a colour to show and
+// the resolver never has to decide what "unset" looks like.
+func (a *App) GetSpotColors() SpotColors {
+	out := SpotColors{Enabled: true, Colors: map[string]SpotColor{}}
+	if raw := a.settingOr(keySpotColors, ""); raw != "" {
+		var stored SpotColors
+		if err := json.Unmarshal([]byte(raw), &stored); err == nil {
+			stored = normSpotColors(stored)
+			out.Enabled = stored.Enabled
+			out.Colors = stored.Colors
+		}
+	}
+	for _, k := range spotColorOrder {
+		if _, ok := out.Colors[k]; !ok {
+			out.Colors[k] = defaultSpotColors[k]
+		}
+	}
+	return out
+}
+
+// SaveSpotColors persists the palette.
+func (a *App) SaveSpotColors(s SpotColors) error {
+	b, err := json.Marshal(normSpotColors(s))
+	if err != nil {
+		return err
+	}
+	a.setSetting(keySpotColors, string(b))
+	a.spotColorsMu.Lock()
+	a.spotColorsCache = nil // re-read on the next spot
+	a.spotColorsMu.Unlock()
+	return nil
+}
+
+// ResetSpotColors puts the shipped palette back.
+func (a *App) ResetSpotColors() SpotColors {
+	a.setSetting(keySpotColors, "")
+	a.spotColorsMu.Lock()
+	a.spotColorsCache = nil
+	a.spotColorsMu.Unlock()
+	return a.GetSpotColors()
+}
+
+// spotColorFor picks the pair for one spot status.
+//
+// Cached, because this runs on EVERY spot from every cluster — a busy evening is
+// several a second, and re-reading and re-parsing the settings JSON for each one
+// would put a database round trip in the middle of the cluster read loop.
+func (a *App) spotColorFor(status string) SpotColor {
+	a.spotColorsMu.Lock()
+	if a.spotColorsCache == nil {
+		c := a.GetSpotColors()
+		a.spotColorsCache = &c
+	}
+	p := a.spotColorsCache
+	a.spotColorsMu.Unlock()
+	if !p.Enabled {
+		return SpotColor{}
+	}
+	if c, ok := p.Colors[status]; ok {
+		return c
+	}
+	return p.Colors["none"]
+}
+
+// spotStatusTag is the short label appended to a panadapter spot's comment.
+//
+// The colour says WHAT a spot is only to someone who has learnt the palette; the
+// word says it to everyone, including the operator who set the colours a month
+// ago. Both, then — the same choice DXHunter makes, whose spots read
+// "10 dB 18 WPM CQ [AC0C] [United States] [NEW CTY]".
+//
+// Short on purpose: the comment shares a panadapter with the signals, and a
+// spot label that runs over its neighbours hides the very thing it describes.
+// "worked" and an unresolved entity get nothing at all — there is no news in
+// either, and the absence of a tag is itself the answer.
+func spotStatusTag(status string) string {
+	switch status {
+	case "new":
+		return "NEW DXCC"
+	case "new-band-mode":
+		return "NEW BAND+MODE"
+	case "new-band":
+		return "NEW BAND"
+	case "new-mode":
+		return "NEW MODE"
+	case "new-slot":
+		return "NEW SLOT"
+	case "new-pota":
+		return "NEW POTA"
+	case "new-county":
+		return "NEW COUNTY"
+	case "new-pfx":
+		return "NEW PFX"
+	case "my-call":
+		return "ME"
+	}
+	return ""
+}
+
+// spotComment appends the status tag to the cluster's own comment.
+func spotComment(comment, status string) string {
+	c := strings.TrimSpace(comment)
+	tag := spotStatusTag(status)
+	if tag == "" {
+		return c
+	}
+	if c == "" {
+		return "[" + tag + "]"
+	}
+	return c + " [" + tag + "]"
+}

spotcolors_test.go

@@ -0,0 +1,76 @@
+package main
+
+import "testing"
+
+// A colour the Flex refuses is a spot that never appears, and the command error
+// goes to a log nobody is reading. Anything that is not #AARRGGBB must be
+// dropped here rather than sent.
+func TestHexARGB(t *testing.T) {
+	for _, ok := range []string{"#FFFF3B30", "#00000000", "#ffabcdef", "#40FF6B22"} {
+		if !hexARGB(ok) {
+			t.Errorf("%q should be accepted", ok)
+		}
+	}
+	for _, bad := range []string{
+		"", "#FFF", "#FF3B30", "FFFF3B30", "#FFFF3B3", "#FFFF3B300",
+		"#GGFF3B30", "#FFFF3B3G", "red", "rgb(255,0,0)",
+	} {
+		if hexARGB(bad) {
+			t.Errorf("%q should be refused", bad)
+		}
+	}
+}
+
+// The stored palette must survive a round trip, and must not carry a status the
+// resolver does not know — an unknown key would be a colour nothing can ever use
+// and a field nobody can remove from the panel.
+func TestNormSpotColors(t *testing.T) {
+	in := SpotColors{Enabled: true, Colors: map[string]SpotColor{
+		"new":      {Text: "#FFFF3B30", Bg: "#40FF3B30"},
+		"new-band": {Text: "not a colour", Bg: "#40FFCC00"}, // half valid
+		"worked":   {Text: "", Bg: ""},                      // nothing at all
+		"invented": {Text: "#FF000000"},                     // not a status
+	}}
+	out := normSpotColors(in)
+	if got := out.Colors["new"].Text; got != "#FFFF3B30" {
+		t.Errorf("valid pair lost: %q", got)
+	}
+	if c := out.Colors["new-band"]; c.Text != "" || c.Bg != "#40FFCC00" {
+		t.Errorf("half-valid pair = %+v, want the background kept and the text dropped", c)
+	}
+	if _, ok := out.Colors["worked"]; ok {
+		t.Errorf("an entry with no colour at all must not be stored")
+	}
+	if _, ok := out.Colors["invented"]; ok {
+		t.Errorf("an unknown status must not be stored")
+	}
+}
+
+func TestSpotComment(t *testing.T) {
+	// The cluster's own text is kept: it carries the signal report and the
+	// operator's note, which is why the spot is readable in the first place.
+	if got := spotComment("CQ up 2", "new"); got != "CQ up 2 [NEW DXCC]" {
+		t.Fatalf("got %q", got)
+	}
+	// An empty comment must not produce a leading space on the panadapter.
+	if got := spotComment("", "new-band"); got != "[NEW BAND]" {
+		t.Fatalf("got %q", got)
+	}
+	// Nothing to say about a station already in the log.
+	if got := spotComment("loud", "worked"); got != "loud" {
+		t.Fatalf("got %q", got)
+	}
+	if got := spotComment("loud", "none"); got != "loud" {
+		t.Fatalf("got %q", got)
+	}
+	// Every colourable status except the two quiet ones is labelled, or the
+	// palette would say something the text does not.
+	for _, s := range spotColorOrder {
+		if s == "worked" || s == "none" {
+			continue
+		}
+		if spotStatusTag(s) == "" {
+			t.Fatalf("status %q has a colour but no tag", s)
+		}
+	}
+}

spotstatus_test.go

@@ -0,0 +1,59 @@
+package main
+
+import "testing"
+
+// The order of these tests IS the meaning of the answer, and it was wrong: a
+// station new on both the band and the mode was reported as a plain "new band",
+// which reads as "you have worked this entity in this mode, just not here" —
+// the opposite of the truth. It is also not a slot: a slot is the pair still
+// missing when each half is already in the log.
+func TestSpotEntityStatus(t *testing.T) {
+	for _, c := range []struct {
+		name                             string
+		worked, haveBand, haveMode, slot bool
+		mode                             string
+		want                             string
+	}{
+		{"entity never worked", false, false, false, false, "SSB", "new"},
+		{"entity never worked, no mode known", false, false, false, false, "", "new"},
+
+		// The case this exists for.
+		{"new band AND new mode", true, false, false, false, "SSB", "new-band-mode"},
+
+		// New band, but the mode is already in the log on another band.
+		{"new band only", true, false, true, false, "SSB", "new-band"},
+		// New mode, on a band already worked.
+		{"new mode only", true, true, false, false, "SSB", "new-mode"},
+		// Each half worked, never together: THAT is a slot.
+		{"new slot", true, true, true, false, "SSB", "new-slot"},
+		{"fully worked", true, true, true, true, "SSB", "worked"},
+
+		// No mode: only the band can be judged, and a guess must never claim new.
+		{"no mode, new band", true, false, false, false, "", "new-band"},
+		{"no mode, band worked", true, true, false, false, "", "worked"},
+	} {
+		if got := spotEntityStatus(c.worked, c.haveBand, c.haveMode, c.slot, c.mode); got != c.want {
+			t.Errorf("%s: got %q, want %q", c.name, got, c.want)
+		}
+	}
+}
+
+// Every status is reachable, and no two inputs collide on a status that should
+// be exclusive — the guard against someone "simplifying" the chain later.
+func TestSpotEntityStatusIsExhaustive(t *testing.T) {
+	seen := map[string]bool{}
+	for _, worked := range []bool{true, false} {
+		for _, band := range []bool{true, false} {
+			for _, mode := range []bool{true, false} {
+				for _, slot := range []bool{true, false} {
+					seen[spotEntityStatus(worked, band, mode, slot, "CW")] = true
+				}
+			}
+		}
+	}
+	for _, want := range []string{"new", "new-band-mode", "new-band", "new-mode", "new-slot", "worked"} {
+		if !seen[want] {
+			t.Errorf("no combination produces %q — the status is dead", want)
+		}
+	}
+}

telemetry.go

@@ -21,7 +21,7 @@ import (
 
 const (
 	// appVersion is stamped on every heartbeat (and could feed the About box).
-	appVersion = "0.26.2"
+	appVersion = "0.26.3"
 
 	// posthogHost is the PostHog ingestion endpoint. EU cloud by default; change
 	// to https://us.i.posthog.com for a US project.