See inside your HL7 v2 messages.

V2Lens is a desktop tool for HL7 v2 messages. Browse and edit message files, search them by text or HL7 path, send them over MLLP and anonymize them. One portable program for Windows, macOS and Linux, with nothing to install.

Download

Detecting your system…

2.1–2.8.1HL7 definitions built in
0installers, accounts or runtimes
7builds for Windows, macOS & Linux
MLLPsending, with optional TLS
Features

Made for the messages you actually get

Batch files, odd encodings, Z segments and versions from 2.1 to 2.8.1. V2Lens reads them as they are and saves them byte for byte.

An editor that speaks HL7

Segment names, delimiters and escape sequences are highlighted using each message's own MSH delimiters. Every other field is shaded, and hovering a value shows its path, name, type and decoded value.

Every version built in

Definitions for HL7 2.1 to 2.8.1: segments, fields, data types, message structures and trigger events. Each message is described with the version in its MSH-12.

Inspector & structure

See the canonical path of the value under the cursor, its definition and warnings for empty required fields or values that are too long. The structure tree flags missing and unknown segments.

Search by text or path

Find PID-8=F or OBX[2]-5 in the open file or across every folder at once. The folder search runs in the background and streams results as it goes.

Send over MLLP

Saved endpoints with optional TLS, a fresh control ID and timestamp on every send, and parsed acknowledgments that flag a mismatched MSA-2. Send one message, a file or a whole folder, in the order you pick.

Anonymize safely

Rules hash, fake, shift, replace or remove values, with a live preview. Send a message anonymized with one shortcut, or anonymize whole folders into a new one.

Encodings handled

Byte order marks, UTF-8, windows-1252 and ISO-8859-1 are detected, double-encoded text such as Müller is repaired, and files are saved in their original encoding and separators.

Variables & environments

Define variables like {{patient_lastname}} in environments and use them in any message. They are filled in when you send, so your files stay templates. How it works

Portable and private

Everything lives in a v2lens-data folder next to the program. V2Lens only connects to the endpoints you configure and, if you allow update checks, to this site.

New in 0.2 · Variables

One message, every test patient

Define variables like {{patient_lastname}} and use them anywhere in your messages. V2Lens fills them in from the active environment when it sends, so your files stay reusable templates.

  • Environments hold the values. Switch them with the ENV chip, independently of the endpoint, to send the same patients to several systems.
  • Values go in exactly as written: delimiters, several lines, even whole segments. A line that is just {{obx}} can hold any number of OBX segments.
  • Typing {{ suggests variables, hovering shows the value, and undefined ones are flagged before anything is sent.
  • Send anonymized fills in the variables first, then anonymizes what goes out.
  • The response shows which environment was used and the template behind the message.
HL7 paths

One path syntax for everything

The inspector shows the path of the value under the cursor. Copy it, and use it to search, to jump or to write an anonymizer rule.

Auto mode treats your input as a path when it parses as one and as text otherwise. Repetition indexes are 0-based, and groups are addressed by their anchor segment.

PID-5            # whole field, all repetitions
PID-5.1          # component 1 in every repetition
PID-3[1].1       # component 1 of the second repetition
OBX[2]-5         # field 5 of the third OBX
ORDER_OBSERVATION[1]/OBX-3.1
                 # groups, by anchor segment
PID-8=F          # only values equal to F
PID-5.1~=mül     # contains, case-insensitive
Anonymizer

Real structure, no real patients

A rule is a path and an action. The built-in Default preset covers identifiers, names, dates, addresses and phone numbers in PID, MRG, NK1, PV1, GT1 and IN1.

Hashlook-alike letters and digits, same length and punctuation
Fake nameplausible family and given names
Shift datethe same shift for every date of a patient
Replacea fixed text
Removean empty value
Deterministic & safe

The same input, the same result

Results come from an HMAC with a per-install key, so a patient is anonymized the same way in every file, and other machines can share the key.

  • Live preview with changed values highlighted
  • Overlapping rules never corrupt a message
  • Send anonymized without touching the editor text
  • Batch runs mirror the folder tree and keep encodings
  • The report lists the rules, never the values
Shortcuts

Fast hands, fast messages

Ctrl EnterSend the message
Ctrl Shift EnterSend it anonymized
Ctrl KCommand palette
Ctrl FFind in file
Ctrl Shift FSearch all files
Ctrl GGo to path
Alt ↑ / ↓Previous / next message
Ctrl SSave, byte for byte
Ctrl N / ONew message / open file
Ctrl TabSwitch tabs
Ctrl JToggle the bottom pane
Ctrl ,Settings

On macOS, use ⌘ instead of Ctrl.

Get started

Unzip and run

No installer and no runtime. Extract the zip to a folder you can write to and start V2Lens. 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\V2Lens. Not Program Files.
  2. Start v2lens.exe.
  3. If SmartScreen appears, click More info → Run anyway.

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

macOS

Your system
  1. Unzip and move V2Lens.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 V2Lens.app.

Apple Silicon and Intel builds · native WebKit window

Linux

Your system
  1. Unzip into a folder you own, such as ~/Apps/V2Lens. With a Snap browser, not a hidden folder.
  2. Run ./v2lens.

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

Loading…