Get maux
One bootable disk image with the system, the tools, the compilers and the manual.
32 MB (33,554,432 bytes). SHA-256 2fa8e7fb49b4c5d6a9c689ac92842e2e64c6c358325703e5a471d262b3a7a75c.
Each release also has SHA256SUMS and a source archive.
Try it in your browser
Boots this disk in Apple2TS, an Apple II emulator in your browser. Type at a human pace: it is a IIe keyboard.
Run it
In an emulator
mame apple2ee -aux rw3 -sl7 a2sd -hard maux-VERSION.po
That sets up an enhanced IIe with a RamWorks III and the disk on an AppleIISd card. Add a Mouse or Mockingboard card for the 60 Hz clock tick; you supply the Apple ROMs.
On an Apple IIe
You need an enhanced IIe, a RamWorks-style card with at least 1,024 KB,
and a SmartPort card that can present a 32 MB volume (an SD or CompactFlash
adapter). Write the disk to the card's media byte for byte, for example
dd if=maux-VERSION.po of=/dev/rdiskN bs=1m, then boot from that slot.
Nobody has run it on real hardware yet.
Quick start
- Boot. You land at the shell prompt.
- Run
ls /binto see the commands, andpsto see the processes. - Run
man manto learn the manual;qleaves it. - Next, Learn to write a program, or Watch it run.
Requirements
- An enhanced Apple IIe (65C02)
- A RamWorks-compatible card with at least 1,024 KB, presenting
banks
$00to$0F— the kernel does not probe, it uses those sixteen and no others. A fully populated main board gives exactly them. 1,024 KB reached any other way (say a part-filled board plus an expander) can leave gaps in that range, and bank select is write-only, so maux will hand a process a bank that is not there without noticing. - An AppleMouse or Mockingboard card, for the clock tick
- A SmartPort card that can present a 32 MB volume
Or an emulator: MAME, or Apple2TS in your browser.
Optional
- A Videx UltraTerm, for an enhanced terminal: more screen modes and hardware scrolling
- A Super Serial Card, to
tipin and out of another machine
Limits
Single user, no memory protection, no network stack and no C compiler. Only emulator runs are on record so far.
Source and licence
The code is MIT licensed. The source is in the project repository. Manual pages derived from V7 and BSD keep their own notices; see About.