renfield

Danger

This will be the Not1MM contest data aggregation server. It's currently not feature complete.

Recent Changes

• [2026-08-29] @mbridak Refactor contest plugins
  • @mbridak Fix: mults in spdx, linter stuff.
  • @mbridak Add Dutch PACC plugin.
  • @mbridak fixed library imports in cqp.
  • @mbridak added more detail to plugin error message.
• [2026-08-28] @mbridak corrected DB access and linter stuff.
  • @mbridak mostly linter fixes.
  • @mbridak improved SQL query
  • @mbridak Refactor: remove unused functions and logging, update contest query parameters
• [2026-08-27] @mbridak add CQP
• [2026-07-20] @mbridak Fix: formatting issues in Cabrillo output and add missing assertions
  • @mbridak Removed unused function.
  • @mbridak Refactor IARU HF plugin: remove unused points function, improve score calcula...
• [2026-06-13] @mbridak Add EUDX
  • @mbridak add asserts to remove warnings.
• [2026-05-28] Fix crash when no plugin found.
• [2026-03-11] Adding RSGB IOTA
• [2026-03-03] Merge pull request #4 from ki4mcw/rover-logic
• [2026-02-26] Merge pull request #3 from ki4mcw/QSO-Party-1.1
• [2026-02-25] Merge pull request #2 from ki4mcw/qso_party_1st_draft
• [2025-12-21] Increase network socket timeout to 0.5 seconds and update contest request documentation
• [2025-12-21] changed multicast from 224.1.1.1 to 239.1.1.1
• [2025-12-16] Add score widget.
• [2025-10-5] Add Dupe checking.
• [2025.9.26] Add support to get serial numbers from the server.
• [2025.9.25] Got it generating Cabrillo files.
  • Group chat
  • Current User/Band/Mode
  • QSO by band/mode/points

The Idea

Renfield is an amateur radio contest contact aggregation server for Not1MM. It uses Textual for rendering the interface. This provides the user with either a CLI or a web interface depending on how it is launched.

The client(s) Not1MM and the server Renfield talk to each other over a UDP Multicast network connection. There is no file sharing or network file access. The Not1MM clients and Renfield each maintain their own database. As contacts are made they are stored in Not1MM's local database. That record is marked 'Dirty' and a UDP message is sent out. Once Renfield gets the message and saves it's copy, Renfield sends a response message to confirm. The Not1MM client gets the confirmation and clears the 'Dirty' flag on the record. Not1MM keeps track of the messages it has sent out. If it doesn't get a reply either because Renfield didn't get it or Not1MM didn't get the confirmation message, Not1MM will just retry every 30 seconds until it does. Each contact has a UUID v4 tag to prevent any duplicate records.

If Renfield should crash and burn, or the PC/device it is running on should catch fire. You can spin up another instance of Renfield, then have the Not1MM clients mark all their contacts as dirty, and they will re-stream all their contacts to the new server. Eventually I'll make that reciprocal. Where if a Not1MM client were to fail, it will be able to ask Renfield to send all it's contacts back.

Things that need doing

• Make a stupid logo.
• Discover which contest is being run.
• Handle QSO CRUD operations.
• Show Points, Mults and Score.
• Show some basic band/qso/point statistics.
• Chat functions (handled by the clients)
• Manage giving out serial numbers.
• Generate a Cabrillo file.
• Indicate Dupes when queried.
• Reverse feed QSO's back to a client if requested.

Installation

You can install\update renfield easily with uv:

uv tool install renfield@latest

Running renfield

CLI interface

You can run renfield and have it's interface displayed directly in the terminal with:

# renfield

Run as a web server

You can run renfield as a web server with:

# textual serve renfield

You'll see this message:

You or others on your network can connect to the web interface on port 8000

Run from the source tree

textual serve __main__.py

Networking

Communication between the clients and the server happens on UDP multicast port 2239 by default. Depending on your linux distribution you may need open that port in your firewall on each machine manually. I've retired from the IT field, so I'll leave that as an exercise for you.

Direct commands

Interacting with the server via it's CLI or web interface is limited.

• 'q' Quits the program.
• 'R' Resets/Wipes the database.
• 'Z' Zero out the SN server.
• 'c' Generates a Cabrillo file for whatever contest is active.