|
|
@ -17,8 +17,8 @@ operating system you want to run and Quickemu will figure out the best |
|
|
|
way to do it for you. For example: |
|
|
|
way to do it for you. For example: |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
quickget ubuntu-mate impish |
|
|
|
quickget ubuntu-mate 21.10 |
|
|
|
quickemu --vm ubuntu-mate-impish.conf |
|
|
|
quickemu --vm ubuntu-mate-21.10-.conf |
|
|
|
``` |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
The original objective of the project was to enable quick testing of |
|
|
|
The original objective of the project was to enable quick testing of |
|
|
@ -33,13 +33,17 @@ Features |
|
|
|
|
|
|
|
|
|
|
|
- **macOS** Monterey, Big Sur, Catalina, Mojave & High Sierra |
|
|
|
- **macOS** Monterey, Big Sur, Catalina, Mojave & High Sierra |
|
|
|
- **Windows** 8.1, 10 and 11 including TPM 2.0 |
|
|
|
- **Windows** 8.1, 10 and 11 including TPM 2.0 |
|
|
|
- [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu flavours](https://ubuntu.com/download/flavours)** |
|
|
|
- [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu |
|
|
|
|
|
|
|
flavours](https://ubuntu.com/download/flavours)** |
|
|
|
- **Over 360 operating system editions are supported!** |
|
|
|
- **Over 360 operating system editions are supported!** |
|
|
|
- Full SPICE support including host/guest clipboard sharing |
|
|
|
- Full SPICE support including host/guest clipboard sharing |
|
|
|
- VirtIO-webdavd file sharing for Linux and Windows guests |
|
|
|
- VirtIO-webdavd file sharing for Linux and Windows guests |
|
|
|
- VirtIO-9p file sharing for Linux and macOS guests |
|
|
|
- VirtIO-9p file sharing for Linux and macOS guests |
|
|
|
- [QEMU Guest Agent support](https://wiki.qemu.org/Features/GuestAgent); provides access to a system-level agent via standard QMP commands |
|
|
|
- [QEMU Guest Agent |
|
|
|
- Samba file sharing for Linux, macOS and Windows guests (*if `smbd` is installed on the host*) |
|
|
|
support](https://wiki.qemu.org/Features/GuestAgent); provides access |
|
|
|
|
|
|
|
to a system-level agent via standard QMP commands |
|
|
|
|
|
|
|
- Samba file sharing for Linux, macOS and Windows guests (*if `smbd` |
|
|
|
|
|
|
|
is installed on the host*) |
|
|
|
- VirGL acceleration |
|
|
|
- VirGL acceleration |
|
|
|
- USB device pass-through |
|
|
|
- USB device pass-through |
|
|
|
- Smartcard pass-through |
|
|
|
- Smartcard pass-through |
|
|
@ -66,7 +70,8 @@ QEMU](https://img.youtube.com/vi/AOTYWEgw0hI/0.jpg)](https://www.youtube.com/wat |
|
|
|
Requirements |
|
|
|
Requirements |
|
|
|
------------ |
|
|
|
------------ |
|
|
|
|
|
|
|
|
|
|
|
- [QEMU](https://www.qemu.org/) (*6.0.0 or newer*) **with GTK, SDL, SPICE & VirtFS support** |
|
|
|
- [QEMU](https://www.qemu.org/) (*6.0.0 or newer*) **with GTK, SDL, |
|
|
|
|
|
|
|
SPICE & VirtFS support** |
|
|
|
- [bash](https://www.gnu.org/software/bash/) (*4.0 or newer*) |
|
|
|
- [bash](https://www.gnu.org/software/bash/) (*4.0 or newer*) |
|
|
|
- [Coreutils](https://www.gnu.org/software/coreutils/) |
|
|
|
- [Coreutils](https://www.gnu.org/software/coreutils/) |
|
|
|
- [EDK II](https://github.com/tianocore/edk2) |
|
|
|
- [EDK II](https://github.com/tianocore/edk2) |
|
|
@ -162,8 +167,8 @@ Ubuntu Guest |
|
|
|
virtual machine configuration. |
|
|
|
virtual machine configuration. |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
quickget ubuntu focal |
|
|
|
quickget ubuntu 20.04 |
|
|
|
quickemu --vm ubuntu-focal.conf |
|
|
|
quickemu --vm ubuntu-20.04.conf |
|
|
|
``` |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
- Complete the installation as normal. |
|
|
|
- Complete the installation as normal. |
|
|
@ -197,9 +202,9 @@ with your preferred flavour. |
|
|
|
- `kubuntu` (Kubuntu) |
|
|
|
- `kubuntu` (Kubuntu) |
|
|
|
- `lubuntu` (Lubuntu) |
|
|
|
- `lubuntu` (Lubuntu) |
|
|
|
- `ubuntu-budgie` (Ubuntu Budgie) |
|
|
|
- `ubuntu-budgie` (Ubuntu Budgie) |
|
|
|
- `ubuntu-kylin` (Ubuntu Kylin) |
|
|
|
- `ubuntukylin` (Ubuntu Kylin) |
|
|
|
- `ubuntu-mate` (Ubuntu MATE) |
|
|
|
- `ubuntu-mate` (Ubuntu MATE) |
|
|
|
- `ubuntu-studio` (Ubuntu Studio) |
|
|
|
- `ubuntustudio` (Ubuntu Studio) |
|
|
|
- `ubuntu` (Ubuntu) |
|
|
|
- `ubuntu` (Ubuntu) |
|
|
|
- `xubuntu` (Xubuntu) |
|
|
|
- `xubuntu` (Xubuntu) |
|
|
|
|
|
|
|
|
|
|
@ -216,11 +221,11 @@ Other Operating Systems |
|
|
|
- `cachyos` (CachyOS) |
|
|
|
- `cachyos` (CachyOS) |
|
|
|
- `debian` (Debian) |
|
|
|
- `debian` (Debian) |
|
|
|
- `devuan` (Devuan) |
|
|
|
- `devuan` (Devuan) |
|
|
|
- `dragonflybsd` (DragonFlyBSD) |
|
|
|
- `dragonflybsd` (DragonFlyBSD) |
|
|
|
- `elementary` (elementary OS) |
|
|
|
- `elementary` (elementary OS) |
|
|
|
- `fedora` (Fedora) |
|
|
|
- `fedora` (Fedora) |
|
|
|
- `freebsd` (FreeBSD) |
|
|
|
- `freebsd` (FreeBSD) |
|
|
|
- `freedos` (FreeDOS) |
|
|
|
- `freedos` (FreeDOS) |
|
|
|
- `garuda` (Garuda Linux) |
|
|
|
- `garuda` (Garuda Linux) |
|
|
|
- `gentoo` (Gentoo) |
|
|
|
- `gentoo` (Gentoo) |
|
|
|
- `ghostbsd` (GhostBSD) |
|
|
|
- `ghostbsd` (GhostBSD) |
|
|
@ -416,7 +421,7 @@ requires that the `spicy` client is installed, available from the |
|
|
|
`spice-client-gtk` package in Debian/Ubuntu. |
|
|
|
`spice-client-gtk` package in Debian/Ubuntu. |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
quickemu --vm ubuntu-focal.conf --display spice |
|
|
|
quickemu --vm ubuntu-20.04.conf --display spice |
|
|
|
``` |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
Headless |
|
|
|
Headless |
|
|
@ -428,14 +433,14 @@ available from the `spice-client-gtk` package in Debian/Ubuntu to |
|
|
|
connect to the running VM |
|
|
|
connect to the running VM |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
quickemu --vm ubuntu-focal.conf --display none |
|
|
|
quickemu --vm ubuntu-20.04.conf --display none |
|
|
|
``` |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
You can also use the `.ports` file in the VM directory to lookup what |
|
|
|
You can also use the `.ports` file in the VM directory to lookup what |
|
|
|
SSH and SPICE ports the VM is connected to. |
|
|
|
SSH and SPICE ports the VM is connected to. |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
cat ubuntu-focal/ubuntu-focal.ports |
|
|
|
cat ubuntu-20.04/ubuntu-20.04.ports |
|
|
|
``` |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
Accessibility |
|
|
|
Accessibility |
|
|
@ -445,13 +450,7 @@ Qemu provides support for using BrlAPI to display braille output on a |
|
|
|
real or fake device. |
|
|
|
real or fake device. |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
quickemu --vm ubuntu-impish.conf --accessibility braille --display sdl |
|
|
|
quickemu --vm ubuntu-21.10.conf --braille --display sdl |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
or even |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
|
|
|
|
quickemu --vm ubuntu-impish.conf --acc brl --display sdl |
|
|
|
|
|
|
|
``` |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
BIOS and EFI |
|
|
|
BIOS and EFI |
|
|
@ -616,7 +615,6 @@ Here are the usage instructions: |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Usage |
|
|
|
Usage |
|
|
|
quickemu --vm ubuntu.conf |
|
|
|
quickemu --vm ubuntu.conf |
|
|
|
|
|
|
|
|
|
|
@ -646,7 +644,7 @@ Desktop shortcuts can be created for a VM, the shortcuts are saved in |
|
|
|
shortcut. |
|
|
|
shortcut. |
|
|
|
|
|
|
|
|
|
|
|
``` {.bash} |
|
|
|
``` {.bash} |
|
|
|
quickemu --vm ubuntu-focal-desktop.conf --shortcut |
|
|
|
quickemu --vm ubuntu-20.04-desktop.conf --shortcut |
|
|
|
``` |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
Screen and window size (Linux guests only) |
|
|
|
Screen and window size (Linux guests only) |
|
|
|