Skip to content
N2WQPublic

About

GoCluster is a high-performance DX cluster for amateur. Developed by a contester for contesters. Combines RBN, PSKReporter & peer feeds with call correction, path reliability, and Boolean filters.

Topics

Resources

Stars

10 stars

Watchers

1 watching

Forks

Latest commit

 

History

810 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

title GoCluster DX Cluster
description Connect to GoCluster, use numbered Boolean filters, and operate a bounded DX cluster.

GoCluster helps amateur radio operators find stations on the air. It collects spots (reports of a station heard at a particular frequency) and sends them to your telnet client or logging program. You can choose which spots to see, hide repeated reports, and view optional hints about radio conditions.

Important

This checkout adds independent GO and native CC filters with schema 7. The upgrade resets old filters, their six switches and old named presets; selected dialect and unrelated settings remain. Use schema 7 CONFIG for a complete two-bank backup. Schema 6 remains a limited GO/settings interface. This is not a production rollout. See CC commands and recovery.

On This Page

Start As A Telnet User

You need a telnet client or a logging program with a DX cluster connection. For an example cluster, enter these connection settings:

Setting Value
Host / server dxc.n2wq.com
Port 8300
Login Your amateur radio callsign

If you have a command-line telnet client installed, connect with:

telnet dxc.n2wq.com 8300

Other clusters may use a different host or port; use the details supplied by that cluster's operator. You do not need to download or run GoCluster to use an existing cluster.

  1. Connect and enter your callsign when asked.
  2. Type HELP and press Enter to see the short help menu.
  3. Type SHOW DX 10 to see up to ten recent spots that pass your filters.
  4. Type SHOW FILTER to see your current filters, then RESUME when you are ready for live spots to continue.
  5. Optionally, set your location with SET GRID FN31PR, replacing FN31PR with your own 4 or 6 character Maidenhead grid locator. A grid locator is the short location code used in amateur radio.
  6. Type BYE when you want to disconnect.

Enter one command per line. In syntax such as SET GRID <grid>, replace the angle-bracketed word with your value; do not type the brackets. Square brackets in help mean an argument is optional. Example callsigns and grids below are illustrative; use your own where appropriate.

Reading pauses: SHOW FILTER and SHOW SETTINGS temporarily stop live spots so you can read the reply. The reply tells you about the pause. Type RESUME to continue immediately. Missed live spots are not replayed; use SHOW DX to look through recent history after your filters.

Read A Spot Line

This illustrative line uses the shipped 76-character layout. Your cluster's settings and available information may differ.

DX de W1ABC:     14074.00  K1XYZ       FT8 -12 dB             > FN31 V 1830Z
Part Meaning
W1ABC The reporting station, also called the spotter or DE station.
14074.00 Frequency in kilohertz (kHz): 14.074 MHz, on the 20m band.
K1XYZ The station being reported, also called the DX station.
FT8 -12 dB Operating mode and signal report, when available. SNR means signal-to-noise ratio.
> An optional path hint for your location; see path symbols.
FN31 The DX station's grid locator, when known.
V Confidence in the reported callsign; see confidence symbols.
1830Z Time in UTC (18:30), rather than your local time.

Comments can appear between the mode/report and the right-hand fields. A blank path symbol means there is not enough usable evidence to rate the path. Confidence describes support for the callsign; it does not promise that you will hear the station or make a contact.

Common Telnet Commands

