mirror of
				https://github.com/oSoWoSo/DistroHopper.git
				synced 2024-08-14 22:46:53 +00:00 
			
		
		
		
	Update README.md
This commit is contained in:
		
							parent
							
								
									1b4ef8fac8
								
							
						
					
					
						commit
						e78cd81da3
					
				
					 1 changed files with 35 additions and 74 deletions
				
			
		
							
								
								
									
										109
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										109
									
								
								README.md
									
										
									
									
									
								
							|  | @ -1,24 +1,37 @@ | ||||||
| <h1 align="center"> |  | ||||||
|   <img src=".github/logo.png" alt="Quickemu" width="256" /> |  | ||||||
|   <br /> |  | ||||||
|   Quickemu |  | ||||||
| </h1> |  | ||||||
| 
 |  | ||||||
| <p align="center"><b>Quickly create and run optimised Windows, macOS and Linux desktop virtual machines.</b></p> |  | ||||||
| <div align="center"><img src=".github/screenshot.png" alt="Quickemu Screenshot" /></div> |  | ||||||
| <p align="center">Made with 💝 for <img src=".github/tux.png" align="top" width="18" /></p> | <p align="center">Made with 💝 for <img src=".github/tux.png" align="top" width="18" /></p> | ||||||
| 
 | 
 | ||||||
| ## Introduction | # This repository contains a multiple tools | ||||||
|  | Can be used together with quickemu | ||||||
|  | # Welcome  DistroHoppers | ||||||
|  | ## I made some user interfaces for quickemu... | ||||||
|  | 
 | ||||||
|  | 🦚 | ||||||
|  | [dh](https://github.com/oSoWoSo/DistroHopper/raw/all/dh) GUI and TUI using yad | ||||||
|  | 
 | ||||||
|  | 🕊️ | ||||||
|  | [quickfzf](https://github.com/oSoWoSo/DistroHopper/raw/all/quickfzf) TUI using fzf | ||||||
|  | 
 | ||||||
|  | 🐲 | ||||||
|  | [quicktui](https://github.com/oSoWoSo/DistroHopper/raw/all/quicktui) TUI using gum (🚧 usable but under heavy development) | ||||||
|  | 
 | ||||||
|  | 🐅 | ||||||
|  | [qrun](https://github.com/oSoWoSo/DistroHopper/raw/all/qrun) TUI using gum | ||||||
|  | 
 | ||||||
|  | and | ||||||
|  | 
 | ||||||
|  | ## Extended version with more distros then upstream quickemu | ||||||
|  | [quickget extended](https://github.com/oSoWoSo/DistroHopper/tree/quickemu-extended)  | ||||||
|  | 
 | ||||||
|  | Enjoy... | ||||||
|  | 
 | ||||||
|  | [repo](https://github.com/oSoWoSo/DistroHopper/) | ||||||
|  | 
 | ||||||
|  | ## quickemu Introduction | ||||||
| 
 | 
 | ||||||
| Quickly create and run highly optimised desktop virtual machines for | Quickly create and run highly optimised desktop virtual machines for | ||||||
| Linux, macOS and Windows; with just two commands. You decide what | Linux, macOS and Windows; with different user interfaces to choose from. | ||||||
| operating system you want to run and Quickemu will figure out the best | You decide what operating system you want to run tool will figure out the best | ||||||
| way to do it for you. For example: | way to do it for you. | ||||||
| 
 |  | ||||||
| ``` bash |  | ||||||
| quickget ubuntu-mate 22.04 |  | ||||||
| quickemu --vm ubuntu-mate-22.04.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 | ||||||
| Linux distributions where the virtual machine configurations can be | Linux distributions where the virtual machine configurations can be | ||||||
|  | @ -56,15 +69,6 @@ Quickemu is a wrapper for the excellent [QEMU](https://www.qemu.org/) | ||||||
| that attempts to automatically *"do the right thing"*, rather than | that attempts to automatically *"do the right thing"*, rather than | ||||||
| expose exhaustive configuration options. | expose exhaustive configuration options. | ||||||
| 
 | 
 | ||||||
| We have a Discord for this project: |  | ||||||
| [](https://discord.gg/sNmz3uw) |  | ||||||
| 
 |  | ||||||
| See this (old) video where I explain some of my motivations for creating |  | ||||||
| Quickemu. |  | ||||||
| 
 |  | ||||||
| [](https://www.youtube.com/watch?v=AOTYWEgw0hI) |  | ||||||
| 
 |  | ||||||
| ## Requirements | ## Requirements | ||||||
| 
 | 
 | ||||||
| -   [QEMU](https://www.qemu.org/) (*6.0.0 or newer*) **with GTK, SDL, | -   [QEMU](https://www.qemu.org/) (*6.0.0 or newer*) **with GTK, SDL, | ||||||
|  | @ -130,10 +134,6 @@ graphical user interface is also available: | ||||||
|     Johnson](https://github.com/marxjohnson) and [Yannick |     Johnson](https://github.com/marxjohnson) and [Yannick | ||||||
|     Mauray](https://github.com/ymauray). |     Mauray](https://github.com/ymauray). | ||||||
| 
 | 
 | ||||||
| Many thanks to [Luke Wesley-Holley](https://github.com/Lukewh) and |  | ||||||
| [Philipp Kiemle](https://github.com/daPhipz) for creating the |  | ||||||
| **[Quickemu icons](https://github.com/Lukewh/quickemu-icons)** 🎨 |  | ||||||
| 
 |  | ||||||
| ### Quickgui for Ubuntu | ### Quickgui for Ubuntu | ||||||
| 
 | 
 | ||||||
| ``` bash | ``` bash | ||||||
|  | @ -208,11 +208,6 @@ status](https://repology.org/badge/vertical-allrepos/quickgui.svg)](https://repo | ||||||
| `quickget` will automatically download an Ubuntu release and create the | `quickget` will automatically download an Ubuntu release and create the | ||||||
| virtual machine configuration. | virtual machine configuration. | ||||||
| 
 | 
 | ||||||
| ``` bash |  | ||||||
| quickget ubuntu 22.04 |  | ||||||
| quickemu --vm ubuntu-22.04.conf |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| -   Complete the installation as normal. | -   Complete the installation as normal. | ||||||
| -   Post-install: | -   Post-install: | ||||||
|     -   Install the SPICE agent (`spice-vdagent`) in the guest to enable |     -   Install the SPICE agent (`spice-vdagent`) in the guest to enable | ||||||
|  | @ -227,11 +222,6 @@ quickemu --vm ubuntu-22.04.conf | ||||||
| `quickget` can also download/refresh devel images via `zsync` for Ubuntu | `quickget` can also download/refresh devel images via `zsync` for Ubuntu | ||||||
| developers and testers. | developers and testers. | ||||||
| 
 | 
 | ||||||
| ``` bash |  | ||||||
| quickget ubuntu devel |  | ||||||
| quickemu --vm ubuntu-devel.conf |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| You can run `quickget ubuntu devel` to refresh your daily development | You can run `quickget ubuntu devel` to refresh your daily development | ||||||
| image as often as you like, it will even automatically switch to a new | image as often as you like, it will even automatically switch to a new | ||||||
| series. | series. | ||||||
|  | @ -256,14 +246,9 @@ with your preferred flavour. | ||||||
| 
 | 
 | ||||||
| You can also use `quickget` with options to: | You can also use `quickget` with options to: | ||||||
| 
 | 
 | ||||||
| ``` shell |     # show an OS ISO download URL | ||||||
|     # show an OS ISO download URL for {os} {release} [edition]  |     # test if and OS ISO is available | ||||||
|     quickget --show-iso-url fedora 38 Silverblue    |  | ||||||
|     # test if and OS ISO is available for {os} {release} [edition] |  | ||||||
|     quickget --test-iso-url nixos 23.05 plasma5 |  | ||||||
|     # open an OS distribution homepage in a browser |     # open an OS distribution homepage in a browser | ||||||
|     quickget --open-distro-homepage  ubuntu-mate |  | ||||||
| ``` |  | ||||||
| 
 | 
 | ||||||
| The `--show-iso-url` and `--test-iso-url` options **do not** work for | The `--show-iso-url` and `--test-iso-url` options **do not** work for | ||||||
| `Windows` (`quickget` will begin downloading the requested release and | `Windows` (`quickget` will begin downloading the requested release and | ||||||
|  | @ -271,8 +256,7 @@ edition of windows) | ||||||
| 
 | 
 | ||||||
| ## Other Operating Systems | ## Other Operating Systems | ||||||
| 
 | 
 | ||||||
| `quickget` also supports: | also supports: | ||||||
| 
 |  | ||||||
| -   `alma` (Alma Linux) | -   `alma` (Alma Linux) | ||||||
| -   `alpine` (Alpine Linux) | -   `alpine` (Alpine Linux) | ||||||
| -   `android` (Android x86) | -   `android` (Android x86) | ||||||
|  | @ -342,20 +326,7 @@ Or you can download a Linux image and manually create a VM | ||||||
| configuration. | configuration. | ||||||
| 
 | 
 | ||||||
| -   Download a .iso image of a Linux distribution | -   Download a .iso image of a Linux distribution | ||||||
| -   Create a VM configuration file; for example `debian-bullseye.conf` | -   Create a VM configuration file | ||||||
| 
 |  | ||||||
| ``` bash |  | ||||||
| guest_os="linux" |  | ||||||
| disk_img="debian-bullseye/disk.qcow2" |  | ||||||
| iso="debian-bullseye/firmware-11.0.0-amd64-DVD-1.iso" |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| -   Use `quickemu` to start the virtual machine: |  | ||||||
| 
 |  | ||||||
| ``` bash |  | ||||||
| quickemu --vm debian-bullseye.conf |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| -   Complete the installation as normal. | -   Complete the installation as normal. | ||||||
| -   Post-install: | -   Post-install: | ||||||
|     -   Install the SPICE agent (`spice-vdagent`) in the guest to enable |     -   Install the SPICE agent (`spice-vdagent`) in the guest to enable | ||||||
|  | @ -368,11 +339,6 @@ quickemu --vm debian-bullseye.conf | ||||||
| `quickget` automatically downloads a macOS recovery image and creates a | `quickget` automatically downloads a macOS recovery image and creates a | ||||||
| virtual machine configuration. | virtual machine configuration. | ||||||
| 
 | 
 | ||||||
| ``` bash |  | ||||||
| quickget macos catalina |  | ||||||
| quickemu --vm macos-catalina.conf |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| macOS `high-sierra`, `mojave`, `catalina`, `big-sur`, `monterey` and | macOS `high-sierra`, `mojave`, `catalina`, `big-sur`, `monterey` and | ||||||
| `ventura` are supported. | `ventura` are supported. | ||||||
| 
 | 
 | ||||||
|  | @ -511,7 +477,7 @@ Now reboot, and the App Store should work. | ||||||
| 
 | 
 | ||||||
| ## Windows 8, 10 & 11 Guests | ## Windows 8, 10 & 11 Guests | ||||||
| 
 | 
 | ||||||
| `quickget` can download | can download | ||||||
| [Windows10](https://www.microsoft.com/software-download/windows10) and | [Windows10](https://www.microsoft.com/software-download/windows10) and | ||||||
| [Windows 11](https://www.microsoft.com/software-download/windows11) | [Windows 11](https://www.microsoft.com/software-download/windows11) | ||||||
| automatically and create an optimised virtual machine configuration. | automatically and create an optimised virtual machine configuration. | ||||||
|  | @ -521,11 +487,6 @@ Windows](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/). | ||||||
| Windows 8.1 is also supported but doesn't feature any automated | Windows 8.1 is also supported but doesn't feature any automated | ||||||
| installation or driver optimisation. | installation or driver optimisation. | ||||||
| 
 | 
 | ||||||
| ``` bash |  | ||||||
| quickget windows 11 |  | ||||||
| quickemu --vm windows-11.conf |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| -   Complete the installation as you normally would. | -   Complete the installation as you normally would. | ||||||
| -   All relevant drivers and services should be installed automatically. | -   All relevant drivers and services should be installed automatically. | ||||||
| -   A local administrator user account is automatically created, with | -   A local administrator user account is automatically created, with | ||||||
|  |  | ||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue