zynamfx v2.2.2 (TONE3000 v0.0.12)

[2.2.2] - 2026-10-26

Added

• External MIDI clock. zynamfx can follow a 24 PPQN MIDI clock from hardware or a DAW. The hint
  bar shows the incoming tempo beside the CPU readout — EXT 120.0 LOCKED when the tempo is stable,
  EXT 120.0 CLOCK while it settles, and EXT - NO SIGNAL when nothing arrives — with an activity
  lamp that holds for about 125 ms. Hosted effect slots receive the clock as their host tempo, so
  tempo-synced delays and modulators follow the rig.
• How to use it. Standalone: Settings → Audio → MIDI inputs, tick the device that sends clock,
  then start the clock (zynamfx only opens the inputs you enable). In Logic Pro:
  Project Settings → Synchronization → MIDI, transmit MIDI clock to the virtual port you enabled
  (IAC Driver, for example), and run the transport — Logic sends clock only while it is playing.

Fixed

• Tempo no longer reads half speed on the first lock, no longer ignores a tempo change, and no
  longer mis-reads a halving as dropped ticks. A tempo step is followed within a second or two.
• A hosted effect slot now receives a running transport, so tempo-synced plug-ins follow the clock
  instead of sitting on their internal 120 BPM.
• A hosted effect loaded while the app is running is prepared exactly like one loaded at startup, so
  it syncs without restarting zynamfx.

zynamfx v2.2.2-beta.1 (TONE3000 v0.0.12)

[2.2.2-beta.1] - 2026-10-24

Fixes only, plus the mono-in/stereo-out bus layout (a host-contract addition: no new engine, GUI
surface or file-format change).

Added

• A mono track can insert zynamfx as mono → stereo. isBusesLayoutSupported only accepted
  mono/mono and stereo/stereo, so DAWs never offered the mono-in/stereo-out insert on a guitar
  track. The new layout is the mono source mirrored into both lanes before the input fold, so it
  renders exactly like the same take on a stereo bus (both chain modes). stereo → mono stays
  unavailable on purpose.

Fixed

• Reinstalling no longer leaves the previous AU/VST3 shadowing the new one. The build script
  wrote its -backup- copies next to the live bundle inside Plug-Ins/{Components,VST3}, where
  CoreAudio registers them under the same component identity; the stale copy could win the lookup
  (measured: a fresh AU still refused mono → stereo because the backup answered the probe). Backups
  now go to Plug-Ins/Components-backups and Plug-Ins/VST3-backups, and any strays already in the
  scanned folder are moved there on install.
• The sign-in screen offers a way out of the browser wait. While the system browser is out, the
  page only offered "Copy Link"; SignInScreen now also shows "Sign in on a different device" (the
  phone/device-code flow was already built and wired but never placed on the page). Reported in issue
  #8 as having no escape when the browser never came back.
• The README's build instructions clone the right repository. The git clone line named an
  unrelated account, so anyone following "Build and verify" fetched someone else's fork.

Changed

• The Offset knob's help names its feature. It reads "Spread — double-track lag…", because
  upstream calls the feature Spread and the knob Offset, and users arriving from either build asked
  which control zynamfx has (issue #4).
• docs/PORTING.md records what a port must satisfy — toolchain, JUCE version and patches, the
  identity values host sessions are keyed on, and what is untested on Windows/Linux (issue #7).

---

Free, open-source zynamfx Version 2 for macOS Apple Silicon, based on TONE3000 plugin v0.0.12 at upstream commit ab5e5ae4388753184687d67816815aa481f2cea9. Includes Standalone, AU and VST3 builds, matching source, and an UPSTREAM.txt provenance file. Builds are ad-hoc signed and not notarized. See README for features, installation and TONE3000 integration terms.

zynamfx v2.2.1 (TONE3000 v0.0.12)

[2.2.1] - 2026-10-21

Stable release on the 2.2.0 line: pan corrections, two gallery fixes and a packaging fix.

Fixed

• A pan placement after the branch merge no longer folds the rig. A pan set on a shared-rejoin-tail
  block is now a balance of the merged image that composes with the two lanes' own placements
  instead of replacing them. Before, both lanes resolved to that one value, the image matrix became
  rank-1 and the two chains were summed - an authored cab split (e.g. JCM900 left / Mesa right)
  collapsed into a single signal with a small L/R tilt.
• Hosted-effect tiles react to audio again. The tile's inset energy glow (the blue->yellow->red
  picture driven by the block's output meter) is composited only into ToneImage, which
  ToneTile::syncState hid for effect blocks; the captured plugin screenshot is now injected into
  ToneImage, so it composites the same glow as tone/NAM art and falls back to the effect glyph
  until a screenshot exists.
• The header shows the full version label. The version was drawn into a fixed 48 px slot, so a
  prerelease label was clipped mid-glyph (v2.2.1-beta instead of v2.2.1-beta.3). The logo box is
  now sized from the measured label, so any suffix fits; stable builds keep their exact layout.
• The shipped AU/VST3 identity code is restored (Zyfx), so sessions saved by 2.2.0 load.

Changed

• The pan strip marks a placement that applies to both lanes: accent L/R letters, a two-headed
  marker on the track and an accessibility description, so a shared-tail placement is no longer
  indistinguishable from a lane-local one.
• VERSION records the release number (it read 0.0.14 at every 2.x tag before the beta cuts).

---

Free, open-source zynamfx Version 2 for macOS Apple Silicon, based on TONE3000 plugin v0.0.12 at upstream commit ab5e5ae4388753184687d67816815aa481f2cea9. Includes Standalone, AU and VST3 builds, matching source, and an UPSTREAM.txt provenance file. Builds are ad-hoc signed and not notarized. See README for features, installation and TONE3000 integration terms.

zynamfx v2.2.0 (TONE3000 v0.0.12)

[2.2.0] - 2026-10-18

First stable release since 2.0.1. Everything below ships together.

Added

• The TONE3000 browser runs inside the plugin. Sign-in and the hosted OAuth flow open in an
  in-editor browser panel instead of a separate system-browser window — standalone, AU and VST3.
  Open in Browser, a copyable link and a device code stay as fallbacks; no web engine is bundled
  (macOS uses the system WKWebView).
• Full catalog browsing in the tone browser. Search, sort, format, tags, makes, creators,
  verified/calibrated filters, the signed-in user's downloaded/favorited/created lists, and
  favourite writes — the same TONE3000 API calls the upstream plugin makes, under your own key.
• Parallel chains can rejoin — per channel, not summed. In stereo mode a branch splits at a tone
  block; a second junction rejoins the branch lane at a chosen block. The two paths are not
  summed: after the split each lane keeps its own output channel, and the trunk's remaining blocks
  process both — a shared tail that still lets each lane keep its own pan. No correlated +6 dB and no
  comb filtering. A NAM block inside the shared tail still runs one voice and fans ch0 to ch1, so put
  amps before the merge.
• Every populated slot places the lane, independently. In stereo mode each populated (non-insert)
  slot carries its own compact L↔R placement, stored per block and shown on the slot: 0..1 runs hard
  left to hard right, and a double-click clears it so the slot inherits whatever is upstream (or the
  rail). A serial lane holds one placement, so the last placed block along a lane's path wins — which
  is what makes the two lanes independent; a slot in a shared rejoin tail places both. The rail knobs
  keep the same full range, with a bipolar arc that grows out of noon. Hidden in mono and mono-sum,
  where the image matrix bypasses pan.
• The branch row ends at the join. With a rejoin active, the second row no longer offers empty
  slots past the merge point, and the return elbow is drawn at the merge column.

Fixed

• In-app sign-in no longer fails with "redirect_uri must be a valid URL". JUCE's macOS browser
  percent-encodes the whole URL it is given; the already-escaped authorize URL was double-encoded
  before it reached TONE3000. The panel now hands the webview the decoded URL.
• Search works again in the tone browser. The fork had hidden the search field and reduced the
  filter row to gear chips, so only paging was possible.
• Device-code sign-in works. Requesting and polling a device code was refused locally; the RFC
  8628 flow is restored.
• Branch dots are visible. They were fully transparent until hovered in a 24 px gap.
• Beta-line fixes carried into the stable release: settings persistence (dangling-symlink heal),
  slot click opens the tone browser, right-click opens the AU/VST3 chooser, the publishable key is
  re-read when Settings saves it, prerelease builds never prompt for updates, and right-click paste
  works in the key field.

---

Free, open-source zynamfx Version 2 for macOS Apple Silicon, based on TONE3000 plugin v0.0.12 at upstream commit ab5e5ae4388753184687d67816815aa481f2cea9. Includes Standalone, AU and VST3 builds, matching source, and an UPSTREAM.txt provenance file. Builds are ad-hoc signed and not notarized. See README for features, installation and TONE3000 integration terms.

zynamfx v2.0.1 (TONE3000 v0.0.12)

[2.0.1] - 2026-10-14

Added

• The build version is shown discretely beside the ZY monogram in the header.
• Hosted-FX search. A search field sits at the top of the Add AU/VST3
  Effect chooser: an empty query keeps the vendor -> effect browsing, and typing
  filters every installed AudioUnit and VST3 into one scrollable list
  (name . vendor (AU/VST3)), case-insensitive tokens that must all match.
  Searching only filters the already-listed bundles; it never scans or
  instantiates.
• Opt-in AudioUnit validation. Settings -> Diagnostics -> Validate installed
  Audio Units probes every installed AU out of process with Apple's auval
  (each in its own process, with a per-plugin timeout) and writes a resumable
  report to ~/Library/Application Support/zynamfx/hosted-effects-validation.txt.

Fixed

• Multi-bus (side-chain) hosted effects now load and render. The chain
  drives the plug-in's main bus and feeds any extra buses silence, instead of
  disabling them (which crashed plug-ins that read their side-chain, e.g.
  Plugin Alliance bx_aura) or rejecting them. This unblocks the large set of
  installed effects that declare a second bus.
• Build identity is a build input. The release workflow builds the public
  channel, so a published app's in-app repository link points at GitHub.

---

Free, open-source zynamfx Version 2 for macOS Apple Silicon, based on TONE3000 plugin v0.0.12 at upstream commit ab5e5ae4388753184687d67816815aa481f2cea9. Includes Standalone, AU and VST3 builds, matching source, and an UPSTREAM.txt provenance file. Builds are ad-hoc signed and not notarized. See README for features, installation and TONE3000 integration terms.

zynamfx v2.0.0

Free, open-source zynamfx Version 2 for macOS Apple Silicon. Includes Standalone, AU and VST3 builds and the corresponding source archive. Builds are ad-hoc signed and not notarized. See README for features, installation and TONE3000 integration terms.