What you want to do Command
Get help for a command HELP SHOW DX
View recent spots SHOW DX 10 (SHOW MYDX is the same command)
View recent spots for a station SHOW DX K1ABC 10
View recent space weather bulletins SHOW WWV or SHOW WCY
View retained space weather bulletins SHOW WWV FULL or SHOW WCY FULL
See your active filters SHOW FILTER
See detailed rule information (GO) SHOW FILTER FULL
See the frequency-slot selection (CC) SHOW/FILTER DXBM
See your grid, preferences, and session state SHOW SETTINGS
Pause live spots for 60 seconds PAUSE 60
Check or end a pause SHOW HOLD or RESUME
Inspect or change repeated-spot suppression SHOW DEDUPE or SET DEDUPE FAST
Show or hide RBN CW speed in ordinary text SET CWSPEED ON or SET CWSPEED OFF
Select session-only CC11 spot output SET/VE7CC; UNSET/VE7CC restores ordinary text
See countries reporting your own call WHOSPOTSME 20M
Request a propagation outlook SHOW PROP IT9 20m FT8 (set your own grid first)
Receive active solar summaries SET SOLAR 30 (every 30 minutes while active, on enabled nodes); SET SOLAR OFF to stop
Disconnect BYE

Native CC11 applies to live spots and DX history in either dialect. It starts off on every connection and is not saved. Native comments keep the canonical stored text, including any speed text, regardless of CWSPEED or diagnostics. See native output and compatibility limits.

To post a station you have heard, use DX <frequency_kHz> <callsign> [comment]. For example:

DX 7001.0 K1ABC CW heard well

Frequency is in kHz, so enter 7001.0 for 7.001 MHz. Replace the example with the station and frequency you actually heard. HELP DX explains the syntax.

Comments accept ASCII letters, digits, spaces, and / # @ - . , * ? _. Other punctuation and non-ASCII characters are rejected. The entire edited command must fit the node's byte limit (128 by default), excluding its line ending.

Filter Examples

Use numbered PASS RULE and REJECT RULE expressions to choose reports. Any matching REJECT wins. Otherwise, any matching PASS qualifies. With no PASS rules there is no personal PASS restriction; an empty set has no hidden base filters. Separate controls, such as SELF and TOXIC, still apply.

Slots 0 through 9 identify rules, not priorities. Adding another PASS broadens your selection rather than adding an AND condition. To require two conditions, put both in one expression, such as BAND=20m AND MODE=CW. NOT binds before AND, then OR; parentheses let you override that order.

New users receive an ordinary editable PASS rule in slot 0 containing the configured default modes and sources. Users leaving the old filter system receive the same starting rule while keeping their settings. Edit that rule when narrowing the default selection. SHOW FILTER RULE displays the canonical expressions that are evaluated. Readbacks temporarily pause live spots; type RESUME when ready.

A PASS rule without SOURCE allows both HUMAN and SKIMMER reports. Use AND SOURCE=HUMAN for human reports only, or AND SOURCE=SKIMMER for automated reports only. SOURCE follows ordinary AND/OR/NOT logic. Neither PASS nor REJECT adds an implicit source restriction.

The shipped starting rule now selects both sources. Existing saved rules with explicit SOURCE=HUMAN stay human-only, including previously generated defaults. Saved expressions and presets are not rewritten. Source-less saved PASS rules now also admit matching skimmer reports. Feed connections are unchanged.

Each recipe below is separate. Save a preset before using a recipe that begins with RESET FILTER: it clears your rules, including any NEARBY terms. Old category mutation commands are refused with guidance to HELP RULE.

Show Only 20m And 40m

RESET FILTER
PASS RULE 0 BAND=20m,40m
SHOW FILTER RULE

The comma list selects either band. Add AND MODE=CW to the same expression if both the band selection and CW are required.

Show Only CW

RESET FILTER
PASS RULE 0 MODE=CW
SHOW FILTER RULE

Use RESET FILTER RULE 0 to remove this rule. UNKNOWN is the known MODE token for reports whose decoded mode is blank.

Hide FT8 Reports

REJECT RULE 9 MODE=FT8
SHOW FILTER RULE

This veto applies even when a PASS rule matches. Remove it with RESET FILTER RULE 9; the remaining PASS rules still determine what qualifies. Choose an unused slot if slot 9 already contains a rule you want to keep.

Show Only Human Reports

RESET FILTER
PASS RULE 0 SOURCE=HUMAN
SHOW FILTER RULE

SKIMMER is the automated-source category. To select both sources explicitly, use PASS RULE 0 SOURCE=HUMAN,SKIMMER. Removing the last PASS also removes the PASS restriction entirely.

