OpenShack Manual CW Link
✅ Six setups, one picker
The Host is at the radio; the Client is with the operator. Use either role on Windows or set up two Boxes to run on their own. Direct or through our relay, over IPv4 or IPv6 — all from the same window.
ℹ️ What you need & where to find it
A DTM Remote license is required for CW Link and for setting up the Host Box at the radio. Setting up the Client Box on the operator side needs no license: without a Remote license the same setup is offered under Settings → Network Box — that is also all you need to use your Box with the free web trainers. Direct connections are free of charge apart from that. If you use the relay, an active Remote Host Connect (RHC) yearly subscription is required at the radio side as well. Open CW Link from the main menu under Operate → CW Link. CW Link replaces the older standalone Flex Keyer window — the same local-Flex keying now lives here as the Flex Keyer mode.
CW Link setup choices for the Client at the operator side, the Host at the radio side, and standalone Boxes
Start with the computer or Box in front of you

What CW Link Does

CW Link connects two stations and relays CW keying and PTT between them — nothing else. Audio and rig control (CAT) are separate; keep using whatever you already use for those (the Remote Station, a direct link, SmartLink, and so on). CW Link is built for the keying path and does that one job very well.

Every setup has two roles: the Host is at the radio and keys the transmitter; the Client is with the operator and sends CW and PTT. You configure the end in front of you, then tell a Windows Client which Host it should use: a standalone Host Box, Windows + Box, or Windows + FlexRadio. All choices share one compatible link protocol.

Choosing Your Setup

Under What do you want to set up?, choose Operator computer, Computer at the radio, or Standalone OpenShack Box. The next line asks what that computer or Box will do.

👍 The preferred path: a PC with the box on USB at each end
Wherever you can, run a Windows PC with the OpenShack Box connected by USB (serial) at that end. That gives you the box's instant local sidetone at the operator, the smart adaptive buffer at the radio, and the full picker and status readout in OpenShack. The other modes are there for when that isn't possible (no box, or no PC at all).
📻

Network Host → USB Box

A Windows Host at the radio drives an OpenShack Box over USB. A Client connects from the operator side.

Host PC + USB Box →
🎛️

Network Host → FlexRadio

A Windows Host at the radio keys a FlexRadio over the local network. A remote Client connects.

Host PC + FlexRadio →
🔌

USB Box → FlexRadio

Your local box keys a networked FlexRadio. No remote link — just you and the radio.

Local Box + FlexRadio →
📡

Network Host → Elecraft K4

A Windows Host at the radio keys an Elecraft K4 through the radio's network remote. A remote Client connects.

Host PC + Elecraft K4 →
🔌

USB Box → Elecraft K4

Your local box keys a networked Elecraft K4. No remote link — just you and the radio.

Local Box + Elecraft K4 →
🕹️

Client with Box

The Client PC takes paddle CW — and, if you like, your logger's CW — from a local Box and sends it to the selected Host.

Client with USB Box →
⌨️

Client without Box

No Box — the logger (N1MM+, Win-Test…) keys the software keyer and the Client PC sends it to the Host.

Client with logger →
🔗

Standalone Box: Host or Client

Configure an attached Box as a standalone Host or Client — with another Box or CW Link on Windows at the other end.

Standalone Host / Client setup →
ℹ️ The radio-station choices are now visible
With Operator computer selected, use At the radio, CW goes to: to choose Standalone OpenShack Box, Windows computer + OpenShack Box, Windows computer + FlexRadio, or Windows computer + Elecraft K4. The Flex choice opens the remote SmartSDR-client picker (the K4 needs no picker — it is a single radio). The standalone choice shows Configure station Box… for the one-time station setup.

The Modes in Detail

Network Host → USB Box: the Box keys the radio

Windows station setup receives CW and replays it through a local OpenShack Box

