# 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 is speaking: 2.0 or 3.0.
_Avoid_: TYPE, a config field the operator sets

**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, 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 is a modal over the station UI, not a separate OS window.
_Avoid_: settings window, preferences dialog, a raw JSON editor as the primary UI