Choose Locations, Callsigns, Or Events

Each expression below can replace slot 0 with PASS RULE 0 <expression>. Combine required selections with AND in that same expression.

Goal Expression
Select DX continents DXCONT=EU,AF
Select DX countries/entities (DXCC) DXDXCC=291,1
Select registered US/Canadian states or provinces DXSTATE=CA,TX,ON,QC
Select callsign patterns DXCALL=K1*,W1AW
Select event families EVENT=POTA,SOTA
Select literal comment text COMMENT="CQ test"

DX refers to the spotted station; DE refers to the reporting station. DXCC fields accept positive numeric ADIF identifiers and exact canonical CTY labels, for example DXDXCC=K,VE or DXDXCC<>K. Labels need CTY and normalize to numeric codes in responses, readbacks and saved rules. They select whole entities, not callsign prefixes; numeric-only rules need no CTY. Call patterns support an exact name, a single leading or trailing wildcard, or a lone *.

EVENT is literal: EVENT=POTA,SOTA does not admit untagged spots. Add NONE to include untagged spots. State/province values are registered addresses, not proof of operating location. Unknown values fail comparisons, including <>; NOT flips that result. Use HELP RULE or the filter reference for the full field contract.

Focus On Nearby Reports

Set your actual grid, then replace rule 0 with the selection you want:

SET GRID FN31PR
PASS RULE 0 MODE=CW AND NEARBY
SHOW FILTER

NEARBY is true when either the DX station or the spotter shares your H3 cell. The cell is broader on 160m, 80m and 60m than on other supported bands; it is not a fixed distance radius. Combine it with ordinary conditions:

PASS RULE 0 MODE=CW AND (DXCONT=EU OR NEARBY)

This selects CW from Europe or with a nearby endpoint. Geography and other conditions keep their meaning. Other PASS slots can broaden selection, and a matching REJECT still vetoes it. There is no global NEARBY switch.

Missing proximity makes NEARBY false; NOT NEARBY consequently also accepts unknown proximity. It does not prove a station is distant. An unrelated OR branch can still qualify the spot. See NEARBY details.

Reset Your Filters

RESET FILTER empties all personal rules, including their NEARBY terms. It preserves GRID, settings and separate controls and does not reinstall new-user defaults. Use RESET FILTER RULE <slot> or RESET FILTER RULE ALL to clear selected rules. Save a preset first to retain the current setup.

Named Presets

Your preferences normally save automatically and return when you reconnect with the same full login callsign. N2WQ and N2WQ-1 have separate saved preferences. A numeric suffix such as -1 is called an SSID. For login, use one or two digits from 0 to 99. -01 and -1 have separate saved preferences. A longer or non-numeric SSID is rejected.

A preset saves your active GO or CC filters and shared settings. Type HELP PRESETS for save-and-switch examples.

Saving an existing name replaces that preset. Deleting it leaves your current settings unchanged. Loading restores the saved command style, its filters and shared settings. It also saves those settings for future logins with your current callsign and SSID. Your other style's filters stay unchanged.

Action Example
Save the current setup SAVE PRESET DAY
Choose another setup HELP FILTER EXAMPLES
Save that setup after changing filters SAVE PRESET NIGHT
List saved setups LIST PRESET
Switch to a saved setup LOAD PRESET DAY or LOAD PRESET NIGHT
Delete a saved setup DELETE PRESET NIGHT

Preset names are case-insensitive and display uppercase. Use 1-32 letters, digits, or hyphens, starting with a letter or digit.

Your numeric SSIDs share the preset library. Other connected sessions keep their settings until they load a preset themselves. (modified) means your preferences have changed from the saved or loaded snapshot. Temporary pauses and diagnostics do not affect that marker and are not saved in presets.

If a reply warns that saving failed or that temporary defaults are in use, do not assume your changes will survive reconnecting; contact the operator. See preset limits, persistence, and failure details.