This is the Host at the radio: an OpenShack Box is wired to the rig's key line. A remote CW Link Client connects, and the Box replays its keying and PTT onto the radio. The box's own buffer starts at the floor you set and then adjusts itself to the connection — tightening on a clean link, loosening on a rough one — so the far operator's rhythm comes through faithfully. Connect the box in Hardware Settings first and keep its key output wired to the rig.

Network Host → FlexRadio

Windows station setup receives CW and keys FlexRadio over the SmartSDR API

Same idea, but the radio is a FlexRadio and there is no box at your end — OpenShack keys the Flex directly through the SmartSDR API. A remote client dials in (a box, a box + PC, or a logger), and their keying goes on the air. One SmartSDR or Maestro station must be set up to transmit, and the keyed slice should be in a CW mode (CWL/CWU).

ℹ️ Choosing the SmartSDR station
On the FlexRadio tab, open the SmartSDR station list — it queries the radio and shows the available operator positions before you start. Leave it on (Auto) to follow whichever station owns the CW transmit slice, or pick one by name if you run several (multiFlex). Your choice is remembered.

USB Box → FlexRadio (local box keys a networked Flex)

Flex Keyer flow: local OpenShack Box keys a FlexRadio over the LAN or VPN, no remote link

This is the classic Flex Keyer from earlier versions, now a CW Link mode. Your local OpenShack Box keys a FlexRadio over your own network (LAN or VPN) — there is no remote link and no shared password, because both the box and the radio are yours. Your paddle, straight key, or memories key the radio, while the box's own sidetone stays your zero-latency monitor. A footswitch or the on-screen PTT button puts the radio on the air for voice. Two extra buttons open a live decoder — to read back your own sending — and the memory keyer.

A logger can key here too: choose the OpenShack Winkey port on the Keying source tab and N1MM+, Win-Test and the like send through your box, exactly as described for the Client with Box.

ℹ️ No VPN to the FlexRadio network?
That is not a problem. Run OpenShack on a Windows PC at the FlexRadio site and use the FlexRadio Host with CW-Remote. The Host PC then talks to the FlexRadio locally, so the Client does not need VPN access to the radio itself.

Network Host → Elecraft K4

Windows station setup receives CW and keys an Elecraft K4 through its network remote

The FlexRadio host's twin for the Elecraft K4. OpenShack at the radio receives the remote operator's keying and passes it to the K4 through the radio's own network remote connection — no keying cable and no box at the station. On the K4, enable remote connections and set a remote password; then enter the radio's address, its remote port (normally 9205) and that password on the Elecraft K4 tab. Unlike the FlexRadio there is nothing to pick: the K4 is a single radio, so the remote Client needs no special setting.

⚠️ Keep the K4's remote port off the open internet
The K4's standard remote connection is not encrypted. Use it on your own network or through a VPN, and let CW Link's Direct or Relay link carry the CW across the internet — never forward the K4's port to the public internet.
ℹ️ First release
Elecraft K4 support is new and still being confirmed with real K4 hardware. If keying or the waterfall does not behave as described here, please tell us what you see.

USB Box → Elecraft K4 (local box keys a networked K4)

K4 Keyer flow: local OpenShack Box keys an Elecraft K4 over the LAN or VPN, no remote link

Your local OpenShack Box keys an Elecraft K4 over your own network (LAN or VPN) — there is no remote link and no link password, because both the box and the radio are yours. Your paddle, straight key, or memories key the radio while the box's own sidetone stays your zero-latency monitor. With Use footswitch for voice PTT ticked, the footswitch puts the K4 on the air for voice. Enter the K4's address, remote port and remote password on the Elecraft K4 tab.

A logger can key here too: choose the OpenShack Winkey port on the Keying source tab and N1MM+, Win-Test and the like send through your box, exactly as described for the Client with Box.

Client with Box: OpenShack Box connected by USB

Operator OpenShack Box and Windows PC send CW to the selected station endpoint

