A free, open-source replacement for MUI on AmigaOS 3.x
OpenMUI 2026.11.19 (OpenMUI 1.0) for AmigaOS 3.x / m68k
=================================================
OpenMUI is a free, open-source replacement for MUI on AmigaOS 3.x. It
provides muimaster.library, the built-in classes and a preferences
program, and runs programs written for MUI 3, 4 and 5. Its look and
memory use follow MUI 3.8.
OpenMUI is not MUI and is not affiliated with MUI's authors. MUI was
created by Stefan Stuntz; MUI 4 and 5 come from the MUI team. MUI was
studied black-box only: its behaviour was measured and its public
documentation read; its code was never read or copied.
Origins: Zune (The AROS Development Team), ported to AmigaOS 3 as Zune68
(Stefan Reinauer); OpenMUI is the lean edition of Zune68.
Version: OpenMUI 1.0 (2026.11.19). All figures were measured in
an emulator (FS-UAE), not on a real Amiga.
Documentation
-------------
Docs/OpenMUI/UserGuide.txt installing, switching, preferences
Docs/OpenMUI/DeveloperGuide.txt supported interface, differences, building
Docs/OpenMUI/Reference/ functions and classes
Docs/OpenMUI/Changelog.txt release history
Compatibility compatibility workloads and limits
Requirements
------------
AmigaOS 3.1 or newer, a 68000 or better, no FPU. Amiga Installer 43 or
newer: OS 3.2 has SYS:System/Installer; for OS 3.1 use Installer 43.3
(Aminet util/misc; the Installer on the OS 3.1 Install disk is older).
If Workbench cannot find the installer, set the Install icon's Default
Tool to its full path.
Installing
----------
Double-click Install, or from a Shell in this drawer:
Installer Install MINUSER AVERAGE
The installer first shows what it found: an existing MUI (3.x, 4 or 5 in
SYS:MUI or MUI:, its lines in S:User-Startup), every muimaster.library in
the LIBS: drawers, and an earlier OpenMUI installation. None of it is
changed. OpenMUI goes into the first LIBS: drawer (normally SYS:Libs),
which programs search before MUI's MUI:Libs. S:Startup-Sequence and
S:User-Startup are not changed.
Libs/muimaster.library -> first LIBS: drawer
Libs/OpenMUI/* -> LIBS:OpenMUI/ (class files and modules,
loaded when a program first needs them)
Libs/MUI/* -> LIBS:MUI/ of the first LIBS: drawer, never
into a real MUI's own MUI:Libs/mui
Prefs/OpenMUI -> SYS:Prefs/OpenMUI
Locale/Catalogs/* -> LOCALE:Catalogs/<language>/ (optional)
Tools/OpenMUISwitch and the icons -> SYS:OpenMUI
Every file the installer replaces is kept in SYS:OpenMUI/Data/Backup;
every file it installs is recorded in SYS:OpenMUI/Data/Manifest.
Bundled MUI classes (NList, TextEditor, TheBar, UP-MCC and others) are
installed only when no same or newer version is in a LIBS:MUI drawer; an
older one is kept in the backup. Classes of a real MUI (MUI:Libs/mui)
belong to that MUI and are not used by OpenMUI, which has its own copies.
The last installer page lists what was done with each.
Running Install again offers "Install this version over it" (an update:
the earlier installation is removed, your files put back, the new one
installed; settings are kept) and "Remove OpenMUI".
An installation of an earlier test build is migrated: its settings in
ENVARC:Zune and ENV:Zune move to ENVARC:OpenMUI and ENV:OpenMUI (a file
already there is not replaced), and its files leave LIBS:Zune. Other
files in LIBS:Zune are kept in the backup and returned by Uninstall and
"Use real MUI".
Novice installs everything without questions; Intermediate and Expert
ask whether to install the translations. Pretend mode changes nothing.
Use real MUI, Use OpenMUI, Uninstall
------------------------------------
Icons in SYS:OpenMUI (Use real MUI and Use OpenMUI only when a real MUI
was found):
Use real MUI moves OpenMUI's libraries and classes to
SYS:OpenMUI/Data/Parked and puts back your own files they
replaced. After a reboot programs get your MUI.
Use OpenMUI the reverse; after a reboot programs get OpenMUI.
Uninstall deletes every file OpenMUI installed, restores every
file of yours it replaced, removes the drawers it made
when empty. Asks whether to keep ENVARC:OpenMUI.
From a Shell: SYS:OpenMUI/Data/OpenMUISwitch MUI, OPENMUI, UNINSTALL
[SETTINGS] or STATUS (what is installed where).
Settings
--------
SYS:Prefs/OpenMUI is the preferences program. Settings are in
ENVARC:OpenMUI (saved) and ENV:OpenMUI (in use). MUI's own settings
(ENVARC:MUI) are not changed. Class files are in LIBS:OpenMUI.
A program written for MUI 3 sees MUI 3.8 (muimaster.library 19.35), one
asking for MUI 4 sees MUI 4, one asking for MUI 5 sees MUI 5 (21.227).
Preferences, System page, "MUI version": "Behave as" Automatic (default),
MUI 3.8, MUI 4 or MUI 5 for all programs, and a list of programs (by file
name) with a MUI of their own. Many programs written for MUI 4/5 ask for
version 19 and so get MUI 3.8 under Automatic: give such a program MUI 5
in that list.
Status
------
muimaster.library 21.227, dated 2026.11.19. Emulator measurements of
2026-11-19 (A1200, OS 3.1, 4 MB fast RAM): MUI-Demo needs 428 KB for the first
program (MUI
3.8: 460 KB) and 193 KB for each further one (MUI 3.8: 211-219 KB). Not
measured on a real Amiga. Reports: https://github.com/creep-ltx/openmui
Developing with the SDK
-----------------------
Add SDK/include to the include path and link with -lmui:
m68k-amigaos-gcc -noixemul -Os -I../include -o HelloZune HelloZune.c -lmui
Source and licences
-------------------
Source.tar.gz has the corresponding source and the native build tools.
Zune68: https://github.com/reinauer/zune68
AROS: https://github.com/aros-development-team/AROS
LICENSE has the AROS Public License; the bundled classes keep their own
licences and copyright notices, with their sources and under Docs.
UP-MCC 1.0 is by spotUP, https://github.com/spotUP/selecta: MIT
(Docs/UP-MCC/LICENSE), its Lucide icons ISC (LICENSE.Lucide), the Inter
font SIL Open Font License 1.1 (LICENSE.Inter).
Credits:
Code: Creep
Code: Claude
Released by Up Rough - https://www.uprough.net
|