Dedupe Policies

Dedupe hides repeated live reports so they do not overwhelm your feed.

Policy What to expect
FAST More repeats; the shortest configured suppression window.
MED A middle ground.
SLOW Fewer repeats; a longer window and broader grouping by reporting area.

Use SET DEDUPE FAST, SET DEDUPE MED, or SET DEDUPE SLOW, and check SHOW DEDUPE. The shipped default is SLOW; the operator controls the available policies and timing. If your chosen policy is disabled, the server selects an enabled one and tells you. NEARBY does not change your dedupe policy. Use SET DEDUPE FAST explicitly if you want more local repeats.

The operator can also evaluate frequency-change-aware suppression. It ships off; shadow counts differences while keeping the existing spot feed, and on can show reported frequency or skimmer-mode changes sooner. This can add repeats and does not prove a real QSY. The per-user FAST/MED/SLOW controls still apply. See operator settings.

See dedupe details.

Confidence Tags

These symbols describe support for the reported DX callsign:

Symbol Meaning
? Little supporting evidence.
S One current report with static or recent on-band support for the call.
P Corroborated, below the strongest support level.
V Strongly corroborated.
C The call was corrected and the corrected call passed validation.
B A suggested correction failed validation; the original call was kept.

Use PASS CONFIDENCE or REJECT CONFIDENCE to filter these values. While a call waits in the stabilizer, its ordinary letter keeps the strongest level reached for that unchanged call: ? < S < P < V. The percentage in DIAG CONF stays current and can fall or become unavailable. Filters see the retained letter. C and B remain separate correction outcomes. For calculation details, see spot confidence.

Path Reliability Tags

Path symbols are optional hints about radio conditions between your location and the DX station. Set your actual grid with SET GRID and choose your local receive-noise class with SET NOISE QUIET|RURAL|SUBURBAN|URBAN|INDUSTRIAL.

Symbol PATH filter value Meaning
> HIGH Favorable path.
= MEDIUM Workable path.
< LOW Weak or marginal path.
- UNLIKELY Poor path.
# CLOSED Fallback indicates closed conditions.
blank INSUFFICIENT Not enough usable evidence to rate the path.

The hints use recent reports and, when available, model fallbacks. They are not a guarantee of a contact. A blank is not a prediction of a closed path. Solar-weather overrides may display R for a radio blackout or G for a geomagnetic storm; these do not replace INSUFFICIENT.

PATH filters use class names, not symbols: for example, PASS PATH HIGH,MEDIUM. UNLIKELY rules also match CLOSED fallback results; a direct CLOSED rule can select that class specifically. SHOW PROP IT9 20m FT8 requests an hourly outlook from your grid. Omitted mode defaults to CW; forecast availability depends on the server, and UNLIKELY/CLOSED forecast rows are hidden.

See path display and the path calculation reference.

Troubleshooting

Symptom What to check
Live spots stopped after a command Run SHOW HOLD, then RESUME. Readbacks intentionally pause live spots.
No spots, or fewer than expected Run SHOW FILTER and SHOW SETTINGS, then RESUME. Check band, mode, source, location, and path/confidence restrictions.
A NEARBY condition never matches Check your saved grid and the full rule. Missing proximity is false; other OR branches may still pass.
Repeated reports are missing Check SHOW DEDUPE; try SET DEDUPE FAST if you want more repeats.
A spot has a blank path symbol Check your grid. Evidence or forecast support may be unavailable; blank means insufficient evidence.
Comments look like diagnostic codes Use SET DIAG OFF to restore normal comments.
Preferences differ after reconnecting Check the full login callsign, including the SSID, and any saving warnings.
Login is rejected Check that you entered your actual callsign. Contact the operator with the exact reply if it remains rejected.

SHOW DX 10 checks recent stored history after your filters; it does not prove that new reports are currently arriving. If filters and pauses do not explain the problem, contact the cluster operator with the commands and replies you saw.

Advanced Reference

The sections below provide optional detail. The linked package documents own the complete command, persistence, and protocol explanations.

