{"id":13511521,"url":"https://github.com/zydeco/minivmac4ios","last_synced_at":"2025-05-15T17:01:32.988Z","repository":{"id":45899902,"uuid":"59421334","full_name":"zydeco/minivmac4ios","owner":"zydeco","description":"Mini vMac for iOS","archived":false,"fork":false,"pushed_at":"2025-02-17T10:37:04.000Z","size":1194,"stargazers_count":565,"open_issues_count":7,"forks_count":54,"subscribers_count":35,"default_branch":"main","last_synced_at":"2025-04-01T01:39:16.909Z","etag":null,"topics":["emulator","ios","m68k","macintosh","mini-vmac"],"latest_commit_sha":null,"homepage":"https://namedfork.net/minivmac","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zydeco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-05-22T16:05:58.000Z","updated_at":"2025-03-30T13:48:26.000Z","dependencies_parsed_at":"2024-04-11T18:46:25.847Z","dependency_job_id":"782486bb-16c3-44d4-9fb7-bd34e1a86b9c","html_url":"https://github.com/zydeco/minivmac4ios","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zydeco%2Fminivmac4ios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zydeco%2Fminivmac4ios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zydeco%2Fminivmac4ios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zydeco%2Fminivmac4ios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zydeco","download_url":"https://codeload.github.com/zydeco/minivmac4ios/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247765330,"owners_count":20992285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emulator","ios","m68k","macintosh","mini-vmac"],"created_at":"2024-08-01T03:00:53.486Z","updated_at":"2025-04-08T02:35:31.407Z","avatar_url":"https://github.com/zydeco.png","language":"C","funding_links":[],"categories":["C","Emulator"],"sub_categories":["Terminal"],"readme":"# Mini vMac for iOS\n\n## Features\n\n* Emulates Mac Plus, Mac II or Mac 128K\n* Full simulated keyboard (including all Mac keys)\n* Full sound output\n* Uses external keyboard and mouse/trackpad if available\n* Regulable emulation speed\n* Easy(ish) to import/export disk images\n\n## Requirements\n\n* iOS/iPadOS 13.4 or later, or visionOS\n    * Previous versions support down to iOS 7\n* ROM image from Mac Plus, Mac II and/or Mac 128K\n* Disk images with Mac software\n\n## Usage\n\n### ROM and Disk Images\n\nYou can import the ROM (`vMac.ROM`) and disk images (with `.dsk` or `.img`\nextension) into Mini vMac from other apps (iCloud Storage, Dropbox, etc), using\nAirDrop, iTunes File Sharing or the iOS Files app.\n\n* To insert disk images, swipe left with two fingers and the list of disks will\n    appear. Icons are automatically generated based on the contents of the disk.\n* Tap an hold on a file to delete, rename or share\n* Tap the Edit button to show all files, and the Create Disk Image option\n\nThe disk image menu will attempt to find an icon from the following sources (in\ndescending order of priority):\n\n1. Volume icon (System 7)\n2. Application icon, if the disk contains only one application\n3. Application matching the name of the volume (not the disk image)\n4. Application with name written in the comment field of the volume\n\nIf no icon is found, it will show a standard floppy disk icon.\n\n### Keyboard\n\nSwipe up with two fingers to show the keyboard, and down to hide it.\n\nThe emulated keyboard features all the keys on an Apple Extended keyboard\n(except the Power key). The Command, Option, Control and Shift keys are\nsticky, to make keyboard shortcuts easier to type. You can change the\nappearance of the emulated keyboard in the settings.\n\nIf you have an external keyboard attached, you can use it too, although some\nshortcuts may interfere with iOS.\n\n### Mouse\n\nYou can choose to use the screen as a touchscreen, where tapping on the screen\nacts a mouse click, or as a trackpad. In trackpad mode, dragging is done by\ntapping twice fast and holding it down. 3D touch can also be used for clicking and\ndragging on supported devices.\n\nIf you use a mouse or trackpad on iPad OS 13.4 or newer, it will be used automatically.\n\n### Settings\n\nSwipe right with two fingers to show the settings dialog, where you can change\nthe following:\n\n* **Speed:** make the emulated machine faster than a Mac Plus\n* **Mouse Type:** switch between touchscreen and trackpad mode\n* **Keyboard Layout:** change the layout of the emulated keyboard\n* **Display Scaling:** choose how to scale the display\n* **Emulated Machine:** changes won't take effect if there are disks inserted\n\n## Installation\n\nThe easiest way is to install an IPA from [releases](https://github.com/zydeco/minivmac4ios/releases) with [AltStore](https://altstore.io).\n\n### Building from source\n\nTo build the project, make sure you check out the repository and submodules:\n\n```\ngit clone https://github.com/zydeco/minivmac4ios.git\ncd minivmac4ios\ngit submodule update --init --recursive\n```\n\nThe folders `minivmac`, `libmfs` and `libres` should not be empty. The source code zip file you can download from GitHub does not include all dependencies.\n\nTo install run the app on your device with Xcode, you'll to perform some [additoinal steps](https://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device):\n\n* Pair the device with Xcode\n* Specify your Apple ID in the Account preferences in Xcode.\n* Change the Team (to your own) and Bundle Identifier (for example, change the `net.namedfork` prefix to your own) in the “Mini vMac” target, under the “Signing \u0026 Capabilities” tab.\n* Enable [Developer Mode](https://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device) on your device (iOS 16 and later).\n* On older iOS versions, trust your developer profile in the iOS Settings (under General \u003e Device Management) after installing the app for the first time.\n\n## Adding new emulated machines\n\nSee documentation [on the wiki](https://github.com/zydeco/minivmac4ios/wiki/Adding-a-new-emulated-machine).\n\n## Credits\n\n* Mini vMac for iOS by [Jesús A. Álvarez](https://github.com/zydeco)\n* [Mini vMac](http://gryphel.com/c/minivmac/) ©2001-2021 Paul C. Pratt\n* [vMac](http://vmac.org/) ©1996-1999 Philip Cummins \u0026 al.\n* [hfsutils](http://www.mars.org/home/rob/proj/hfs/) ©1996-2000 Robert Leslie\n* [libmfs](https://github.com/zydeco/libmfs) and [libres](https://github.com/zydeco/libres) by [Jesús A. Álvarez](https://github.com/zydeco)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzydeco%2Fminivmac4ios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzydeco%2Fminivmac4ios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzydeco%2Fminivmac4ios/lists"}