merged refactoring effects and upstream
This commit is contained in:
parent
75ce1dc424
commit
2390771994
128
README.md
128
README.md
@ -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'
|
||||||
|
Loading…
Reference in New Issue
Block a user