Diagnostic Comments

SET DIAG replaces ordinary spot comments for your current session. Use SET DIAG SOURCE to identify the source, SET DIAG DEDUPE for repeat-suppression keys, SET DIAG CONF for calculated confidence, SET DIAG PATH for path evidence, or SET DIAG MODE for mode provenance. Restore comments with SET DIAG OFF. Long diagnostics can be clipped to fit the spot line.

See the operator command guide and path reference for interpretation.

Minimum SNR Filtering

SNR comparisons use an integer report whenever present, including human reports. To reject weak automated CW/RTTY reports while leaving human or missing reports unaffected by this rule, use an unused slot:

REJECT RULE 8 SOURCE=SKIMMER AND MODE=CW,RTTY AND SNR<10

Remove it with RESET FILTER RULE 8. This does not bypass other rules. See the SNR reference.

Toxic Comment Filtering

REJECT TOXIC hides human reports already classified as toxic; PASS TOXIC allows them. This optional feature is disabled by default. Reports that have not been classified, or whose classification is unavailable, still pass. See filter details.

History Searches

SHOW MYDX 3D2/R 10 searches a canonical DXCC entity; SHOW DX K1ABC 10 searches one normalized station identity. Counts default to 50 and accept 1-250. Your filters and archive retention apply. Pages select newest matches and display them chronologically. If a reply supplies SHOW DX NEXT H1..., enter the exact returned command on the same connection to continue. Reconnects and relevant preference changes require a fresh search. See history and continuation.

New DX calls display without trailing numeric SSIDs: K1ABC-2 becomes K1ABC. Your login identity keeps its suffix, but own-call features ignore numeric SSIDs. Use SHOW OWN to check the baseline call.

Output Examples

These representative examples show detailed filter and settings readbacks. Exact values depend on the active server configuration.

Expand filter, settings, own-call, and propagation examples

Confirm which baseline call is used for own-call features:

> SHOW OWN
Own call: N2WQ
Login call: N2WQ-7
SSID handling: numeric SSIDs are ignored for own-call features.

Inspect and change your duplicate-suppression policy:

> SHOW DEDUPE
Dedupe: SLOW (cqzone) (fast=on med=on slow=on)
> SET DEDUPE FAST
Dedupe policy set to FAST

Inspect your complete expressions with SHOW FILTER RULE. For example, its rule portion can show:

PASS RULE 0 MODE=CW AND (DXCONT=EU OR NEARBY)
REJECT RULE 9 COMMENT="QRT"

Every saved rule retains its Boolean structure. GO filter readbacks show the whole rule set. SHOW FILTER FULL adds the prepared program's counts and separate delivery controls. Human readbacks temporarily pause live spots. Use RESUME when ready.

SHOW SETTINGS separates your selections from the choices currently in use. The following example uses server path minimums of 21 for stations and 11 for beacons. Dedupe remains SLOW even when a rule contains NEARBY:

> SHOW SETTINGS
User          N2WQ-1
Preset        CONTEST (modified)

Dialect       GO
Grid          FN31PR
Noise         SUBURBAN
Dedupe        SLOW
Path samples  DEFAULT; stations 21, beacons 11
Solar         Every 30 minutes

Session only
Diagnostics   Off
Live spots    Paused for reading; at least 30s after delivery
              135 spots suppressed

Live spots paused during delivery and for at least 30s afterward.
Type RESUME when ready. Missed spots are not replayed.

The reading interval starts after the server finishes writing and flushing the response. Session status is captured during preparation, so it does not claim that the reading countdown has already started. Effective settings and path minimums come from the active server and session state.

For example, reconnect does not activate a saved personal minimum of 15 when the station minimum is 21. The beacon minimum remains 11:

Path samples  15 configured; effective stations 21, beacons 11
              Override inactive: not above station minimum 21

An active stricter personal minimum of 30 applies to both:

Path samples  30 (user minimum); stations 30, beacons 30
              Cluster minimums: stations 21, beacons 11