You are the operator, wherever you are, with an OpenShack Box on USB. Your paddle, straight key, and F-key memories are the keying source, and the box gives you an instant local sidetone with no network delay at all — so your sending feels exactly as it does at home, no matter how far away the radio is. At the station, use OpenShack software with a Box or a Standalone Box. This PC only carries the link. Connect the box in Hardware Settings first.

Want to key from your logger as well? Choose the OpenShack Winkey port on the Keying source tab. OpenShack then also opens that virtual COM port as a WinKeyer for N1MM+, Win-Test and the like, and passes the logger's text to your box, which keys it exactly like your paddle — with the box's own sidetone. If OpenShack Setup installed com0com, the port is already chosen and the tab names the port to select in the logger. Leave it at (none) if you only key by hand.

ℹ️ Windows Client + USB Box → standalone Host Box
Choose Standalone OpenShack Box under At the radio, CW goes to:. Before starting the operator link, click Configure station Box…, connect the station Box by USB, and choose At the radio. Use the copied connection and link password, then click Save to Box. Return to Operator computer; your operator settings are retained.

Client without Box: No Box – Winkey Emulator only (virtual COM)

Logger sends CW through the Winkey Emulator and Windows PC to the selected station endpoint

No box at hand? Your logging program (N1MM+, Win-Test, and the like) keys a software keyer built into OpenShack on a virtual COM port, and this PC carries it to the radio. Open the Keying source tab. If OpenShack Setup installed com0com, OpenShack selects its port automatically and shows the exact port to choose in your logger. Otherwise, select the OpenShack Winkey port manually and configure its matching port in your logger. A local PC sidetone gives you a monitor as you send.

ℹ️ Sending F-keys, not a paddle
The logger route is best for contest-style sending (call, exchange, F-keys). For paddle work with instant feel, use OpenShack Box connected by USB — the box's hardware sidetone can't be beaten for timing.

Standalone Box: Host or Client

Standalone Host Box at the radio accepts CW and PTT from a Client Box or Windows Client

Connect the Box you want to set up. Choose the Client role (At the remote operator) or the Host role (At the radio). The Client Box sends CW and PTT over the network. The Host Box waits for that connection and keys CW and PTT at the radio. On the Standalone Box tab, enter the connection, station address when needed, link password, and timing buffer. Then click Save to Box. A WiFi indicator next to the buttons shows whether the Box is on WiFi — the network link can only start when it is. If it shows a warning, set up WiFi in Hardware Settings first. The other end may be another standalone Box or CW Link on Windows. Two standalone Boxes are the classic Box-2-Box arrangement with no PC running in the keying path.

⚠️ Prefer USB serial when a Windows PC is available
Box-2-Box runs over the boxes' WiFi connection. WiFi is convenient, but it is not as predictable as a wired USB-serial connection. If you have a Windows PC on either side, the preferred method is to keep that box wired by USB and use CW Link instead.
ℹ️ Full Box-2-Box guide
Box-2-Box has its own detailed walk-through — roles, the settings reference, Morse status announcements and hardware escapes. See Box-2-Box mode. The browser-based WebConfig can set the same options up without OpenShack at all.
📱 A standalone Client Box also works with WebRemote
On a phone, tablet, iPad or Chromebook, the Box can stay wireless and connect to the station independently while WebRemote supplies the station screen, audio and controls. See Box with WebRemote for the complete mobile workflow, the Direct/Relay choice and the exact RHC rule.

Choosing a Connection Mode

CW Link offers a mode for networks you manage yourself and a managed mode for restricted or mobile networks. Choose the mode that matches the environment shown on the Link tab.

Local or private networks

CW Link between operator and radio site on a private network

Use Direct on the same LAN, across a VPN, or where the radio-site host is intentionally reachable. The host lists the addresses you can use on the Link tab.

Restricted or mobile networks

CW Link using professionally operated infrastructure for connectivity

Use Relay where inbound router changes are unavailable or unwanted. Professionally operated infrastructure provides the connection path; both stations only need normal outbound internet access.

