Skip to content

Improve setup guide for macOS users on Apple Silicon #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open

Improve setup guide for macOS users on Apple Silicon #10

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
d24858f
Improve macOS installation instructions
NikolayS Aug 20, 2025
1838fdd
Clarify that Hex Fiend doesn't import wxHexEditor XML tags
NikolayS Aug 20, 2025
9c820f3
Replace Hex Fiend recommendation with ImHex
NikolayS Aug 20, 2025
d13ed69
Update macOS instructions - wxHexEditor builds successfully on ARM64
NikolayS Aug 21, 2025
f69ac4a
Streamline macOS Apple Silicon instructions
NikolayS Aug 21, 2025
7d82fd6
Clean up macOS instructions - remove unnecessary alternatives
NikolayS Aug 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -166,19 +166,22 @@ git repo, and following the instructions that it provides:

## Initial setup on MacOS

These steps should help you install pg_hexedit on MacOS (tested on Catalina
These steps should help you install pg_hexedit on MacOS (tested on Catalina and Apple Silicon M1 on Sequoia 15.6
with installed [Homebrew](https://brew.sh/)):

1. `brew install automake autoconf libtool wxmac`
1. Get [wxHexEditor source code](https://github.com/EUA/wxHexEditor) and edit

2. Get [wxHexEditor source code](https://github.com/EUA/wxHexEditor) and edit
`Makefile` removing the line mentioning OpenMP (`LIBS += -lgomp`)
1. Build wxHexEditor (`make`)
1. Get pg_hexedit source code, build (`make`) with `$PATH` including path
3. **For Apple Silicon (M1/M2/M3) Macs:** Configure udis86 with Python: `cd udis86 && ./configure --with-python=/opt/homebrew/bin/python3`
4. Build wxHexEditor (`make`)
5. Get pg_hexedit source code, build (`make`) with `$PATH` including path
to PostgreSQL binaries (Postgres installed via Homebrew –
`brew install postgresql` – should be enough)
1. In hexedit.cfg, check `export HEXEDITOR`, it needs to point to
6. In hexedit.cfg, check `export HEXEDITOR`, it needs to point to
the `wxHexEditor` binary (created above)


Note: The convenience scripts set `$HOME` to the current working directory so
that wxHexEditor reads its settings from a convenience-script-generated
.wxHexEditor config file rather than the true user-wide/system-wide config
Expand Down