µvMac - cleaned up fork of the Macintosh emulator Mini vMac
Go to file
InvisibleUp 7321519490 [Fix #6] Use MSB byte ordering for video blitting 2023-11-26 13:58:38 -08:00
.vscode Add VSCode debug configuration 2023-09-23 14:33:09 -07:00
_work Try to get Mac II emulation working again 2020-07-09 21:44:36 -04:00
cfg [#9] Port build system to CMake 2023-11-24 20:57:28 -08:00
docs Add no-rom screen gfx 2020-07-04 00:41:38 -04:00
extras More type/my name standardization 2020-02-11 00:34:32 -05:00
gfx Add no-rom screen gfx 2020-07-04 00:41:38 -04:00
lib Move external libraries from src/ to lib/ 2023-09-23 14:51:26 -07:00
rsrc Remove obsolete platform code 2023-09-23 14:28:39 -07:00
src [Fix #6] Use MSB byte ordering for video blitting 2023-11-26 13:58:38 -08:00
vcpkg@cd5e746ec2 [#9] Port build system to CMake 2023-11-24 20:57:28 -08:00
.gitignore Add VSCode debug configuration 2023-09-23 14:33:09 -07:00
.gitmodules [#9] Port build system to CMake 2023-11-24 20:57:28 -08:00
CMakeLists.txt [#9] Port build system to CMake 2023-11-24 20:57:28 -08:00
CMakePresets.json Update README, set default build tool to Ninja 2023-11-24 21:40:50 -08:00
COPYING.txt Rebrand to "micro vMac", clean up docs 2020-03-14 20:41:42 -04:00
README.md Update README, set default build tool to Ninja 2023-11-24 21:40:50 -08:00
meson.build Fix build issues on Linux 2023-11-24 18:01:52 -08:00
vcpkg-configuration.json [#9] Port build system to CMake 2023-11-24 20:57:28 -08:00
vcpkg.json [Fix #6] Use MSB byte ordering for video blitting 2023-11-26 13:58:38 -08:00

README.md

µvMac 0.37.0

Forked from Mini vMac v36.4 by Paul C. Pratt (http://www.gryphel.com/c/minivmac), which was forked from vMac by Philip "PC" Cummins (http://www.vmac.org/main.html)

µvMac (micro vMac) is a small, simple emulator for early Motorola 68000 based emulators. Currently we support systems from the original Macintosh 128K all the way up to the Macintosh II.

This fork was created to clean up and modernize the code base, make the project easier to compile and hack on, and allow for much easier user configuration. The intent of Mini vMac was to create a "emulator collection" of many very optimized "variations" of the same codebase. I consider this much more trouble than it's worth, and intend to focus more on maintainability and accuracy.

µvMac is undergoing substansial and sporadic development and is unlikely to be in an usable state at this time.

Supported Platforms

µvMac absolutely requires SDL2. There are no plans to support platforms that SDL2 does not target. For 99% of users, this should not be a concern. Dropping support for esoteric platforms and exclusively using SDL2 vastly simplifies the complexity of the code.

So far µvMac has only been tested on Windows and Linux. No other operating systems are supported at this time.

Building

µvMac uses CMake 3.21+ and vcpkg.

  1. git submodule update --init --recursive
  2. Install CMake and a suitable C compiler. Windows users can use Visual Studio. Ubuntu users may need to use the Kitware APT repo.
  3. Run cmake -B [build directory] -S . --preset=debug (or open the project your IDE). Note that on Linux the configuration may fail due to missing system packages. Install those as needed.
  4. Enter your build directory and run ninja to build
  5. Acquire a Macintosh Plus ROM and a system disk and place it in the build directory, named vMac.ROM
  6. Start the application and drag the system disk to the window.

You can redistribute µvMac and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation. See the included file COPYING.txt

µvMac is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the license for more details.