ℹ️ Relay needs an active RHC subscription
Direct connections are free of charge apart from the licenses described at the top of this page. If you use the relay, an active Remote Host Connect (RHC) yearly subscription is required at the radio (host) side in addition; the operator (client) side never needs RHC.
🧭 Recommended order
  1. Same network (LAN): use Direct with the host's local address. Nothing to set up.
  2. Private network or VPN: use Direct with the address provided by that network.
  3. Restricted or mobile internet: use Relay when you cannot provide inbound reachability at the radio site.

Ports, IPv4 and IPv6

CW Link uses one port for both TCP and UDP, 7373 by default. Both ends must use the same number; leave it at 7373 unless it clashes with something else. The host lists its reachable addresses on the Link tab, ready to copy.

  • Local network (LAN): use the host's LAN address as-is. No router or firewall changes.
  • IPv4 over the internet: forward TCP + UDP port 7373 on the host's router to the host PC, then hand out your public IP or DynDNS name. See Port Forwarding for the step-by-step.
  • IPv6 over the internet: give the operator the host's IPv6 address in brackets, e.g. [2003:e5:2711:9a10::7]:7373. There's usually no forwarding to do — just allow TCP + UDP 7373 through the firewall. See IPv6 and Stable IPv6 Address.
⚠️ Windows will ask about the firewall
The first time a host starts, Windows pops up a firewall prompt — allow it, or the operator won't be able to reach you in Direct mode.

Connection Quality

CW Link preserves the timing of your keying while adapting playback to normal variation in network delivery. The defaults are suitable for most connections. On an unstable link, choose a more robust buffer profile or raise the buffer floor; on a very stable link, a lower setting can feel more immediate.

What the jitter buffer protects

Jitter means that network packets do not all take the same time to arrive. The radio-side Box does not use those uneven arrival times as CW timing. Instead, it waits for the configured JB delay and then reproduces the key-down and key-up durations sent by the operator-side Box. Normal variation that stays inside this cushion therefore does not turn a clean dit or dah into a distorted one.

A rare delay spike can become a pause instead of bad CW
If one packet is later than the configured jitter buffer, the Box can hold playback back far enough to rescue the late element. The total playout delay is capped at about 2 seconds, so the additional rescue headroom is approximately 2000 ms minus the current JB value. With a 500 ms jitter buffer, for example, an occasional spike of roughly another 1.5 seconds can still produce complete CW elements at the radio. The trade-off is an audible pause before the signal continues; the dit or dah itself is not shortened or stretched.

This is protection for occasional transport spikes, not a substitute for a working connection. Repeated stalls or a delay beyond the remaining headroom can eventually skip elements. In that case, select a more robust profile, raise the buffer floor, and check the network path.

ℹ️ Start with the defaults
Leave the advanced transport controls unchanged unless troubleshooting or support specifically requires an adjustment. For Box modes, use Normal first, Robust (poor network) for an unstable link, and Fast (good network) only on a consistently good network.
After first setup: listen to the RF signal
It is strongly recommended to monitor your own transmitted signal with another receiver, for example a nearby receiver or WebSDR. Do this after the first setup and after major network changes. If the CW sounds choppy, characters are clipped, or dots are missing, adjust the network and buffer settings: raise the buffer floor for CW Link, raise Minimum (ms) for a standalone Box, or choose a more robust buffer profile and test again.

Link Password

Enter the same Link password at both ends. It must be at least 10 characters long. The local-only Flex Keyer mode needs no password because it does not create a remote link.

The Status Tab

CW Link status tab showing round-trip time, buffer, edges and connection path

Once a link is running, the Status tab shows how the connection is performing:

The tab collects measurements and state from the components that are connected in the selected mode. Depending on the setup, those components can be Windows applications (the CW Link instances, the software keyer, or the Flex/API path) or OpenShack Boxes connected by USB or WiFi.

  • Round trip — how long a signal takes to reach the other end and come back. Lower is better.
  • Timing buffer — the buffer delay in use right now, in milliseconds.
  • Keying events — a running count of keying changes carried over the link, a rough measure of activity.
  • Network path — whether the link is using UDP or TCP.

