From cc5902700862c8519a07cc9a6d33c9616bb408db Mon Sep 17 00:00:00 2001 From: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com> Date: Sun, 21 Jan 2024 04:05:51 -0300 Subject: [PATCH] quick{emu,get}: add page (#12029) * quick{emu,get}: add pages * quick{emu,get}: apply suggestions from code review Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * quickget: fix wording Co-authored-by: Juri Dispan * quick{emu,get}: apply suggestions from code review Co-authored-by: K.B.Dharun Krishna * quickemu: enclose "sdl" with backticks Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> * Update pages/linux/quickemu.md Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com> --------- Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com> Co-authored-by: Juri Dispan Co-authored-by: K.B.Dharun Krishna Co-authored-by: Jack Lin --- pages/linux/quickemu.md | 33 +++++++++++++++++++++++++++++++++ pages/linux/quickget.md | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 67 insertions(+) create mode 100644 pages/linux/quickemu.md create mode 100644 pages/linux/quickget.md diff --git a/pages/linux/quickemu.md b/pages/linux/quickemu.md new file mode 100644 index 000000000..cc90c1b7a --- /dev/null +++ b/pages/linux/quickemu.md @@ -0,0 +1,33 @@ +# quickemu + +> Build and manage highly optimised desktop virtual machines quickly. +> See also: `quickget`, for preparing VM configurations. +> More information: . + +- Create and run a virtual machine from a configuration file: + +`quickemu --vm {{path/to/file.conf}}` + +- Do not commit any changes to disk/snapshot but write any changes to temporary files: + +`quickemu --status-quo --vm {{path/to/file.conf}}` + +- Start the virtual machine in full-screen mode ( + + f to exit) and select the display backend (`sdl` by default): + +`quickemu --fullscreen --display {{sdl|gtk|spice|spice-app|none}} --vm {{path/to/file.conf}}` + +- Select a virtual audio device to emulate and create a desktop shortcut: + +`quickemu --sound-card {{intel-hda|ac97|es1370|sb16|none}} --shortcut --vm {{path/to/file.conf}}` + +- Create a snapshot: + +`quickemu --snapshot create {{tag}} --vm {{path/to/file.conf}}` + +- Restore a snapshot: + +`quickemu --snapshot apply {{tag}} --vm {{path/to/file.conf}}` + +- Delete a snapshot: + +`quickemu --snapshot delete {{tag}} --vm {{path/to/file.conf}}` diff --git a/pages/linux/quickget.md b/pages/linux/quickget.md new file mode 100644 index 000000000..49fc9d07a --- /dev/null +++ b/pages/linux/quickget.md @@ -0,0 +1,34 @@ +# quickget + +> Download and prepare materials for building a Quickemu virtual machine. +> NOTE: the parameter "edition" is always optional. +> See also: `quickemu`. +> More information: . + +- Display the list of all supported guest operating systems, versions and variants: + +`quickget list` + +- Download and create the virtual machine configuration for building a Quickemu virtual machine for an OS: + +`quickget {{os}} {{release}} {{edition}}` + +- Download configuration for a Windows 11 VM with VirtIO drivers for Windows: + +`quickget windows 11` + +- Download a macOS recovery image and creates a virtual machine configuration: + +`quickget macos {{high-sierra|mojave|catalina|big-sur|monterey|ventura}}` + +- Show an ISO URL for an operating system (Note: it does not work for Windows): + +`quickget --show-iso-url fedora {{release}} {{edition}}` + +- Test if an ISO file is available for an operating system: + +`quickget --test-iso-url nixos {{edition}} {{plasma5}}` + +- Open an operating system distribution's homepage in a browser (Note: it does not work for Windows): + +`quickget --open-distro-homepage {{os}}`