Repository navigation
MacOS Port of Notepad++ HexEditor plugin
HEX-Editor for Notepad++ macOS — v1.0.0
The first public release of the macOS port of the HEX-Editor plugin (originally by Jens Lorenz for Windows). Drops in to Notepad++ macOS as HexEditor.dylib, mirrors every entry on the Windows plugin's menu, and adds a few macOS-native niceties.
Highlights
- Inline hex view — toggle any buffer between Notepad++'s text editor and an offset / hex / ASCII grid with Plugins → HEX-Editor → View in HEX. Direct byte editing in either pane; bit-precise editing in binary notation.
- Cursor and selection follow you in — open the hex view and the byte at your text cursor is already selected. Selections are mirrored too, with the hex caret landing at the end of the selected range.
- View modes — 8/16/32/64-bit grouping, hex or binary notation, big/little-endian display order, configurable address-column width and bytes-per-row. All preferences persist across launches.
- Search — Find (⌘F), Find and Replace (⌘⌥F), Find Next (⌘G), Find Previous (⌘⇧G). Auto-detects ASCII text vs hex byte patterns.
- Go to Offset (⌘L) — accepts decimal (
1234), hex (0x4A2), or relative offsets (+0x10,-100). - Compare HEX — pick any file from disk; differing bytes highlight in red. One-click clear when you're done. (Compares against a file rather than a second split-view pane — see CHANGELOG for the details.)
- Insert Columns / Pattern Replace — inject or fill with repeating hex patterns; both apply as a single undo step.
- Trackpad pinch-to-zoom — two-finger pinch resizes the hex font using the same algorithm Notepad++'s text view uses, so the gesture feels identical in both.
- Localization — ships English (
en,en-GB,en-US) and German (de). New languages drop in asLocalizable.<lang>.stringsfiles; regional override files (e.g. British vs. American spellings) need only contain the keys that diverge. - Dark mode and accent colour follow the host automatically — no Options dialog to fiddle with.
Install
cmake -S macos -B macos/build-universal -DCMAKE_BUILD_TYPE=Release
cmake --build macos/build-universal
cmake --install macos/build-universalRestart Notepad++ macOS; the Plugins → HEX-Editor submenu appears with six entries. See README.md for prerequisites and DEVELOPER.md for the full build, test, and contribute guide.
Differences from the Windows version
Each macOS divergence is a deliberate choice; full reasoning in CHANGELOG.md.
- Compare HEX picks a file from disk instead of comparing two split-view panes (the macOS host doesn't yet expose a plugin API for reading a second split pane).
- No Options dialog — Notepad++ macOS owns appearance via the host's Style Configurator and Appearance settings. The plugin uses semantic colours that follow.
- Pattern Replace operates on linear selections only — rectangular block selection isn't supported yet (planned for v1.1).
- Goto via ⌘L and the context menu, not via the host's Search → Go to Line.
Tests
37-case XCTest UI suite + a C++ unit tier (cursor math, edit planning, search) + a smoke test that loads the dylib and checks the plugin contract. All green at release. See DEVELOPER.md for the three test tiers and the Parallels VM workflow that lets the UI tier run without taking over your keyboard for ~14 minutes.
Known limitations / planned
- No rectangular (block) selection yet — planned for v1.1, tracked at the v1.1 plan in CHANGELOG.md.
- No keyboard shortcut to switch directly between hex and text view beyond the menu item.
- Compare HEX has no
.cmpcache file (Windows has one); the diff is recomputed on each Compare invocation.
License
GPLv2, inherited from Jens Lorenz's original 2006 source.