OpenShack Manual Iambic Explained

The Keyer Modes

The paddle type is set on the Hardware Settings → Keyer tab, or changed live in the Paddle Analyzer. Four modes are available.

Iambic A vs. Iambic B

In both Iambic A and Iambic B, holding both paddles together sends alternating dots and dashes. The difference is what happens when you release a squeeze part-way through: Iambic A finishes the element in progress and stops, while Iambic B remembers the squeeze and adds one more, opposite element. That extra element is the classic Iambic B character — an advantage once your timing expects it, a source of stray elements until it does.

Diagram: Iambic A versus Iambic
          B — releasing both paddles finishes the current element in Iambic A,
          while Iambic B appends one extra opposite element
Iambic A vs. Iambic B — Iambic B adds one extra opposite element when both paddles are released

Switchpoint & Pause Memory

In Iambic B the keyer watches the opposite paddle while it sends an element, ready to queue that paddle as the next element. The switchpoint sets how far into the element the watching begins: a low switchpoint watches almost the whole element, so the opposite paddle is caught easily; a high switchpoint watches only near the end, so the opposite paddle is caught only if you hold it on. The paddle counts if it is still held anywhere from the switchpoint to the end of the element. Pause Memory extends that watching into the short gap after the element, so a deliberate tap made in the pause is still remembered. Dots and dashes have their own switchpoints (defaults 65% and 45%).

Diagram: Iambic B
          switchpoint and Pause Memory — when the keyer watches the opposite
          paddle through an element and the following pause
Switchpoint and Pause Memory — when the keyer watches the opposite paddle to queue it as the next element

Straight Key

In Straight Key mode the iambic keyer is bypassed entirely: the Box sends exactly what you key, with matching sidetone. Use it with a straight key, a bug, or an external keyer plugged into the paddle jack.

Diagram: Straight Key — the
          box bypasses the iambic keyer and sends exactly what you key, with
          matching sidetone
Straight Key — the iambic keyer is bypassed; you key a straight key, bug, or external keyer directly

Ultimatic

Ultimatic mode changes what a squeeze does: instead of alternating, the keyer repeats the element of the paddle you pressed most recently. Which paddle wins when both are held is set by the Ultimatic priority (Last, Dot, or Dash).

Diagram: Ultimatic mode — with
          both paddles squeezed the keyer repeats the element of the most recently
          pressed paddle instead of alternating
Ultimatic — with both paddles held, the last paddle pressed wins and its element repeats

Paddle Analyzer — Visual Switchpoint Tuning

The diagrams above show what Iambic A/B and the switchpoint do. The Paddle Analyzer in OpenShack shows you your own sending: it draws a live time line of what your paddle did next to the dots and dashes the keyer actually sent, so you can find the settings that fit your fist. Open it from Tools → Paddle Analyzer or Settings → Paddle Analyzer (the Box must be connected).

Paddle Analyzer window — three
          stacked lanes showing dot-paddle touches, dash-paddle touches and the
          dots and dashes the keyer sent, with the Iambic B switchpoint marked on
          each element and the keyer controls along the top
Paddle Analyzer — your dot and dash touches (upper lanes) lined up against the elements the keyer sent (lower lane); the keyer controls sit along the top

Reading the screen

The window is in three parts: a row of controls along the top, the time line filling the middle, and a statistics panel down the right. Time runs left to right; the newest keying is on the right and scrolls in as you send.

The time line has three stacked lanes, labelled at the left edge:

LaneShows
DOTEvery moment your dot paddle was held down (teal bars).
DASHEvery moment your dash paddle was held down (amber bars).
SENTThe dots (short bars) and dashes (long bars) the keyer actually sent — its real output, not what you meant to send.

Reading the two touch lanes against the SENT lane is the whole point: a touch with an element under it was used; a touch with nothing under it was a miss; an element with no touch above it is an extra the keyer added.

Switchpoint overlay (Iambic B). On each sent element the switchpoint is drawn as a vertical mark. The shaded green band from that mark to the end of the element is the capture window: if the opposite paddle is still held anywhere inside it, the keyer takes that paddle as the next element. The red-hatched band before the mark is the deadband: a touch that goes down and comes back up entirely inside it is ignored — but the same touch held on past the mark is caught. That is why it is the far end of your touch that decides a capture, not where it began.

Pause-memory band. With Pause Memory on, the short gap after each element is shaded too — the keyer keeps watching the opposite paddle there. When a tap in that gap actually decided the next element, the band is drawn brighter and carries a ◆.

WPM grid. Switch on WPM grid to overlay faint vertical lines at perfect dit spacing for the set speed, so you can eyeball your cadence against ideal timing.

Time axis and gaps. A time scale runs along the bottom (milliseconds, or seconds when zoomed out). Long silences are collapsed to a thin dashed // break so your keying stays packed together instead of drifting apart.

Hover for detail. Point at a sent element and a tool tip gives its length, the switchpoint position (in ms and %), the opposite-paddle touch as a range, and whether it was caught. Point at a touch bar and it shows how long you held that paddle.

⚠️ Overlays appear in Iambic B only
The switchpoint mark, capture window, deadband and the outcome markers below are drawn only in Iambic B, and only once the Box has reported its live settings. Until it does, the time line shows "reading the keyer's settings…" and no switchpoint line — so it never shows a value the keyer isn't really using.

