Short: Amiga emulator for MorphOS Author: papiosaur2 hotmail fr (Papiosaur) Type: misc/emu Version: 0.5 (05.10.2026) Architecture: ppc-morphos Requires: MorphOS 3.20+, sdl2.library (gamepads), your own Kickstart ROM (1.3 for the A500, 3.1 for the A1200) URL: https://papio-software.com OVERVIEW ======== Lorraine is a new Amiga emulator, developed from scratch for MorphOS and designed to run at full speed on PowerPC: 50 frames per second on a PowerBook G4 and on a Mirari. It emulates two PAL Amigas: - Amiga 500: 68000 processor, OCS/ECS chipset (copper, blitter, sprites, interlace), 512 KB or 1 MB of chip memory plus 512 KB of slow memory; - Amiga 1200: 68EC020 processor at 14 MHz with its instruction cache, AGA chipset (256 colours, HAM8, 32 and 64-bit fetch, wide sprites), 2 MB of chip memory and 4 to 32 MB of Fast memory. Both have Paula sound with the A500 filters, up to four floppy drives, keyboard, mouse and joysticks. It boots from floppy disk images, WHDLoad games straight from their .lha archive, a hard disk file (HDF, A1200) or a MorphOS drawer seen as an Amiga disk. INSTALLATION ============ 1. Unpack the archive anywhere. 2. Copy your Kickstart 1.3 ROM file into the Roms drawer (any name). For the A1200, add a Kickstart 3.1 (A1200) ROM as well. The ROMs are NOT included: they are still copyrighted. 3. Double-click Lorraine: the settings panel opens. Choose the model, insert a disk in DF0: and click Start. 4. For WHDLoad games (optional), see WHDLOAD GAMES below. USAGE ===== Disk images: ADF, DMS and IPF (SPS/CAPS preservation images, with their copy protections: Rob Northen Copylock, long tracks, weak bits...), also inside ZIP archives. A ZIP holding several disks put in DF0: spreads them over the drives: disk 1 in DF0:, disk 2 in DF1:... up to DF3:, connecting the external drives it needs. Put in another drive, it asks which disk to insert (or name it archive.zip#2 for disk 2). The DF0:...DF3: cycle in front of each drive swaps its disk with the chosen drive: for games that only read DF0:, put disk 2 in DF0: and disk 1 goes to DF1:. ADF disks are writable like real floppies: games and the Workbench save to the ADF file (tick "Write-protect disks" in the panel to keep them untouched). DMS and IPF images are read only. Model: A500 or A1200. Lorraine reads the ROMs of the Roms drawer and only offers those that suit the chosen model, with the chip and Fast memory it can have (Fast: up to 8 MB on the A500, 32 MB on the A1200). Applied at the next Reset. Hard disk: an HDF file on the IDE interface of the A1200. Host folder: any MorphOS drawer seen as an Amiga disk, bootable, on both models. Both apply at the next Reset. WHDLoad games: see WHDLOAD GAMES below. Drop an .adf file on the emulation window: it is inserted in DF0: and the Amiga restarts on it. Drop it on a drive line of the Lorraine panel to change the disk without restarting (disk 2 of a demo...). Game library: the cycle above the left column of the panel shows the Settings categories or the content of the Disks, Harddisk and WHDLoad drawers. Double-click an entry to start it, the Amiga restarts if it was running. Disks: floppy images and archives. Harddisk: HDF files (A1200, Lorraine switches to it from an A500 until a floppy is started again) and drawers seen as bootable partitions. WHDLoad: games as .lha archives or unpacked drawers. The Filter field narrows the list as you type. Press F12 to open the Lorraine panel (and get the MorphOS mouse pointer back); click the emulation window to return to the Amiga. Closing the emulation window stops the Amiga and returns to the panel; Quit (or the close gadget of the panel) leaves Lorraine. The panel is sorted by category, like the MorphOS preferences: Machine (model, ROM, memory), Display (display area, monitor frame), Disks (the four drives, fast loading, write protection, hard disk, host folder), Sound and Controllers. It reopens on the last category used. The retro monitor frame shows the Amiga's lights: POWER, DF0 to DF3 (a disk must be in the drive) and HD. Settings are saved in Lorraine.prefs. F12 settings panel (releases the mouse) and back to the emulation window Alt+Return window / full screen F11 next display area (monitor, full overscan, auto exact, auto stretched) Alt+F11 retro monitor frame on / off Controllers chosen per port in the settings panel: mouse (port 1), USB gamepad (automatic or by name), numeric keypad (8 2 4 6, 0 = fire), keyboard (cursor keys, Ctrl or right Alt = fire) or nothing. Gamepads are read through SDL2: d-pad or left stick to move, face and shoulder buttons fire. The list follows the gamepads you plug or unplug. "Buttons..." gives each button of the gamepad its own job: fire, second fire, a direction (B = up to jump, for instance) or an Amiga key. The ticks under the ports show what each Amiga port receives, emulation running or not. Mouse captured by the Amiga while its window is active From a Shell: Lorraine [rom] [disk] [CHIP=1024] [MODEL=A1200] [FAST=8192] [DF1=disk] [DF2=disk] [DF3=disk] [FASTLOAD=1] WHDLOAD GAMES ============= No Workbench is needed: Lorraine builds a small boot disk for each game, the Kickstart ROM does the rest. Needed once, next to Lorraine: - WHDLoad_usr.lha, the official archive from whdload.de (Lorraine takes the WHDLoad program out of it by itself); - a Kickstart 3.1 A1200 ROM (512 KB, 40.068 preferred) in Roms. Only for the games whose slave asks for a Kickstart image (such as kick34005.A500): the ROM of that version in Roms, and skick346.lha (Aminet) next to Lorraine for the .RTB files. Lorraine tells you when one of them is missing. Why: many WHDLoad installs (mostly games that used AmigaDOS) run on a Kickstart that WHDLoad loads into memory, not on the one of the machine; the slave names the version it wants. WHDLoad needs that ROM image and its .RTB file, a relocation table that lets it run the ROM at another address (it holds no Commodore code). The .RTB files come with SoftKicker, freely distributed on Aminet as skick346.lha (search for "skick346" on aminet.net): Lorraine unpacks it once and copies the right .RTB next to the ROM in the game drawer. Games without a Kickstart image need none of this. Put the game's archive (.lha, or .lzx) or its unpacked drawer (with the .slave file) in the WHDLoad drawer, choose WHDLoad in the cycle of the panel and double-click the game. You can also insert the archive in DF0: or drop it on the emulation window. The game stays in its archive: Lorraine reads it into memory at each start (with xadmaster.library, part of MorphOS) and shows it to the Amiga as a disk, nothing is unpacked. What the game writes (saves, high scores) goes to WHDSaves/, next to Lorraine. Deleting the archive removes the game; its saves stay in WHDSaves until you delete them too. The options of the game icon (tooltypes) are used. Lorraine switches to an A1200 with Kickstart 3.1 and at least 8 MB of Fast memory; your previous settings come back when a floppy disk is inserted in DF0: again. The WHDLoad information window is skipped unless "Show the WHDLoad window" is ticked in the Disks page. To quit a game, use its WHDLoad quit key (often F10), or close the emulation window. Some games, mostly CD32 conversions, need libraries that are not in the Kickstart ROM (lowlevel.library...): they are not supported yet. CONTENTS ======== Lorraine the emulator Lorraine.readme this file History.txt what changed, release by release Roms/ put your Kickstart ROM files here Disks/ disk images (ADF, DMS, IPF, ZIP): a few free demos to start, add your own; the Insert requester opens here Harddisk/ HDF files and drawers used as hard disk partitions WHDLoad/ WHDLoad games (.lha or .lzx archives, or drawers) Papio-Software opens https://papio-software.com Support opens PayPal to support the development STATUS ====== Tested on real hardware (Mirari T1042, PowerBook G4): Kickstart 1.3 and 3.1, the demos Arte, State of the Art, Desert Dream (two drives), Enigma, Mental Hangover and 9 Fingers. Not yet available: hard disk on the A500, ADZ images, 68030 and faster processors, save states. HISTORY ======= See History.txt. DEMOS ===== The Disks drawer holds freely distributable productions of the Amiga demoscene, included with respect and credited to their authors. They will be removed on request. State of the Art Spaceballs (1992) 9 Fingers Spaceballs (1993) Desert Dream Kefrens (1993) Enigma Phenomena (1991) Hardwired Crionics & The Silents (1991) Arte Sanity (1993) Mental Hangover Scoopex (1990) TRADEMARKS ========== Amiga is a trademark of its owner. Lorraine is not affiliated with, nor endorsed by, Amiga Corporation, Cloanto or Commodore. THANKS ====== - MorphOS Team for MorphOS - BeWorld for SDL2 - Skateman, MartinW, Patricks Retro Corner and one Anonymous for their support