mirror of
				https://github.com/oSoWoSo/DistroHopper.git
				synced 2024-08-14 22:46:53 +00:00 
			
		
		
		
	Update README
This commit is contained in:
		
							parent
							
								
									f70026e886
								
							
						
					
					
						commit
						14ef994a01
					
				
					 1 changed files with 42 additions and 16 deletions
				
			
		
							
								
								
									
										58
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										58
									
								
								README.md
									
										
									
									
									
								
							|  | @ -4,25 +4,51 @@ | ||||||
|   Quickemu |   Quickemu | ||||||
| </h1> | </h1> | ||||||
| 
 | 
 | ||||||
| <p align="center"><b>Simple script to "manage" Qemu virtual machines.</b></p> | <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> | <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 | # Introduction | ||||||
| 
 | 
 | ||||||
| Quickemu is a simple script to *"manage"* Qemu virtual machines. Each virtual | Quickemu quickly creates and runs highly optimised desktop virtual machines for | ||||||
| machine configuration is a few lines long requiring minimal setup. The | Linux, macOS and Windows; in just with just two commands. You decide what | ||||||
| main objective of the project is to enable quick testing of desktop Linux | operating system you want to run and Quickemu will figure out the best way to | ||||||
| distributions where the virtual machines configuration and disk images can be | do it for you. For example: | ||||||
| stored anywhere, such as external USB storage or your home directory. **Windows |  | ||||||
| and macOS guests are also supported.** |  | ||||||
| 
 | 
 | ||||||
| Quickemu will attempt to *"do the right thing"* rather than expose rich | ```bash | ||||||
| configuration options. Quickemu is a wrapper for [QEMU](https://www.qemu.org/). | quickget ubuntu-mate hirsute | ||||||
| See the video where I explain some of my motivations for creating this script. | quickemu --vm ubuntu-mate-hirsute.conf | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | The original objective of the project was to enable quick testing of Linux | ||||||
|  | distributions where the virtual machine configurations can be stored anywhere, | ||||||
|  | such as external USB storage or your home directory, and no elevated permissions | ||||||
|  | are required to run the virtual machines. **Quickemu now also includes | ||||||
|  | comprehensive support for macOS and Windows**. | ||||||
|  | 
 | ||||||
|  | ## Features | ||||||
|  | 
 | ||||||
|  |   * macOS High Sierra, Mojave, Catalina and Big Sur | ||||||
|  |   * Windows 8.1, 10 and 11 including TPM 2.0 | ||||||
|  |   * Ubuntu, and all the official flavours, supported by `quickget` | ||||||
|  |   * SPICE for host/guest clipboard sharing | ||||||
|  |   * VirtIO-webdavd file sharing for Linux and Windows guests. | ||||||
|  |   * VirtIO-9p file sharing for Linux and macOS guests. | ||||||
|  |   * VirGL acceleration | ||||||
|  |   * USB device pass-through | ||||||
|  |   * Smartcard pass-through | ||||||
|  |   * Automatic SSH port forwarding to guests | ||||||
|  |   * Network port forwarding | ||||||
|  |   * EFI and Legacy BIOS booting | ||||||
|  | 
 | ||||||
|  | Quickemu is a wrapper for the excellent [QEMU](https://www.qemu.org/) that | ||||||
|  | attempts to automatically *"do the right thing"*, rather than expose exhaustive | ||||||
|  | configuration options. | ||||||
| 
 | 
 | ||||||
| We have a Discord for this project: [](https://discord.gg/sNmz3uw) | 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) | [](https://www.youtube.com/watch?v=AOTYWEgw0hI) | ||||||
| 
 | 
 | ||||||
| ## Requirements | ## Requirements | ||||||
|  | @ -162,14 +188,14 @@ The default macOS configuration looks like this: | ||||||
| 
 | 
 | ||||||
| ```bash | ```bash | ||||||
| guest_os="macos" | guest_os="macos" | ||||||
| img="macos-big-sur/RecoveryImage.img" | img="macos-catalina/RecoveryImage.img" | ||||||
| disk_img="macos-big-sur/disk.qcow2" | disk_img="macos-catalina/disk.qcow2" | ||||||
| macos_release="big-sur" | macos_release="catalina" | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
|   * The `guest_os="macos"` line instructs Quickemu to optimise for macOS. |   * `guest_os="macos"` instructs Quickemu to optimise for macOS. | ||||||
|   * The `macos_release="big-sur"` line instructs Quickemu to optimise for a particular macOS release. |   * `macos_release="catalina"` instructs Quickemu to optimise for a particular macOS release. | ||||||
|     * For example VirtIO Network and Memory Ballooning are available in Big Sir, but not previous releases. |     * For example VirtIO Network and Memory Ballooning are available in Big Sur, but not previous releases. | ||||||
|     * And VirtIO Block Media (disks) are supported/stable in Catalina and newer. |     * And VirtIO Block Media (disks) are supported/stable in Catalina and newer. | ||||||
| 
 | 
 | ||||||
| ### macOS compatibility | ### macOS compatibility | ||||||
|  |  | ||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue