mirror of
https://github.com/quickemu-project/quickemu.git
synced 2024-06-03 05:25:32 +02:00
f6b5d684d4
Also README.md and sub-project aligned
113 lines
6.1 KiB
Markdown
113 lines
6.1 KiB
Markdown
<div align="center">
|
|
<img src=".github/logo.png" alt="Quickemu" width="256" />
|
|
|
|
# Quickemu
|
|
|
|
**Quickly create and run optimised Windows, macOS and Linux virtual machines:**
|
|
|
|
**Made with 💝 for <img src=".github/tux.png" align="top" width="24" alt="Tux (Linux)"/>**
|
|
</div>
|
|
|
|
<p align="center">
|
|
<a href="https://wimpysworld.io/discord" target="_blank"><img alt="Discord" src="https://img.shields.io/discord/712850672223125565?style=for-the-badge&logo=discord&logoColor=%23ffffff&label=Discord&labelColor=%234253e8&color=%23e4e2e2"></a>
|
|
<a href="https://fosstodon.org/@wimpy" target="_blank"><img alt="Mastodon" src="https://img.shields.io/badge/Mastodon-6468fa?style=for-the-badge&logo=mastodon&logoColor=%23ffffff"></a>
|
|
<a href="https://twitter.com/m_wimpress" target="_blank"><img alt="Twitter" src="https://img.shields.io/badge/Twitter-303030?style=for-the-badge&logo=x&logoColor=%23ffffff"></a>
|
|
<a href="https://linkedin.com/in/martinwimpress" target="_blank"><img alt="LinkedIn" src="https://img.shields.io/badge/LinkedIn-1667be?style=for-the-badge&logo=linkedin&logoColor=%23ffffff"></a>
|
|
</p>
|
|
|
|
|
|
# Introduction
|
|
|
|
**Quickemu** is a wrapper for the excellent [QEMU](https://www.qemu.org/) that
|
|
automatically *"does the right thing"* when creating virtual machines. No
|
|
requirement for exhaustive configuration options. You decide what operating
|
|
system you want to run and Quickemu takes care of the rest 🤖
|
|
|
|
- `quickget` **automatically downloads the upstream OS** and creates the configuration 📀
|
|
- `quickemu` enumerates your hardware and launches the virtual machine with the **optimum configuration best suited to your computer** ⚡️
|
|
|
|
The original objective of the project was to [enable quick testing of Linux
|
|
distributions](https://github.com/quickemu-project/quickemu/wiki/02-Create-Linux-virtual-machines)
|
|
where the virtual machines and their configuration can be stored anywhere (such
|
|
as external USB storage or your home directory) and no elevated permissions are
|
|
required to run the virtual machines.
|
|
|
|
**Today, Quickemu includes comprehensive support for [macOS](https://github.com/quickemu-project/quickemu/wiki/03-Create-macOS-virtual-machines),
|
|
[Windows](https://github.com/quickemu-project/quickemu/wiki/04-Create-Windows-virtual-machines)**, most of the BSDs, novel non-Linux operating systems such as FreeDOS, Haiku, KolibriOS, OpenIndiana, ReactOS, and more.
|
|
|
|
# Features
|
|
|
|
- **macOS** Sonoma, Ventura, Monterey, Big Sur, Catalina & Mojave
|
|
- **Windows** 10 and 11 including TPM 2.0
|
|
- **Windows Server** 2022 2019 2016 2012-r2
|
|
- [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu
|
|
flavours](https://ubuntu.com/download/flavours)**
|
|
- **Nearly 1000 operating system editions are supported!**
|
|
- Full SPICE support including host/guest clipboard sharing
|
|
- VirtIO-webdavd file sharing for Linux and Windows guests
|
|
- VirtIO-9p file sharing for Linux and macOS guests
|
|
- [QEMU Guest Agent
|
|
support](https://wiki.qemu.org/Features/GuestAgent); provides access
|
|
to a system-level agent via standard QMP commands
|
|
- Samba file sharing for Linux, macOS and Windows guests (*if `smbd`
|
|
is installed on the host*)
|
|
- VirGL acceleration
|
|
- USB device pass-through
|
|
- Smartcard pass-through
|
|
- Automatic SSH port forwarding to guests
|
|
- Network port forwarding
|
|
- Full duplex audio
|
|
- Braille support
|
|
- EFI (with or without SecureBoot) and Legacy BIOS boot
|
|
|
|
# Quick start
|
|
|
|
[Once Quickemu is installed](https://github.com/quickemu-project/quickemu/wiki/01-Installation), there are two simple steps to create and run a virtual machine:
|
|
|
|
- `quickget` automatically downloads the ISO image for the operating system you want to run and creates a configuration file for the virtual machine.
|
|
|
|
``` shell
|
|
quickget nixos unstable
|
|
```
|
|
|
|
- `quickemu` starts the virtual machine using the configuration file created by `quickget`.
|
|
|
|
``` shell
|
|
quickemu --vm nixos-unstable.conf
|
|
```
|
|
|
|
Execute `quickget` (with no arguments) to see a list of all the supported operating systems.
|
|
|
|
## Demo
|
|
|
|
<div align="center">
|
|
|
|
<a href="https://asciinema.org/a/658148?autoplay=1" target="_blank"><img src="https://asciinema.org/a/658148.svg" /></a>
|
|
|
|
</div>
|
|
|
|
# Documentation
|
|
|
|
The wiki describes how to get up and running with Quickemu and also covers more advanced configuration and usage.
|
|
|
|
- [**Installation**](https://github.com/quickemu-project/quickemu/wiki/01-Installation) 💾
|
|
- [**Create Linux virtual machines**](https://github.com/quickemu-project/quickemu/wiki/02-Create-Linux-virtual-machines) 🐧
|
|
- [**Create macOS virtual machines**](https://github.com/quickemu-project/quickemu/wiki/03-Create-macOS-virtual-machines) 🍏
|
|
- [**Create Windows virtual machines**](https://github.com/quickemu-project/quickemu/wiki/04-Create-Windows-virtual-machines) 🪟
|
|
- [**Advanced quickemu configuration**](https://github.com/quickemu-project/quickemu/wiki/05-Advanced-quickemu-configuration) 🔧
|
|
- [**Advanced quickget features**](https://github.com/quickemu-project/quickemu/wiki/06-Advanced-quickget-features) 🤓
|
|
- [**Alternative frontends**](https://github.com/quickemu-project/quickemu/wiki/07-Alternative-frontends) 🧑💻
|
|
- [**References**](https://github.com/quickemu-project/quickemu/wiki/08-References) 📚️
|
|
|
|
# Contributing
|
|
|
|
We welcome contributions to Quickemu.
|
|
|
|
- Help other Quickemu users by answering questions in the [Quickemu Discussions](https://github.com/quickemu-project/quickemu/discussions) 🛟
|
|
- Improve the documentation in [this README](https://github.com/quickemu-project/quickemu/edit/master/README.md) and the [Quickemu Wiki](https://github.com/quickemu-project/quickemu/wiki) 📖
|
|
- File bug reports and feature requests in the [Quickemu Issues](https://github.com/quickemu-project/quickemu/issues) 📁
|
|
- Submit [Quickemu Pull requests](https://github.com/quickemu-project/quickemu/pulls) to fix bugs 🐞 or add new features ✨
|
|
- Follow our [guide to adding a new OS to quickget](https://github.com/quickemu-project/quickemu/wiki/06-Advanced-quickget-features#adding-a-new-os-to-quickget)
|
|
- Commit messages must [conform to the Conventional Commits specification](https://www.conventionalcommits.org/).
|
|
- [Sponsor the project](https://github.com/sponsors/flexiondotorg) 💖
|