oSoWoSo/DistroHopper
1
0
Fork 0
mirror of https://github.com/oSoWoSo/DistroHopper.git synced 2024-08-14 22:46:53 +00:00
Code Issues Projects Releases Packages Wiki Activity

Update README

Browse source
This commit is contained in:
Martin Wimpress 2021-09-28 15:56:24 +01:00
parent c755e10405
commit 00737a641a
No known key found for this signature in database
GPG key ID: 61DF940515E06DA3
1 changed files with 34 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

65
README.md
View file

@ -27,23 +27,18 @@ We have a Discord for this project: [![Discord](https://img.shields.io/discord/7
## Requirements ## Requirements
Essential requirements:
* [QEMU](https://www.qemu.org/) 6.0.0 or newer * [QEMU](https://www.qemu.org/) 6.0.0 or newer
* [Coreutils](https://www.gnu.org/software/coreutils/) * [Coreutils](https://www.gnu.org/software/coreutils/)
* [jq](https://stedolan.github.io/jq/) * [jq](https://stedolan.github.io/jq/)
* [procps](https://gitlab.com/procps-ng/procps) * [procps](https://gitlab.com/procps-ng/procps)
* `python3` to run [macrecovery.py](https://github.com/acidanthera/OpenCorePkg/tree/master/Utilities/macrecovery); provided by `python3-minimal` in Debian/Ubuntu
* `rot13` to *"decrypt"* the macOS OSK key; provided by `bsdgames` in Debian/Ubuntu
* [usbutils](https://github.com/gregkh/usbutils) * [usbutils](https://github.com/gregkh/usbutils)
* [Spicy]() `spicy` to connect to VMs via the SPICE protocol; provided by `spice-client-gtk` in Debian/Ubuntu
* [Wget](https://www.gnu.org/software/wget/) * [Wget](https://www.gnu.org/software/wget/)
* [xrandr](https://gitlab.freedesktop.org/xorg/app/xrandr) * [xrandr](https://gitlab.freedesktop.org/xorg/app/xrandr)
* [zsync](http://zsync.moria.org.uk/) * [zsync](http://zsync.moria.org.uk/)
Optional requirements:
* `python3` to run [macrecovery.py](https://github.com/acidanthera/OpenCorePkg/tree/master/Utilities/macrecovery) to download macOS recovery images; provided by `python3-minimal` in Debian/Ubuntu
* `rot13` to *"decrypt"* the macOS OSK key; provided by `bsdgames` in Debian/Ubuntu
* `spicy` to connect to VMs via the SPICE protocol; provided by `spice-client-gtk` in Debian/Ubuntu
# Install Quickemu # Install Quickemu
## Ubuntu ## Ubuntu
@ -115,8 +110,8 @@ preferred flavour.
```bash ```bash
guest_os="linux" guest_os="linux"
disk_img="${HOME}/Quickemu/debian-bullseye/disk.qcow2" disk_img="debian-bullseye/disk.qcow2"
iso="${HOME}/Quickemu/debian-bullseye/firmware-11.0.0-amd64-DVD-1.iso" iso="debian-bullseye/firmware-11.0.0-amd64-DVD-1.iso"
``` ```
* Use `quickemu` to start the virtual machine: * Use `quickemu` to start the virtual machine:
@ -142,7 +137,8 @@ quickemu --vm macos-catalina.conf
macOS `high-sierra`, `mojave`, `catalina` and `big-sur` are supported. macOS `high-sierra`, `mojave`, `catalina` and `big-sur` are supported.
* Use cursor keys to select the Hard Disk icon * Use cursor keys and enter key to select the **macOS Base System**
* From **macOS Utilities**
* Click **Disk Utility** and **Continue** * Click **Disk Utility** and **Continue**
* On macOS Catalina and Big Sur * On macOS Catalina and Big Sur
* Select `Apple Inc. VirtIO Block Media` from the list and click **Erase**. * Select `Apple Inc. VirtIO Block Media` from the list and click **Erase**.
@ -151,15 +147,18 @@ macOS `high-sierra`, `mojave`, `catalina` and `big-sur` are supported.
* Enter a `Name:` for the disk and click **Erase**. * Enter a `Name:` for the disk and click **Erase**.
* Click **Done**. * Click **Done**.
* Close Disk Utility * Close Disk Utility
* From **macOS Utilities**
* Click **Reinstall macOS** and **Continue** * Click **Reinstall macOS** and **Continue**
* Complete the installation as you normally would. * Complete the installation as you normally would.
* On the first reboot use cursor keys and enter key to select **macOS Installer**
* On the subsequent reboots use cursor keys and enter key to select the disk you named
The default macOS configuration looks like this: The default macOS configuration looks like this:
```bash ```bash
guest_os="macos" guest_os="macos"
disk_img="${HOME}/Quickemu/macos-big-sur/RecoveryImage.img" img="macos-big-sur/RecoveryImage.img"
iso="${HOME}/Quickemu/macos-big-sur/disk.qcow2" disk_img="macos-big-sur/disk.qcow2"
``` ```
* The `guest_os="macos"` line instructs Quickemu to optimise for macOS. * The `guest_os="macos"` line instructs Quickemu to optimise for macOS.
@ -180,13 +179,15 @@ There are some considerations when running macOS via Quickemu.
* Optimised by default * Optimised by default
* Host CPU vendor is detected and guest CPU configuration is optimised accordingly. * Host CPU vendor is detected and guest CPU configuration is optimised accordingly.
* [VirtIO block device](https://www.kraxel.org/blog/2019/06/macos-qemu-guest/) is used for the system disk where supported. * [VirtIO block device](https://www.kraxel.org/blog/2019/06/macos-qemu-guest/) is used for the system disk where supported.
* [VirtIO `usb-tablet`](http://philjordan.eu/osx-virt/) is used for the mouse (*available since macOS El Capitan*). * [VirtIO `usb-tablet`](http://philjordan.eu/osx-virt/) is used for the mouse.
* `vmxnet3` network device is used (*available since macOS El Capitan*). * `vmxnet3` network device is used.
* USB host pass-through is limited to UHCI (USB 2.0) * USB host pass-through is limited to UHCI (USB 2.0)
* Not supported on macOS: * Display resolution can only be changed via macOS System Preferences.
* Copy/paste between the guest and host via SPICE agent. * **SPICE has limited supported on macOS**:
* File sharing between the guest and host via SPICE webdavd. * Copy/paste via SPICE agent is not available.
* USB passthrough via SPICE. * File sharing via SPICE webdavd is not available.
* USB passthrough via SPICE is not available.
* Smartcard passthrough is not available.
## Windows 10 Guest ## Windows 10 Guest
@ -205,9 +206,12 @@ quickemu --vm windows-10.conf
* The disk will now be available for partitioning and formatting. * The disk will now be available for partitioning and formatting.
* Complete the installation as you normally would. * Complete the installation as you normally would.
* Post-install: * Post-install:
* Run the VirtIO installer from the CD-ROM: drive. * Run the VirtIO installer (`virtio-win-gt-x64`) from the CD Drive (E:).
* Install [spice-webdavd](https://www.spice-space.org/download/windows/spice-webdavd/) * Run the Guest Tools installer (`virtio-win-guest-tools`) from the CD Drive (E:).
* Install [UsbDk](https://www.spice-space.org/download/windows/usbdk/) * Download and install [spice-webdavd](https://www.spice-space.org/download/windows/spice-webdavd/spice-webdavd-x64-latest.msi)
* Enables file sharing between the host and guest.
* Download and install [UsbDk](https://www.spice-space.org/download/windows/usbdk/)
* Enables USB SPICE passthrough between the host and guest.
### Regional versions ### Regional versions
@ -222,9 +226,9 @@ The default Windows 10 configuration looks like this:
```bash ```bash
guest_os="windows" guest_os="windows"
disk_img="${HOME}/Quickemu/windows-10/disk.qcow2" disk_img="windows-10/disk.qcow2"
iso="${HOME}/Quickemu/windows-10/Win10_21H1_English_x64.iso" iso="windows-10/Win10_21H1_English_x64.iso"
driver_iso="${HOME}/Quickemu/windows-10/virtio-win.iso" driver_iso="windows-10/virtio-win.iso"
``` ```
* The `guest_os="windows"` line instructs `quickemu` to optimise for Windows. * The `guest_os="windows"` line instructs `quickemu` to optimise for Windows.
@ -232,11 +236,11 @@ driver_iso="${HOME}/Quickemu/windows-10/virtio-win.iso"
# SPICE # SPICE
The following features are only available while using the SPICE protocol: The following features are available while using the SPICE protocol:
* Copy/paste between the guest and host *(not available for macOS guests)* * Copy/paste between the guest and host
* Host file sharing to the guest *(not available for macOS guests)* * Host file sharing to the guest
* USB device redirection *(untested on macOS)* * USB device redirection
To use SPICE add `--display spice` to the Quickemu invocation, this requires that To use SPICE add `--display spice` to the Quickemu invocation, this requires that
the `spicy` client is installed, available from the `spice-client-gtk` package the `spicy` client is installed, available from the `spice-client-gtk` package
@ -343,8 +347,6 @@ quickemu --vm ubuntu-focal-desktop.conf --shortcut
## Screen and window size ## Screen and window size
<ins>Note about screen and window size</ins>
`qemu` will always default to the primary monitor to display the VM's window. `qemu` will always default to the primary monitor to display the VM's window.
Without the `--screen` option, `quickemu` will look for the size of the smallest Without the `--screen` option, `quickemu` will look for the size of the smallest
@ -409,6 +411,7 @@ Useful reference that assisted the development of Quickemu.
* <https://www.nicksherlock.com/2017/10/passthrough-of-advanced-cpu-features-for-macos-high-sierra-guests/> * <https://www.nicksherlock.com/2017/10/passthrough-of-advanced-cpu-features-for-macos-high-sierra-guests/>
* <http://philjordan.eu/osx-virt/> * <http://philjordan.eu/osx-virt/>
* <https://github.com/Dids/clover-builder> * <https://github.com/Dids/clover-builder>
* [OpenCore Configurator](https://mackie100projects.altervista.org).
* Windows * Windows
* <https://www.heiko-sieger.info/running-windows-10-on-linux-using-kvm-with-vga-passthrough/> * <https://www.heiko-sieger.info/running-windows-10-on-linux-using-kvm-with-vga-passthrough/>
* <https://leduccc.medium.com/improving-the-performance-of-a-windows-10-guest-on-qemu-a5b3f54d9cf5> * <https://leduccc.medium.com/improving-the-performance-of-a-windows-10-guest-on-qemu-a5b3f54d9cf5>