Login shows actual settings and numbered rules under "Default settings and filters" for new accounts or "Current settings and filters" for returning accounts. Upgraded users keep their settings and receive a short reset notice. Rules are never flattened into independent mode/band/source lists.

Human readbacks use at most 78 printable ASCII characters per line, followed by CRLF. Short rules are commands you can reuse:

PASS RULE 0 MODE=CW AND BAND=20M
PASS RULE 1 MODE=FT8 AND BAND=40M AND SOURCE=SKIMMER

Long values use exact quoted ASCII pieces joined by +. Decode and concatenate the pieces without adding spaces; display quotes and the + are not command syntax. Use schema 6 YAML for rules beyond the command-line limit. GO filter readbacks show the whole rule set. SHOW FILTER FULL adds preparation counts and separate-control detail. GET YAML FILTER SCHEMA 6 exposes exact saved rules, individual controls and canonical expressions.

See recent countries that have heard your baseline call:

> WHOSPOTSME 20M
WHOSPOTSME 20M (last 10m):
  EU:  G(4) DL(2) F(1)
  NA:  K(3) VE(1)

Ask for a point-to-point propagation outlook. When a single-band request is missing cache rows, it starts a VOACAP refresh and may wait briefly; all-band requests show cached rows while refreshing missing bands in the background. Omitted mode defaults to CW. Rows whose REL prediction is UNLIKELY or CLOSED are hidden:

> SHOW PROP IT9 20m FT8
PROP FN31 -> JM77 target=IT9 source=cty-derived mode=FT8 band=20m noise=SUBURBAN ssn=112 hours=24
UTC  EFF  RX  TX  REL
18Z  <    -   <   LOW

EFF, RX, and TX are mode-specific path glyphs. EFF is the merged effective path, RX is the target-to-you receive leg after your SET NOISE penalty, TX is the you-to-target transmit leg, and REL is the configured class for the merged path. If all cached rows are UNLIKELY or CLOSED, the command reports that there are no HIGH/MEDIUM/LOW rows in the current forecast window.

The default forecast lasts 24 hours from the worker's starting UTC hour. A valid forecast stays available while a replacement is prepared. Requested paths renew in the final hour; queue delays or failures can still leave a gap after expiry. ssn=mixed means displayed bands use different solar inputs; each band then shows its own SSN.

Long command responses also append a short read-pause footer:

Live spots paused for 30s after 14 output rows. Type RESUME to resume now.
Missed spots are not replayed.

PAUSE [seconds] lets you start the same pause manually. The duration defaults to 30 seconds and accepts whole seconds from 1 to 300, even when automatic read pause is disabled. Repeating PAUSE sets a fresh duration; automatic pauses can extend an active pause but cannot shorten it. Command replies and other control traffic continue, and missed live spots are not replayed.

Human SHOW FILTER, RULE/FULL readbacks and SHOW SETTINGS suppress spots from command acceptance through preparation, queueing and delivery. Their full reading interval starts after the server completes its write and flush; terminal rendering time is unknown. They use a positive configured pause duration, or 30 seconds when it is zero, and ignore the row threshold even when it is zero. A longer existing pause is preserved. A later valid, processed PAUSE or RESUME takes precedence over an earlier queued readback; another human readback starts a fresh hold. Size-error responses follow this same policy.

Client YAML Configuration

This protocol is for client software and advanced configuration tooling; ordinary telnet users can use the commands above.

Expand the YAML protocol and complete SETTINGS response example

Clients use GET YAML FILTER SCHEMA 6, GET YAML SETTINGS SCHEMA 6, GET YAML CONFIG SCHEMA 6 and GET YAML CAPABILITIES SCHEMA 6. The first two read one resource; CONFIG captures filters and settings together; CAPABILITIES describes the schema, choices and limits. CAPABILITIES is read-only. Optional ID <id> accepts 1-32 ASCII letters, digits or hyphens and preserves case. Without an ID, GET assigns one.

