Skip to content

Commit

Permalink
Updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
arindas committed Jul 6, 2022
1 parent 78a4d48 commit 0bf745e
Showing 1 changed file with 15 additions and 11 deletions.
26 changes: 15 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# mac-on-linux-with-qemu
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
![screenshot](./assets/screenshot.png)

Runs macOS on linux with qemu.
[![License: MIT](https://img.shields.io/github/license/arindas/mac-on-linux-with-qemu)](https://opensource.org/licenses/MIT)
![Repo size](https://img.shields.io/github/repo-size/arindas/mac-on-linux-with-qemu)

![screenshot](./assets/screenshot.png)
Runs macOS on linux with qemu.

## Pre-requisites
## Dependencies

- `qemu-system-x86_64`
- `dmg2img`
Expand All @@ -14,15 +15,15 @@ Runs macOS on linux with qemu.

## Usage

After cloning the repository, simply run `./run.sh`
After cloning the repository, simply run [`./run.sh`](./run.sh)

## How it works
## How does it work?

- [x] `./fetch-macos.py` fetches macOS image dmg from their software update centre
- [x] The downloaded .dmg image is converted to .img using the `dmg2img` utility
- [x] We create a virtual disk image using `./create-virtual-disk.sh`
- [x] We install macOS to qemu using the given image. `./install-macos.sh`
- [x] We provide a custom launcher script to launch qemu with the correct settings. `./launch-macos.sh`
- [`./fetch-macos.py`](./fetch-macos.py) fetches macOS image dmg from their software update centre
- The downloaded .dmg image is converted to .img using the `dmg2img` utility
- We create a virtual disk image using [`./create-virtual-disk.sh`](./create-virtual-disk.sh)
- We install macOS to qemu using the given image. [`./install-macos.sh`](./install-macos.sh)
- We provide a custom launcher script to launch qemu with the correct settings. [`./launch-macos.sh`](./launch-macos.sh)

## Closed issues solving relevant tasks
- [Xcode and usb iphone passthrough for ios App development](https://github.com/arindas/mac-on-linux-with-qemu/issues/25)
Expand All @@ -33,3 +34,6 @@ After cloning the repository, simply run `./run.sh`

## References
- https://github.com/popey/sosumi-snap

## License
This repository is licensed under the MIT License. See [LICENSE](./LICENSE) for the full license text.

0 comments on commit 0bf745e

Please sign in to comment.