Installation

Build from Source

Prerequisites

All platforms require a C compiler and make. On macOS, install the minimum requirements for development:

brew tap messense/macos-cross-toolchains
brew install dpkg llvm mingw-w64 x86_64-unknown-linux-gnu msitools nsis

For DOS cross-compilation, install DJGPP from GitHub to /usr/local/djgpp, then:

sudo xattr -r -d com.apple.quarantine /usr/local/djgpp

For Linux and BSD, only a C compiler and make are needed.

Build

git clone https://github.com/humbertocsjr/hcsdkretro.git
cd hcsdkretro
make posix
sudo make install

This installs to /usr/local/bin. Use make install PREFIX=/custom/path to change the destination.

Platform-Specific Builds

CommandPlatform
make posixmacOS / Linux / BSD (native)
make linuxLinux x86_64 static binary
make macosmacOS universal (x86_64 + ARM)
make winWindows 64-bit (MinGW cross-compile)
make win32Windows 32-bit
make dosDOS (DJGPP cross-compile)

Pre-built Packages

PlatformFormat
macOS.pkg installer, .tgz
Linux x86_64.deb package, .tgz
Windows 64-bit.exe NSIS installer, .zip
Windows 32-bit.exe NSIS installer, .zip
DOS.zip (DJGPP)

Verify Installation

hcbcomp-z80 --help     # or: hcbcomp-z80 -h
hcasm-z80 -h
hclink-bin -h
msxdosemu -h