This complete SETTINGS response is a separate example with no active pause:

---
schema_version: 6
request_id: noise-Ab1
resource: SETTINGS
revision: 7faea7039a0b47a1bb8e462157b4c621-3
configuration:
  dialect: go
  grid: FN42
  noise_class: URBAN
  dedupe_policy: SLOW
  path_min_observation_count: 0
  solar_summary_minutes: 30
status:
  configured:
    dialect: go
    grid: FN42
    noise_class: URBAN
    dedupe_policy: SLOW
    path_min_observation_count: 0
    solar_summary_minutes: 30
  effective:
    dialect: go
    grid: FN42
    grid_derived: false
    noise_class: URBAN
    dedupe_policy: SLOW
    path_min_observation_count: 20
    solar_summary_minutes: 30
  session:
    callsign: W1ABC-1
    diagnostic_comments: "OFF"
    pause_active: false
    pause_pending_delivery: false
    pause_remaining_seconds: 0
    suppressed_spots: 0
    temporary_defaults: false
  server:
    default_dialect: go
    default_dedupe_policy: SLOW
    default_noise_class: QUIET
    path_min_observation_count: 20
    auto_read_pause_min_rows: 10
    auto_read_pause_seconds: 30
  preset:
    associated: true
    name: CONTEST
    modified: true
  rules:
    configured_count: 0
    program: {nodes: 0, atoms: 0, values: 0}
    entries: []
...

Send GET YAML SETTINGS SCHEMA 6 ID noise-Ab1 to request that response shape. Only configuration is writable. Preserve explicit false, zero, empty strings, empty collections and DEFAULT selections when editing it; the status sections, resource name and GET envelope are read-only. Use the returned revision as if_revision in a new write envelope.

PUT YAML FILTER|SETTINGS|CONFIG replaces a complete resource and requires every writable field. PATCH YAML FILTER|SETTINGS|CONFIG changes supplied fields while retaining omissions. Supplied maps and lists replace their whole collections. For example, change only the noise selection:

PATCH YAML SETTINGS
---
schema_version: 6
request_id: noise-Ab2
if_revision: 7faea7039a0b47a1bb8e462157b4c621-3
configuration:
  noise_class: RURAL
...

The revision shown is illustrative: use the value from your own GET. GET again after reconnect or a revision conflict. Validation or persistence failure leaves both live and saved configuration unchanged; unavailable choices are rejected. Even an unchanged PUT saves the configuration before reporting success, repairing a failed earlier human autosave without resetting scheduling or session controls. Machine writes retain the preset reference and may change (modified). VALIDATE YAML CONFIG checks a complete proposal without applying or saving it.

Every new human or YAML readback is limited to 65,536 final response bytes, including CRLF, framing and human footers. Responses are complete or return an explicit error. New machine proposals must also fit a complete CONFIG response, including reserved response metadata. Uploads allow 65,536 body bytes, excluding markers but counting actual LF/CRLF bytes, with a 30-second deadline from header acceptance. Oversized, expired, incomplete or unreliable uploads, including malformed upload headers, close the connection. A fully received invalid document gets a framed YAML error and keeps the connection open.

All machine success and error responses leave pause state unchanged and have no human pause footer. Send one plain YAML document: aliases, anchors, merge keys, custom tags, nulls and additional documents are rejected. Ordinary command headers retain the configured line limit (128 bytes in the shipped config); the framed body uses its separate limit. See the client protocol details.

HELP

Use HELP for a short menu, call confidence tags and configured path symbols. Use HELP FILTERS to inspect filters and learn the few essential rules. Use HELP FILTER EXAMPLES for complete GO or CC setups, with replacement warnings before the commands. Use HELP PRESETS to save a setup, create another and switch between them. Use HELP COMMANDS for the complete command and help-topic index.

Expand the default GO help screen

The section below mirrors the default go dialect HELP output from commands/processor.go using the shipped config in data/config.

