Developer preview v1.1.2 — installation, packaging, and some platform support are still in progress. Read the status
Skip to content

Amiga ​

Clorraine is designed for 68K Amiga systems first. It emits plain C99 and builds with the AmigaPorts m68k GCC toolchain, so the output fits the compilers, libraries, and emulators the platform already has.

Two baselines ​

BaselineWhat it means
A500 / Kickstart 1.368000, OCS, 512 KB chip RAM, -mcrt=nix13. A first-class target, not an afterthought
AmigaOS 2.0+Bigger machines and the 2.0+ modules: Workbench, icon, expansion, and the optional services

The hosted-amiga-13 profile provides the 1.3-safe subset. The hosted-amiga profile provides the 2.0+ surface. A construct the selected profile cannot lower is rejected with E11200; it is not silently emulated.

What is covered ​

The SDK registry tracks 81 capabilities across 11 bundles, all accepted:

AreaExamples
Native videoChip memory, bitmaps, blitter, copper, double buffering, palette
SpritesEight hardware channels, attachment, collision
Audio and inputAudio channels, samples, mouse, keyboard, joystick
Text and layersTopaz fonts, text rendering, layer clips
DOS and assetsFiles, directories, paths, ILBM loading
IntuitionScreens, windows, gadgets, requesters, menus
Exec and devicesTasks, ports, messages, interrupts, timers, libraries
WorkbenchAppIcons, AppMessages, Workbench startup
Optional servicesASL, commodities, locale, ARexx, clipboard, datatypes, network, Picasso96, and more

See SDK coverage for the full table and the tracked boundaries.

A real A500 run ​

The Clorraine Boing demo: a chequered Amiga screen with a shaded sphere.
The Boing acceptance program on A500 / Kickstart 1.3 / OCS.

The Boing demo owns a 320×256×4 custom display built from chip-memory bitmaps. It draws a checkerboard, blits a shaded ball through a mask, and changes background colours with a copper list. The final frame checksum is compared on every A500 gate.

Emulator workflow ​

ToolUse it forNeeds a ROM?
vamosConsole programs, fast iteration, CINo
FS-UAEGraphics, audio, Intuition, timersNo with the built-in AROS ROM
FS-UAE with licensed mediaOriginal Kickstart/Workbench behaviorYes, user-supplied

Inside the repository:

sh
make run FILE=examples/hello/hello.clo PROFILE=hosted-amiga
make run FILE=examples/amiga/boing.clo PROFILE=hosted-amiga-13 EMULATOR=1

The first command runs under vamos. The second builds and boots FS-UAE. See the emulator workflow for the exact prerequisites.

Profiles ​

ProfileMachineRuntime
hosted-amigaAmigaOS 2.0+libnix -mcrt=nix20
hosted-amiga-13A500, 68000, OCS, 512 KB chip, KS 1.3libnix -mcrt=nix13
freestandingProvisional LorraineOS ABIno libc

The host profile exists for fast tests. It is not an Amiga artifact.

Media policy ​

Clorraine does not distribute Kickstart ROMs or Workbench media. No ROM or Workbench image is stored in the repository. FS-UAE's built-in AROS replacement ROM is the default; licensed media is supplied by the person running the gate.

Read the licensing and provenance page.

Screenshots ​

Every image in the gallery comes from an FS-UAE acceptance run. No mockups, no Workbench marketing shots.

Clorraine is an independent project. Amiga, AmigaOS, Kickstart, and Workbench are trademarks of Amiga Corporation. Not affiliated with or endorsed by Amiga Corporation or Hyperion Entertainment.