SOURCE / BUILD / TEST

From source
to Workbench.

Get the code, prepare your toolchain and build Beam68 from scratch. Native builds and portable checks are documented separately below.

01 / GET THE CODE

Start with the source.

Browse the GitHub repository ↗ or choose a tagged source package on the Download page.

git clone https://github.com/retrocs-org/beam68.git
cd beam68

Install a host C compiler, Python 3 and PHP CLI for portable checks. Native builds also need a configured Amiga toolchain and NDK headers.

02 / BUILD

From source to Workbench.

Use AmigaDev GCC/libnix with Amiga NDK headers, or a configured vbcc/NDK toolchain. The native build targets 68000 without an FPU. Toolchains and licensed operating-system files are supplied separately.

BEAM68_CC=/path/to/m68k-amigaos-gcc ./scripts/build-amiga.sh all
BEAM68_SOURCE_ONLY=1 make host-test

Portable checks need a host C compiler, Python 3 and PHP CLI. Source-only checks do not certify native executables.

Read the build documentation ↗ · Manual test plan ↗

03 / COMPATIBILITY

Test before sharing.

Portable tests cover the core, settings, plugins and packaging. Physical 68000 systems, minimum memory, all translated layouts, optional host apps and full clean-install coverage remain to be verified. Workbench launching uses workbench.library V44+ when available and a built-in fallback on older supported systems.

Detailed build and testing notes ↗