Updated for commits direct to README

This commit is contained in:
Phil Clifford 2022-08-19 20:10:21 +01:00 committed by Martin Wimpress
parent d669c4ca2a
commit 8bb24f69c0
8 changed files with 228 additions and 90 deletions

View file

@ -1,6 +1,6 @@
---
author: Martin Wimpress
date: August 1, 2022
date: August 19, 2022
footer: quickemu
header: Quickemu User Manual
section: 1
@ -68,8 +68,8 @@ You can also pass optional parameters
# EXAMPLES
**quickemu --vm ubuntu-mate-22.04-.conf**
: Launches the VM specified in the file *ubuntu-mate-22.04-.conf*
**quickemu --vm ubuntu-mate-22.04.conf**
: Launches the VM specified in the file *ubuntu-mate-22.04.conf*
## Introduction
@ -80,7 +80,7 @@ way to do it for you. For example:
``` bash
quickget ubuntu-mate 22.04
quickemu --vm ubuntu-mate-22.04-.conf
quickemu --vm ubuntu-mate-22.04.conf
```
The original objective of the project was to enable quick testing of
@ -294,6 +294,7 @@ with your preferred flavour.
- `opensuse` (openSUSE)
- `oraclelinux` (Oracle Linux)
- `popos` (Pop!\_OS)
- `reactos` (ReactOS)
- `regolith` (Regolith Linux)
- `rockylinux` (Rocky Linux)
- `slackware` (Slackware)
@ -406,13 +407,34 @@ There are some considerations when running macOS via Quickemu.
- UHCI (USB 2.0) on macOS Catalina and earlier.
- XHCI (USB 3.0) on macOS Big Sur and newer.
- Display resolution can only be changed via macOS System Preferences.
- Full Duplex audio works on macOS High Sierra, Mojave and Catalina.
- **macOS Big Sur and Monterey have no audio at all**.
- **Full Duplex audio requires [VoodooHDA
OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB
audio-device to the macOS guest VM**.
- NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and
[System Integrity Protection
(SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection)
need to be disabled to install VoodooHDA OC
- File sharing between guest and host is available via
[virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE
webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
- Copy/paste via SPICE agent is **not available on macOS**.
### macOS App Store
If you see *"Your device or computer could not be verified"* when you
try to login to the App Store, make sure that your wired ethernet device
is `en0`. Use `ifconfig` in a terminal to verify this.
If the wired ethernet device is not `en0`, then then go to *System
Preferences* -\> *Network*, delete all the network devices and apply the
changes. Next, open a terminal and run the following:
``` bash
sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist
```
Now reboot, and the App Store should work.
## Windows 8.1, 10 & 11 Guests
`quickget` can automatically download Windows 8.1, [Windows
@ -466,7 +488,6 @@ secureboot="on"
Here are the usage instructions:
Usage
quickemu --vm ubuntu.conf
@ -502,8 +523,6 @@ Here are the usage instructions:
--extra_args <arguments> : Pass additional arguments to qemu
--version : Print version
## Desktop shortcuts
Desktop shortcuts can be created for a VM, the shortcuts are saved in