funknetz/CONTEXT.md

funknetz

A headset station for the FM-Funknetz. It joins one reflector talk group and lets the operator listen and speak.

Language

FM-Funknetz: The German amateur network of linked analog FM stations that this application joins. Avoid: using that name for this application

Station: This application’s presence on a reflector, named by a callsign. It has no radio of its own. Avoid: node, client, channel, hotspot

Reflector: The conference that forwards audio among stations that have joined the same talk group. One talk group has at most one talker. Avoid: server, bridge

Talk group: A numbered audio room on the reflector. The station is joined to one talk group at a time; changing it in the config starts a new session after Save. Avoid: channel, room

Talker: The station currently sending audio on a talk group. Avoid: transmitter

Callsign: The uppercase amateur call sign that names this station on the reflector. Avoid: a lowercase spelling, username, node id

Auth key: The shared secret the network issues for this station’s callsign. It proves the station on protocol 2.0, and on protocol 3.0 when the reflector has not signed a certificate yet. Avoid: a password sent in the clear, the certificate

Certificate: An X.509 certificate whose common name is this station’s callsign. It proves the station on protocol 3.0. Avoid: auth key, a PEM pasted into the config file

Certificate directory: The directory the station config names. It holds the CA bundle and this station’s key and certificate. Avoid: PEM text inside the config file

CA bundle: The reflector’s certificate authority, kept in the certificate directory. Protocol 3.0 uses it to check the reflector. Avoid: the station certificate

Protocol: The reflector session this station speaks: 2.0 or 3.0. The config chooses v2 or v3; v2 is the default. Avoid: TYPE

Push-to-talk: The operator holding the control that makes this station the talker. Releasing it returns the station to listening. Avoid: voice-operated transmit, a mute toggle

Config: The JSON file that names how this station joins a reflector (host, port, callsign, auth key, talk group, protocol, certificate directory, logging). Default path ~/.funknetz.json; -c may select another file. Avoid: settings file, preferences, treating PEMs as config fields

Config window: The in-app form that edits the config. It fills the station window, which is resized to the form. Avoid: a separate OS window, settings window, preferences dialog, a raw JSON editor as the primary UI