Outcome markers

Above the SENT lane, an element can carry a small symbol saying how it came to be — read straight from the keyer's real output, not guessed. Any of these can appear at any time, depending on how you keyed:

MarkerMeans
▲ green — capturedThe opposite paddle was still held inside this element's capture window, so the keyer followed with it — a clean Iambic B squeeze.
◆ sky blue — pause-memory catchYou tapped the opposite paddle in the gap after the previous element and let go before this one began; only Pause Memory caught it.
✦ violet — trailingThe keyer added this element after you had released both paddles — the Iambic B tail. Don't want it? Try Iambic A.
○ amber — insertedAn element with no matching touch holding at its start — the keyer put in an element you didn't drive.

A plain element with no symbol is an ordinary one you keyed directly. There is no symbol for a missed touch — a miss shows instead as a touch in the DOT or DASH lane with no element beneath it in SENT.

Moving around the time line

By default the time line runs live, scrolling so the newest keying stays at the right edge.

To…Do this
Look backDrag the time line left or right. It freezes automatically and you can scrub through the last ten minutes.
Freeze / run liveThe Freeze button stops the time line; while stopped it reads Live — press it to jump back to now and resume scrolling.
Zoom in / outRoll the mouse wheel over the time line to zoom around the pointer, or use the Zoom − / + buttons.
Start freshClear empties the time line and the statistics and returns to the live view. Your keyer settings are left untouched.

The Analyzer keeps about the last ten minutes of keying; older activity drops off the left. Everything here is on-screen only — nothing is recorded to a file.

The controls

The controls along the top change the keyer live on the Box — send again to hear the effect. Nothing is written to the Box's memory until you press Save to box.

ControlWhat it does
WPMSending speed in words per minute.
ModePaddle mode: Iambic A, Iambic B, Ultimatic or Straight.
SP dotDot switchpoint — how far into a dot before the keyer grabs the dash paddle. Lower grabs it sooner.
SP dashDash switchpoint — how far into a dash before the keyer grabs the dot paddle. Lower grabs it sooner.
Pause memoryLet the keyer remember a tap you make in the gap between elements.
WPM gridShow or hide the ideal-timing grid for the set speed.
Keep changes in boxAutosave on/off. Off — the default while tuning — lets you try things freely; they're gone at the next power-up. On keeps every change through a power-off.
Save to boxWrite the current settings to the keyer's memory now.

The statistics

The panel on the right measures your keying against the keyer's output and updates as you send. It only shows data — it never tells you what to set; the reading is yours to interpret.

ValueWhat it tells youHelps set
Dots & dashes sentHow many elements you've sent, and the dot / dash split.
Dash → dotOn a dash, how often bringing in the dot paddle actually produced a dot — e.g. 89% (31/35). Each press counts once. Low means you release the dot paddle too early in the dash. A small coverage strip underneath shows where your touches land against the switchpoint mark.SP dash
  typical touchThe usual dot-paddle touch across the dash, as a range from where it goes down to where it comes up (e.g. 40–100 %). The far end, against the switchpoint, is what decides the catch.SP dash
Dot → dashThe same the other way round: on a dot, how often the dash paddle produced a dash, plus its typical touch.SP dot
Typical hold timeHow long you usually hold the paddle for a single dot or dash.speed / feel
How close to a doubleHow close your hold comes to squeezing out a second, unwanted element. 100% would send a double; lower gives more slack.speed / feel
Squeezes / single tapsHow many of your moves were squeezes (both paddles) versus single taps.paddle mode
Both paddles at onceHow many times both paddles were pressed together.paddle mode
Extra after you let goElements the keyer added after you released both paddles — the Iambic B tail.Iambic A vs B
Dot steadinessHow much your dot lengths wander. Smaller is a steadier fist.speed
Your sending speedHow fast your own fist is really going, next to the set speed.speed
Dash / dot ratioHow long a dash is compared with a dot. 3 to 1 is standard.speed / weight
Pause-memory catchesHow many taps only Pause Memory saved — you had let go before the next element began. These are the ◆ marks. Switch Pause Memory off and they turn into dropped elements.pause memory
🎯 Finding your switchpoint — the recommended path
  1. Key a text you know well and listen. Are elements missing, or is the keyer adding extra ones you didn't mean to send? The timeline shows the same thing: a paddle touch with no element beneath it is a miss; an element with no touch above it is an extra.
  2. Elements missing? The keyer isn't catching your squeeze. If you are on Iambic A, switch to Iambic B. If you are already on B, lower the switchpoints so the keyer begins watching the opposite paddle earlier in the element.
  3. Extra, unwanted elements? The keyer is catching squeezes you didn't intend. Switch to Iambic A, or on B raise the switchpoints so the opposite paddle only counts when you hold it right to the end. Turning Pause Memory off is another way to cut extras — it stops the keyer remembering a tap you make in the gap after an element.
  4. Change one thing, key again, and watch the sent lane until it matches what you meant to send.
  5. Click Save to Box to keep the settings after a power-off.
ℹ️ Nothing is stored until you save
While the Paddle Analyzer is open your changes are tried out live on the Box but not written to its memory, so you can experiment freely. Save to Box stores the current settings; closing the window without saving leaves the Box exactly as it was.
OpenShack