merged refactoring effects and upstream

This commit is contained in:
Phil Clifford 2022-02-24 01:35:39 +00:00
parent 75ce1dc424
commit 2390771994

128
README.md
View File

@ -32,27 +32,10 @@ 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 - [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu
flavours](https://ubuntu.com/download/flavours)** flavours](https://ubuntu.com/download/flavours)**
- [Fedora](https://getfedora.org/) & openSUSE - **Over 360 operating system editions are supported!**
([Leap](https://get.opensuse.org/leap/),
[Tumbleweed](https://get.opensuse.org/tumbleweed/),
[MicroOS](https://microos.opensuse.org/))
- [Linux Mint](https://linuxmint.com/) (Cinnamon, MATE, and XFCE),
[elementary OS](https://elementary.io/),
[Pop!\_OS](https://pop.system76.com/)
- [Arch Linux](https://www.archlinux.org/),
[Kali](https://www.kali.org/),[Garuda](https://garudalinux.org/),
[ZorinOS](https://zorin.com/os/) & [NixOS](https://nixos.org/)
- [Regolith Linux](https://regolith-linux.org/) (Release 1.6 and
latest 2.0.0 pre-release )
- [FreeBSD](https://www.freebsd.org/) &
[OpenBSD](https://www.openbsd.org/)
- 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
@ -67,6 +50,7 @@ Features
- Automatic SSH port forwarding to guests - Automatic SSH port forwarding to guests
- Network port forwarding - Network port forwarding
- Full duplex audio - Full duplex audio
- Braille support
- EFI (with or without SecureBoot) and Legacy BIOS boot - EFI (with or without SecureBoot) and Legacy BIOS boot
- Graphical user interfaces available - Graphical user interfaces available
@ -217,65 +201,54 @@ 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)
Other Linux Guests Other Operating Systems
------------------ -----------------------
`quickget` also supports: `quickget` also supports:
- `alma` (Alma Linux) - `alma` (Alma Linux)
- `alpine` (Alpine Linux) - `alpine` (Alpine Linux)
- `android` (Android x86)
- `archlinux` (Arch Linux) - `archlinux` (Arch Linux)
- `arcolinux` (Arco Linux) - `arcolinux` (Arco Linux)
- `cachyos` (CachyOS) - `cachyos` (CachyOS)
- `debian` (Debian) - `debian` (Debian)
- `devuan` (Devuan)
- `dragonflybsd` (DragonFlyBSD)
- `elementary` (elementary OS) - `elementary` (elementary OS)
- `fedora` (Fedora) - `fedora` (Fedora)
- `freebsd` (FreeBSD)
- `garuda` (Garuda Linux) - `garuda` (Garuda Linux)
- `gentoo` (Gentoo) - `gentoo` (Gentoo)
- `ghostbsd` (GhostBSD)
- `haiku` (Haiku) - `haiku` (Haiku)
- `kali` (Kali) - `kali` (Kali)
- `kdeneon` (KDE Neon) - `kdeneon` (KDE Neon)
- `kolibrios` (KolibriOS) - `kolibrios` (KolibriOS)
- `linuxmint-cinnamon` (Linux Mint Cinnamon) - `linuxmint` (Linux Mint)
- `linuxmint-mate` (Linux Mint MATE) - `manjaro` (Manjaro)
- `linuxmint-xfce` (Linux Mint XFCE) - `mxlinux` (MX Linux)
- `manjaro-budgie` (Manjaro Budgie) - `netboot` (netboot.xyz)
- `manjaro-cinnamon` (Manjaro Cinnamon) - `netbsd` (NetBSD)
- `manjaro-deepin` (Manjaro Deepin) - `nixos` (NixOS)
- `manjaro-gnome` (Manjaro Gnome) - `openbsd` (OpenBSD)
- `manjaro-i3` (Manjaro i3)
- `manjaro-kde` (Manjaro KDE)
- `manjaro-mate` (Manjaro MATE)
- `manjaro-xfce` (Manjaro XFCE)
- `mxlinux-fluxbox` (MX Linux Fluxbox)
- `mxlinux-kde` (MX Linux KDE)
- `mxlinux-xfce` (MX Linux XFCE)
- `nixos-gnome` (NixOS Gnome)
- `nixos-minimal` (NixOS Minimal)
- `nixos-plasma5` (NixOS KDE)
- `opensuse` (openSUSE) - `opensuse` (openSUSE)
- `oraclelinux` (Oracle Linux) - `oraclelinux` (Oracle Linux)
- `popos` (Pop!\_OS) - `popos` (Pop!\_OS)
- `regolith` (Regolith Linux) - `regolith` (Regolith Linux)
- `rockylinux` (Rocky Linux) - `rockylinux` (Rocky Linux)
- `slackware` (Slackware)
- `solus` (Solus) - `solus` (Solus)
- `tails` (Tails) - `tails` (Tails)
- `void` (Void Linux) - `void` (Void Linux)
- `zorin` (Zorin OS) - `zorin` (Zorin OS)
### BSD Guest Support
`quickget` also supports:
- `freebsd` (FreeBSD)
- `openbsd` (OpenBSD)
Or you can download a Linux image and manually create a VM Or you can download a Linux image and manually create a VM
configuration. configuration.
@ -288,19 +261,6 @@ disk_img="debian-bullseye/disk.qcow2"
iso="debian-bullseye/firmware-11.0.0-amd64-DVD-1.iso" iso="debian-bullseye/firmware-11.0.0-amd64-DVD-1.iso"
``` ```
If you already have a collection of ISOs downloaded you can have
`quickget` find and copy your existing file into the VM directory.
``` {.text}
--isodir : base path beneath which to find local ISO copy
if a matching file is found it will be copied to the VM directory
--localiso : optional local ISO filename - defaults to target filename
```
`quickget` will then continue to `wget` or `zsync` using that file as a
prior copy. If the target file exists in the VM directory `quickget`
will raise an error if you run it with `--isodir`
- Use `quickemu` to start the virtual machine: - Use `quickemu` to start the virtual machine:
``` {.bash} ``` {.bash}
@ -445,45 +405,6 @@ tpm="on"
- `tpm="on"` instructs `quickemu` to create a software emulated TPM - `tpm="on"` instructs `quickemu` to create a software emulated TPM
device using `swtpm`. device using `swtpm`.
BSD Guests
----------
`quickemu` supports FreeBSD and OpenBSD.
``` {.bash}
quickget freebsd 13_0
quickemu --vm freebsd-13_0.conf
```
Other Guests
------------
- `android` (Android x86)
Haiku Guests
------------
`quickemu` supports [Haiku](https://www.haiku-os.org/).
``` {.bash}
quickget quickget haiku r1beta3-x86_64
quickemu --vm haiku-r1beta3-x86_64.conf
```
At the moment the only way to share files between host and a Haiku guest
is by using SSH (having a SSH server running on the host):
On guest:
``` {.bash}
scp example.txt user@host-local-ip:/home/user # sending a file from guest to host
scp user@host-local-ip:/home/user/example.txt . # receiving a file from host to guest
```
`quickget` cannot automatically download and create virtual machines for
Haiku nightly versions, but they work if the ISO and configuration are
set up manually.
SPICE SPICE
===== =====
@ -527,13 +448,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-impish.conf --braille --display sdl
```
or even
``` {.bash}
quickemu --vm ubuntu-impish.conf --acc brl --display sdl
``` ```
BIOS and EFI BIOS and EFI
@ -698,12 +613,11 @@ Here are the usage instructions:
``` {.bash} ``` {.bash}
Usage Usage
quickemu --vm ubuntu.conf quickemu --vm ubuntu.conf
You can also pass optional parameters You can also pass optional parameters
--accessible : Select accessible facilitation. 'braille' (default - currently requires --display sdl ) --braille : Enable braille support. Requires SDL.
--delete-disk : Delete the disk image and EFI variables --delete-disk : Delete the disk image and EFI variables
--delete-vm : Delete the entire VM and it's configuration --delete-vm : Delete the entire VM and it's configuration
--display : Select display backend. 'sdl' (default), 'gtk', 'none', or 'spice' --display : Select display backend. 'sdl' (default), 'gtk', 'none', or 'spice'