# QtEmu Help

Last updated: 2006-12-17

### Index

- Overview
- Create a new virtual machine - step by step
- Toolbar
- Options
- Other

### Overview

QtEmu is a graphical user interface for QEMU. It has the ability to run virtual operating systems on native systems. This way you can easily test a new operating system or try a Live CD on your system without any troubles and dangers.

### Create a new virtual machine - step by step

Click on the "New virtual machine" button, either in Toolbar or Main tab. A wizard opens.
Select in the combobox the operation system you want to install. If it is not listed there, select "Other".
There is already a name for the virtual machine proposed. If you have selected "Other", your should now enter the correct name.
When you change the name, the path adjusts automatically itself.
Now you can specify how much space should be allocated for the virtual disk image. Do not specify a bigger size than there is space available on the selected real hard disk. Click "Finish". The wizard closes and the new created machine opens.
Now you are able to configure the new virtual machine.
Your operating system must be installed most probably from CD ROM. To do so, open the "CD ROM"-section.
Your are able to choose between a physical CD drive and a CD image.
After you have choosen a CD ROM, activate "Boot from CD ROM".
Now you can start with the installation. Or if you would like to start a Live-CD, you are able to do so.
A new window appears after a click on "Start". That is your virtual machine. You can work inside it like you could on a real computer. To switch keyboard and mouse between virtual and real system, press ALT+CTRL.
When you will quit the virtual system, do it like you would do it on a real system. If the operating system does not provide a function to quit, do so with the "Stop" button. But keep in mind: The stop button does the same as if you would unplug your power cable on a real computer.
If you are sure you will kill the system, confirm it with "Yes".

### Toolbar

- New Machine: Click here to create a new virtual machine.
- Open: Click here to open an existing QtEmu machine (.qte).
- Power buttons (Start, Stop, Restart): These buttons do the same as the buttons inside the machine configuration. The are provided for convenience.

### Options

- "MyMachines"-Path: You can change the default "MyMachines"-path, which is in the folder "MyMachies" in your private user / home folder. All new virtual machines will be saved by default into the "MyMachines" folder.
- Tabbar position: Here you can change the position of the tabbar (default: left).
- Language: The language is by default your system language if available. Feel free to translate QtEmu into your language. Just contact the author.

### Other

- Snapshot Mode: If you would like to test something in your virtual machine without have these changes on your next restart of your virtual system, activate "Snapshot Mode".
- Notes: You are able to write down some note about the current virtual machine. Possible notes are for example applications which are installed.