WSJTX(1)

🦋 WSJTX(1) — the WSJT-X Manual, bestie edition 🦋

okay so this is the page for message_aggregator, which lives inside the WSJT-X Manual (that's the manual name if you were wondering, and yes this whole page is WSJTX(1), we're doing this 💖).

---

✨ NAME ✨

message_aggregator — a reference example UDP server 🫶

---

✨ SYNOPSIS ✨

message_aggregator

that's it. no flags. no args. she just runs. 👑

---

✨ DESCRIPTION ✨

okay so real talk: message_aggregator does not serve any useful purpose other than to demonstrate the UDP message features of WSJT-X. 💀 like, that's literally her whole job and she's thriving. she's a small GUI application that talks to any running WSJT-X instances. vibe check: passed.

---

🌸 for the devs 🌸

if you're a developer writing add-on applications, the source code of message_aggregator in the WSJT-X code repository is genuinely gonna be useful to you, no cap. the files you want are:

• NetworkMessage.hpp
• MessageServer.hpp
• MessageClient.hpp

plus their associated implementations, and the application source MessageAggregator.cpp — those together should cover all the required areas. 👑

all these files can be found at:

https://sourceforge.net/p/wsjt/wsjt/HEAD/tree/branches/wsjtx/

---

🎀 multi-cast server energy 🎀

message_aggregator may also be used as a multi-cast UDP server, which is lowkey iconic because it lets multiple instances of message_aggregator be run concurrently. 💅

to do this, simply use a suitable multi-cast group address in message_aggregator and in WSJT-X in the "Settings→Reporting→UDP Server" pane — e.g. 239.255.0.1 or ff03::1 for a local scope group. ✨

⚠️ note that on some systems it may be necessary to add a static multi-cast route to the routing table before multi-cast traffic can be routed to sockets on the same host as the sender. so if it's not working, it's giving routing table, and that's on the route, not on you.

---

💜 AUTHOR 💜

Bill Somerville, G4WJS. 👑🫶

---

🌈 COPYING 🌈

message_aggregator is Copyright © 2015 by William Somerville, G4WJS, with contributions from additional authors. message_aggregator is Open Source software, licensed under the GNU General Public License (GPLv3). periodt. 💖

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. 🫡 (yes that's the dramatic part, please respect it)

---

alright bestie, that's the whole page — this was AsciiDoc 3.0.2-devel, dated 06/22/2026, WSJTX(1), and you absolutely ate it. bye 💅✨🎀