Getting help
  HELP COMMANDS    List all commands.
  HELP <command>   Get help with one command.
  HELP SYMBOLS     Explain symbols on spot lines.
  HELP TROUBLE     Get help when something isn't working.

Showing archive spots
  SHOW DX 10       Show up to 10 recent spots that match your filters.
  HELP SHOW DX     Learn to search by call, band, mode, or comment.

Managing filters
  SHOW FILTER      See your active filters.
  HELP FILTERS     Learn how to change which spots you receive.
  SHOW SETTINGS    See your settings.

Managing presets
  LIST PRESET      List your saved presets.
  SAVE PRESET DAY  Save your current setup as DAY.
  LOAD PRESET DAY  Switch to your saved DAY setup.
  HELP PRESETS     Learn how to manage saved setups.

Running A Node

Telnet users connecting to an existing cluster can skip this section. To operate your own node, download gocluster-windows-amd64.zip from GitHub Releases, extract it, and follow the packaged ready_to_run/README.md. GitHub's automatic source archives are not ready-to-run packages. See download instructions.

For installation and service operation, use the Operator Guide. The published ready-to-run package is Windows amd64. Linux can be built from source; Windows VOACAP execution is unavailable on non-Windows builds.

Configuring A Real Node

Copy the complete public example directory data/config to a private directory such as ignored data/config.local. Set DXC_CONFIG_PATH to that directory. Replace the placeholder node and ingest login callsigns before connecting a real node, and configure any upstreams or peers you enable. Keep passwords, tokens, private callsigns, and endpoints out of committed example config.

Read configuration ownership and loader rules before editing YAML. Normal setup does not require retuning pipeline or path-model calibration. Follow the node configuration steps.

Build And Service Notes

GoCluster builds from the repository root with Go 1.27.1+. Follow the development and launcher instructions and environment guide. Use the release preparation guide for packaging and publishing, and the Operator Guide for Windows startup or unattended Linux service operation.

Build identity uses the UTC date as YYMMDD; release builds also carry a separate tag such as 261006r9abc (date plus the last four commit-hash characters). Same-day builds can share a product version. Use SHOW BUILD or --version to identify the binary and available release/toolchain metadata.

Run the executable with --help (-h or -help also works) to see usage and configuration-directory guidance. Help and version return before configuration loading or server startup. Start the configured node by running with no arguments. Unexpected options or positional arguments print usage and exit 2. A --version, -version or version token anywhere takes precedence over all other arguments, preserving the existing version behavior.

Operator Logs

Use the logs and health guide and logging configuration reference for file locations, retention, and enabled event logs. Path diagnostics use the propagation log. The cluster executable writes peer diagnostics using the same asynchronous logging as the other categories; see peer operations. Logs are disposable and records can be lost without a warning.

Repo Layout

The repo root now follows a simple ownership rule:

  • main.go is the live binary entrypoint only.
  • internal/cluster contains the live runtime implementation and cluster-local helpers.
  • cmd/ contains standalone tools and offline runners.
  • scripts/ contains build, release, profiling, validation, and developer helper scripts; use scripts/README.md before running or changing them.
  • data/ contains more than config: public example YAML in data/config/, private ignored config in data/config.local/, reference inputs such as CTY, FCC, ISED, H3, grids, beacons, and reputation/IPinfo data, plus runtime/local state such as users, logs, reports, diagnostics, peer topology, RBN data, SCP data, VOACAP runtime state, and skew/correction data. Treat committed example/reference data differently from ignored operator-local state.
  • Domain packages such as spot, peer, telnet, config, and pathreliability remain reusable subsystems with their own tests and package-local docs.

Historical analysis notes and protocol reference material live under docs/archive/analysis and docs/reference rather than competing with the live binary at the repo root.

Deeper Docs

Implementation-heavy material now lives next to the relevant code:

Additional operator references:

About

GoCluster is a high-performance DX cluster for amateur. Developed by a contester for contesters. Combines RBN, PSKReporter & peer feeds with call correction, path reliability, and Boolean filters.

Topics

Resources

Stars

10 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages