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
							
								
									334c137c99
								
							
						
					
					
						commit
						a925d0656d
					
				
					 1 changed files with 20 additions and 29 deletions
				
			
		
							
								
								
									
										49
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										49
									
								
								README.md
									
										
									
									
									
								
							|  | @ -17,29 +17,38 @@ distributions where the virtual machines can be stored anywhere, such as | ||||||
| external USB storage. | external USB storage. | ||||||
| 
 | 
 | ||||||
| Quickemu is opinionated and will attempt to *"do the right thing"* rather than | Quickemu is opinionated and will attempt to *"do the right thing"* rather than | ||||||
| expose rich configuration options. Quickemu is a frontend to [QEMU](https://www.qemu.org/). See the video where I explain some of my motivations for creating this script. | expose rich configuration options. Quickemu is a wrapper for [QEMU](https://www.qemu.org/). See the video where I explain some of my motivations for creating this script. | ||||||
| 
 | 
 | ||||||
| We have a Discord for this project: [](https://discord.gg/sNmz3uw) | We have a Discord for this project: [](https://discord.gg/sNmz3uw) | ||||||
| 
 | 
 | ||||||
| [](https://www.youtube.com/watch?v=AOTYWEgw0hI) | [](https://www.youtube.com/watch?v=AOTYWEgw0hI) | ||||||
| 
 | 
 | ||||||
| ## Installation | ## Requirements | ||||||
| 
 | 
 | ||||||
| ### Install Quickemu | Essential requirements: | ||||||
| 
 | 
 | ||||||
| Clone this repository: |   * [QEMU](https://www.qemu.org/) 6.0.0 or newer | ||||||
|  |   * [Coreutils](https://www.gnu.org/software/coreutils/) | ||||||
|  |   * [procps](https://gitlab.com/procps-ng/procps) | ||||||
|  |   * [usbutils](https://github.com/gregkh/usbutils) | ||||||
|  |   * [Wget](https://www.gnu.org/software/wget/) | ||||||
|  |   * [xrandr](https://gitlab.freedesktop.org/xorg/app/xrandr) | ||||||
| 
 | 
 | ||||||
| ``` | Optional requirements: | ||||||
| git clone https://github.com/wimpysworld/quickemu.git |  | ||||||
| ``` |  | ||||||
| 
 | 
 | ||||||
| ### Install QEMU |   * `rot13` to *"decrypt"* the macOS OSK key; found in the `bsdgames` package in Debian/Ubuntu | ||||||
|  |   * `smbd` to export user home directory from the host to the guest VM; found in the `samba` package in Debian/Ubuntu | ||||||
| 
 | 
 | ||||||
| #### Ubuntu | ## Install Quickemu | ||||||
|  | 
 | ||||||
|  | ### Ubuntu | ||||||
|  | 
 | ||||||
|  | Quickemu is available from a PPA for Ubuntu users. The Quickemu PPA also | ||||||
|  | includes a back port of QEMU 6.0.0 for 20.04 (Focal) and 21.04 (Hirsute). | ||||||
| 
 | 
 | ||||||
| ```bash | ```bash | ||||||
| sudo apt-add-repository ppa:flexiondotorg/quickemu | sudo apt-add-repository ppa:flexiondotorg/quickemu | ||||||
| sudo apt install qemu-system | sudo apt install quickemu | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| ## Usage | ## Usage | ||||||
|  | @ -166,15 +175,6 @@ Starting /media/martin/Quickemu/windows10.conf | ||||||
| 
 | 
 | ||||||
| ### macOS | ### macOS | ||||||
| 
 | 
 | ||||||
| #### Optional extras for macOS |  | ||||||
| 
 |  | ||||||
| If you want to run macOS then `quickemu` requires some additional utilities. |  | ||||||
| `rot13` from `bsdgames` is used to *"decrypt"* the OSK key. |  | ||||||
| 
 |  | ||||||
| ``` |  | ||||||
| sudo apt install bsdgames wget |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| There are some considerations when running macOS via Quickemu. | There are some considerations when running macOS via Quickemu. | ||||||
| 
 | 
 | ||||||
|   * `quickemu` will automatically download the required [Clover EFI bootloader](https://sourceforge.net/projects/cloverefiboot/) and OVMF firmware from [the macOS-Simple-KVM project](https://github.com/foxlet/macOS-Simple-KVM). |   * `quickemu` will automatically download the required [Clover EFI bootloader](https://sourceforge.net/projects/cloverefiboot/) and OVMF firmware from [the macOS-Simple-KVM project](https://github.com/foxlet/macOS-Simple-KVM). | ||||||
|  | @ -271,15 +271,6 @@ You can also pass optional parameters | ||||||
| 
 | 
 | ||||||
| ## TODO | ## TODO | ||||||
| 
 | 
 | ||||||
|   - [x] Create desktop launcher for a VM |   - [ ] SPICE support | ||||||
|   - [ ] Improve disk management |   - [ ] Improve disk management | ||||||
|   - [x] Add USB pass-through support |  | ||||||
|   - [x] Fix Virgil 3D on EFI boot |  | ||||||
|   - [x] Add Windows support |  | ||||||
|   - [x] Get QEMU `-audiodev` working for audio input |  | ||||||
|   - [x] Make display configuration more robust |  | ||||||
|   - [x] Improve snapshot management |  | ||||||
|   - [x] Improve stdout presentation |  | ||||||
|   - [x] Make disk image size configurable |  | ||||||
|   - [ ] [Add Faux OEM](https://code.launchpad.net/~ubuntu-installer/ubiquity/+git/ubiquity/+merge/379899) |   - [ ] [Add Faux OEM](https://code.launchpad.net/~ubuntu-installer/ubiquity/+git/ubiquity/+merge/379899) | ||||||
|   - [x] Improve SMB Management |  | ||||||
|  |  | ||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue