Be the other end of your HL7 v2 interface.

V2Mirror is an MLLP receiver for HL7 v2. It listens on as many ports as you need, answers every message with the acknowledgment you choose, and shows exactly what the sender put on the wire. One portable program for Windows, macOS and Linux, with nothing to install.

Download

Detecting your system…

AAvalid ACK without any setup
>5,000messages per second
0installers, accounts or cloud
7builds for Windows, macOS & Linux
Features

A test receiver you can trust

Test a sending application before the real receiver exists, reproduce a NAK or a timeout, or see exactly what a system sends. No old Windows-only tools, no one-off scripts, no integration engine set up just to listen.

As many listeners as you need

Each on its own port, started and stopped on its own, with several clients at once and persistent connections. You see at a glance which is listening, connected or blocked by a port in use.

Correct ACKs out of the box

Sender and receiver swapped, MSA-2 set to the incoming MSH-10, version, processing ID and character set copied, the message's own delimiters kept. Original and enhanced mode (MSH-15/16) included.

Response rules

Answer AE for an unknown patient, AR for orders, nothing at all, or a custom message, by message type, any HL7 path, sender or client IP. First match wins. How it works

Fault simulation

Fixed or random delays to test timeouts, no reply, a dropped connection, or a rule that fires only on every Nth message or with a probability, to test retries against a flaky receiver.

A log that explains itself

Every message with its parsed segment tree and field names, the raw text, the ACK that went back, a hex view of the frame and the rule that decided. Rows are coloured by what the sender got.

Search by text or path

Find PID-3.1 = 4711 across everything received, in the same path syntax as V2Lens, and filter by listener, ACK code, message type, client and time. 100,000 messages in well under a second.

Bad framing, made visible

Strict or tolerant MLLP framing. Missing 0x0D, LF endings and stray bytes are flagged with a hex view instead of silently dropped, and a size limit stops runaway senders.

Variables, templates and TLS

Ports, ACK texts and rules take {{variables}} from the same environments as V2Lens and HTTPrism. ACK templates take any HL7 path of the incoming message. MLLP over TLS 1.2/1.3.

Portable and private

Everything, including received messages, stays in a v2mirror-data folder next to the program. Every message is stored before its ACK goes out. V2Mirror connects nowhere unless you allow update checks.

Response rules

Reproduce the reply that breaks the sender

Rules are checked from top to bottom, and the first match decides the reply. A message that matches no rule gets the default AA.

  • Conditions on the message type (ADT, ORU^R*), any HL7 path with equals, contains, regex or empty, the sending application or facility, and the client IP.
  • Replies AA, AE or AR with your text and an ERR segment, a custom message from a template, or no reply at all.
  • Wait 200 to 2000 ms, close the connection, or fire only on every third message or 10% of them.
  • Test against selected message shows which rule a logged message hits and exactly what would be sent.
  • Export a listener with its rules as JSON and share the test receiver through Git.
The log

See exactly what arrived

Pause the live list without stopping the listeners, search everything received, and open any message parsed, raw, as the ACK it got, or byte by byte.

The log is limited by count or age (10,000 messages per listener by default) so it never fills the disk. Received messages can contain patient data: they stay on your disk, and Clear all data removes them.

PID-3.1 = 4711     # patient ID equals 4711
PID-5.1 ~= mül     # contains, case-insensitive
PV1-2 != I         # everything but inpatients
OBX[2]-5           # field 5 of the third OBX
ORC-1              # messages with an order control
Filters: listener · AA AE AR · no reply
         problems · type ADT^A0* · client · time
Round trips

V2Lens sends, V2Mirror receives

Point V2Lens at 127.0.0.1:2575 and test both ends of an interface on one machine: the message in V2Lens, the ACK you configured, and the log entry in V2Mirror.

  • The same HL7 engine and definitions, 2.1 to 2.8.1
  • The same path syntax, environments and {{variables}}
  • Open in V2Lens hands received messages over through a folder in V2Lens's sidebar
  • Optionally anonymized on the way, with V2Lens's rules
Fast and robust

Built to stay up

A bad frame or a dropped client never stops a listener or affects other clients. Every message is written to the log before its ACK goes out, so nothing acknowledged is ever lost.

>5,000/smessages on one listener with auto ACK
<0.2 msfrom the complete frame to the ACK
<1 sto search 100,000 messages by HL7 path
<1 sto start
Shortcuts

Keyboard first

Ctrl FSearch the log
SpacePause the live list
EnterOpen in V2Lens
↑ / ↓Previous / next message
Ctrl CCopy the selected messages
Ctrl KCommand palette

On macOS, use ⌘ instead of Ctrl.

Get started

Unzip, run, press ▶

No installer and no runtime. Extract the zip to a folder you can write to and start V2Mirror. It comes with one listener on port 2575 that answers every message with an AA. Each zip includes a SETUP.md for its system.

Windows

Your system
  1. Extract the zip to a folder you can write to, such as C:\Tools\V2Mirror. Not Program Files.
  2. Start v2mirror.exe. If SmartScreen appears, click More info → Run anyway.
  3. When a listener starts, allow V2Mirror through the firewall for the networks your senders are on.

Windows 10/11 · uses the built-in WebView2 runtime

macOS

Your system
  1. Unzip and move V2Mirror.app to its final folder. Its data folder is created next to it.
  2. Before the first start, allow it under System Settings → Privacy & Security → Open Anyway, or run xattr -dr com.apple.quarantine V2Mirror.app.

Apple Silicon and Intel builds · native WebKit window

Linux

Your system
  1. Unzip into a folder you own, such as ~/Apps/V2Mirror. With a Snap browser, not a hidden folder.
  2. Run ./v2mirror. Open the listener ports in your firewall; ports below 1024 need extra rights.

Opens as an app window of Chrome, Edge, Chromium, Brave or Vivaldi, or in Firefox and its relatives

Loading…