Update status reads the latest numbers from both ends; Reset counters clears the counters so you can watch a fresh measurement window.

Box Diagnostics (Windows + Box at either end)

When a Box is part of the link, the status log can include additional diagnostic counters. These are primarily intended for support. If keying quality is poor, click Reset counters, key normally for a minute, click Update status, and include the resulting status text in your support request.

⚠️ If monitored CW is clipped or uneven
First rule out congested WiFi, then choose a more robust buffer profile or raise Minimum (ms). Test again while monitoring the actual RF signal. Support can interpret the detailed counters if the problem remains.

Sidetone — Where You Hear Yourself

A common surprise: with a remote link there are two separate places a sidetone can come from, and they're unrelated.

  • At the operator (your) end — the OpenShack Box's own sidetone beeps the instant you key, with zero network delay. This is the sidetone to send by, and it's why paddle work over a remote link still feels natural. (In No Box – Winkey Emulator only it's the software keyer's PC sidetone instead.)
  • At the radio (host) end — the rig makes its own sidetone when it transmits, depending on the radio model and its monitor settings.
⚠️ Delayed radio monitor audio at the client
If the radio's own monitor audio comes back through your remote receive audio — for example CW sidetone or monitored SSB voice — it will arrive delayed and can be distracting while you operate. If it disturbs you, turn down or disable the radio's Monitor/MON function and rely on the local OpenShack Box or PC sidetone at the operator end.

Start into CW Link (Advanced Tab)

Normally you start OpenShack from its usual icon and open CW Link from the dashboard. If you run a fixed setup — an always-on station or a permanent operator console — you can instead create shortcuts that open CW Link and start the link automatically, reusing the connection, link password and settings from the last time you used it.

Open CW Link → Advanced. Under Automatic start you will find two checkboxes — tick the ones you want, untick to remove them again:

  • Create a desktop shortcut — puts a OpenShack (CW Link) icon on the desktop for a one-click start straight into a running link.
  • Start CW Link when I sign in to Windows — opens CW Link and starts the link after you sign in.
CW Link Advanced tab with the desktop shortcut and Windows autostart checkboxes
Advanced tab — the shortcuts for starting directly into CW Link (desktop and auto-start with Windows).

Set the connection, link password and the rest once; these shortcuts then reuse them every time. Hardware detection still runs first, so the Box is ready before the link starts. Unlike the Remote Station there is no startup delay — CW Link keys over the network rather than switching on gear that needs time to boot, so it starts straight away. (The Box-2-Box mode is configuration only, so an autostart just opens the window.) These shortcuts are optional — if you never tick a box, nothing extra is added, and you can remove either one at any time by unticking it here.

ℹ️ Only one feature can auto-start with Windows
CW Link and the Remote Station both offer a Windows-autostart shortcut, but only one of them can be on at a time — both would try to use the same keying hardware the moment you sign in. If you tick CW Link's while the Remote Station's is already set, CW Link refuses and tells you to turn the other one off first: go to Remote Station → Advanced and untick Start automatically with Windows. It works the same way in reverse.

Tips & Troubleshooting

  • One box, one window. CW Link shares the single OpenShack Box connection with the decoder and trainer windows, so it can't run at the same time as those or the Remote Station. Close the others first.
  • Same password, same port, both ends. Most "won't connect" problems are a mismatched link password or port. Turn on Show to check the password.
  • Edges climbing but no RF? The link is carrying keying changes, so check the host-side keying path: radio mode, key/PTT wiring or API connection, and whether the radio is actually enabled to transmit CW.
  • Rough link? Raise the buffer floor a little and, on the box modes, try the Robust buffer profile. A steadier signal beats a snappier one that drops.
  • Audio and CAT are elsewhere. CW Link is keying only. For rig control, waterfall and receive audio, use the Remote Station.
OpenShack