Added final features to EmuGUI 0.5

Author: Tech-FZ

CHANGELOG.md

@@ -5,6 +5,11 @@
 - An update checker has been added
 - ARM-based VMs can now run with standard VGA
 - You can now select between several USB controllers.
+- This script can now be run on Linux.
+- TESTED.md has been updated.
+- Installation and building instructions for Linux have been added to README.md.
+- If you start a virtual machine, there is now a message at the bottom of the window which could be helpful when debugging.
+- There is now a window which warns you if your VM uses the depreciated USB checkbox.
 
 # EmuGUI v0.4.2
 

README.md

@@ -30,7 +30,7 @@ code in Copilot.
 ![Logo of the GiveUpGitHub campaign](https://sfconservancy.org/img/GiveUpGitHub.png)
 
 ## System requirements
-OS: Windows 8.1, Windows Server 2012 R2 or later (x64)
+OS: Windows 8.1, Windows Server 2012 R2 or later (x64); Ubuntu 20.04, Debian 10, openSUSE Leap 15.3, openSUSE Tumbleweed, Fedora 35, RHEL 7, Arch Linux or distributions based on those (x64)
 
 Python: 3.6 or newer
 
@@ -50,14 +50,38 @@ HDD: 2 GB¹
 - QEMU
 - Python Magic
 
-## Installation
+## Installation (Windows)
 
 1. Get QEMU at https://qemu.weilnetz.de/w64/ and install it
 2. Get EmuGUI and extract it
 3. Run main.exe in the EmuGUI directory.
 4. Set the QEMU paths at the Settings/QEMU tab.
 5. Create a new virtual machine and start it.
 
+## Installation (Linux)
+
+1. Open your terminal and type in one of the commands to update your system, depending on your distro:
+- Arch: `sudo pacman -Syu`
+- Debian/Ubuntu: `sudo apt-get update && sudo apt-get upgrade`
+- Fedora/RHEL 8: `sudo dnf upgrade --refresh` or `sudo dnf update`
+- Gentoo: `sudo emaint -a sync && sudo emerge --ask --verbose --update --deep --newuse @world`
+- RHEL 7: `sudo yum update`
+- SUSE and openSUSE Leap: `sudo zypper patch && sudo zypper up`
+- openSUSE Tumbleweed: `sudo zypper patch && sudo zypper dup`
+
+2. Open your terminal and type in one of the commands to install QEMU, depending on your distribution:
+- Arch: `sudo pacman -S qemu`
+- Debian/Ubuntu: `sudo apt-get install qemu`
+- Fedora: `sudo dnf install @virtualization`
+- Gentoo: `sudo emerge --ask app-emulation/qemu`
+- RHEL: `sudo yum install qemu-kvm`
+- (open-)SUSE: `sudo zypper install qemu`
+
+3. Get EmuGUI from this website and extract it.
+4. Run main in the EmuGUI directory.
+5. Set the QEMU paths at the Settings/QEMU tab (either `/usr/bin/qemu-system-*` or just `qemu-system-*`).
+6. Create a new virtual machine and start it.
+
 ## Updating EmuGUI
 
 1. Close out of EmuGUI before updating.
@@ -103,6 +127,21 @@ HDD: 2 GB¹
 14. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
 15. If it works, have fun! If not, try to start again from number 9.
 
+## Building on Linux
+
+1. Install Python 3. You can either compile the source code or get it from your distribution's repositories.
+2. Install QEMU using one of the commands listed on Installation (Linux).
+3. Install Git using the install command of your distribution.
+4. Install Visual Studio Code. You can get it from https://code.visualstudio.com/download
+5. Open a terminal and type: `git clone https://github.com/Tech-FZ/EmuGUI.git` or `git clone https://codeberg.org/lucien-rowan/EmuGUI.git`
+6. Open Visual Studio Code in that folder.
+7. Open a terminal WITHIN VS Code and type: `python3 -m pip install --upgrade pip PyInstaller PyQt6 PyQt6-tools PySide6 python-magic`. You can try getting a VENV working but I personally have problems with using Python virtual environments on Linux.
+8. After this is done, run the main.py script.
+9. To compile the program for users who don't have Python installed, type: `PyInstaller --onefile main.py` (for those who can get a VENV to work) or `python3 -m PyInstaller --onefile main.py`
+10. After that is finished, copy the code into the dist folder PyInstaller created.
+11. Run the executable in the dist folder. If your antivirus puts it into quarantine, don't worry as this should be a false positive and restore it.
+12. If it works, have fun! If not, try to start again from number 7.
+
 ## Documentation
 
 A documentation of EmuGUI can be found at: https://tech-fz.github.io/EmuGUI-doc/

dialogExecution/__pycache__/editVirtualMachine.cpython-39.pyc

@@ -464,6 +464,8 @@ def finishCreation(self):
             WHERE name = "qemu-img"
             """
 
+            vhd_cmd = ""
+
             try:
                 cursor.execute(get_qemu_img_bin)
                 connection.commit()
@@ -482,16 +484,29 @@ def finishCreation(self):
 
                 print(vhd_size_in_b)
 
+                if platform.system() == "Windows":
+                    vhd_cmd = f"{qemu_binary} create -f {self.comboBox_8.currentText()} \"{vhd}\" {str(vhd_size_in_b)}"
+
+                else:
+                    vhd_cmd = f"{qemu_binary} create -f {self.comboBox_8.currentText()} {vhd} {str(vhd_size_in_b)}"
+
                 if vhdAction.startswith("overwrite"):
-                    subprocess.Popen(f"{qemu_binary} create -f {self.comboBox_8.currentText()} \"{vhd}\" {str(vhd_size_in_b)}")
+                    subprocess.Popen(vhd_cmd)
 
                 print("The query was executed and the virtual disk created successfully.")
 
             except sqlite3.Error as e:
                 print(f"The SQLite module encountered an error: {e}.")
 
             except:
-                print(f"The query was executed successfully, but the virtual disk couldn't be created.")
+                print(f"The query was executed successfully, but the virtual disk couldn't be created. Trying to use subprocess.run")
+
+                try:
+                    vhd_cmd_split = vhd_cmd.split(" ")
+                    subprocess.run(vhd_cmd_split)
+                
+                except:
+                    print("The virtual disk could not be created. Please check if the path and the QEMU settings are correct.")
 
         if self.comboBox_11.currentText() == "none":
             networkAdapter = "none"

dialogExecution/__pycache__/newVirtualMachine.cpython-39.pyc

@@ -241,6 +241,8 @@ def finishCreation(self):
             WHERE name = "qemu-img"
             """
 
+            vhd_cmd = ""
+
             try:
                 cursor.execute(get_qemu_img_bin)
                 connection.commit()
@@ -259,16 +261,29 @@ def finishCreation(self):
 
                 print(vhd_size_in_b)
 
+                if platform.system() == "Windows":
+                    vhd_cmd = f"{qemu_binary} create -f {self.comboBox_8.currentText()} \"{vhd}\" {str(vhd_size_in_b)}"
+
+                else:
+                    vhd_cmd = f"{qemu_binary} create -f {self.comboBox_8.currentText()} {vhd} {str(vhd_size_in_b)}"
+
                 if vhdAction.startswith("overwrite"):
-                    subprocess.Popen(f"{qemu_binary} create -f {self.comboBox_8.currentText()} \"{vhd}\" {str(vhd_size_in_b)}")
+                    subprocess.Popen(vhd_cmd)
 
                 print("The query was executed and the virtual disk created successfully.")
 
             except sqlite3.Error as e:
                 print(f"The SQLite module encountered an error: {e}.")
 
             except:
-                print(f"The query was executed successfully, but the virtual disk couldn't be created.")
+                print(f"The query was executed successfully, but the virtual disk couldn't be created. Trying to use subprocess.run")
+
+                try:
+                    vhd_cmd_split = vhd_cmd.split(" ")
+                    subprocess.run(vhd_cmd_split)
+                
+                except:
+                    print("The virtual disk could not be created. Please check if the path and the QEMU settings are correct.")
 
         if self.comboBox_11.currentText() == "none":
             networkAdapter = "none"

dialogExecution/__pycache__/startVirtualMachine.cpython-39.pyc

@@ -116,6 +116,8 @@ def start_virtual_machine(self):
         print(bootfrom)
         print(dateTimeForVM)
 
+        qemu_cmd = ""
+
         try:
             if self.vmSpecs[1] == "i386":
                 cursor.execute(qemu_i386_bin)
@@ -160,13 +162,26 @@ def start_virtual_machine(self):
                 print(result)
 
             qemu_to_execute = result[0][0]
-            qemu_cmd = f"{qemu_to_execute} -m {self.vmSpecs[4]} -rtc base=\"{dateTimeForVM}\",clock=vm -smp {self.vmSpecs[17]}"
+
+            if platform.system() == "Windows":
+                qemu_cmd = f"{qemu_to_execute} -m {self.vmSpecs[4]} -rtc base=\"{dateTimeForVM}\",clock=vm -smp {self.vmSpecs[17]}"
+
+            else:
+                qemu_cmd = f"{qemu_to_execute} -m {self.vmSpecs[4]} -rtc base={dateTimeForVM},clock=vm -smp {self.vmSpecs[17]}"
 
             if magic.from_file(self.vmSpecs[5]) == "block special":
-                qemu_cmd = qemu_cmd + f" -drive format=raw,file=\"{self.vmSpecs[5]}\""
+                if platform.system() == "Windows":
+                    qemu_cmd = qemu_cmd + f" -drive format=raw,file=\"{self.vmSpecs[5]}\""
+                
+                else:
+                    qemu_cmd = qemu_cmd + f" -drive format=raw,file={self.vmSpecs[5]}"
 
             else:
-                qemu_cmd = qemu_cmd + f" -hda \"{self.vmSpecs[5]}\""
+                if platform.system() == "Windows":
+                    qemu_cmd = qemu_cmd + f" -hda \"{self.vmSpecs[5]}\""
+
+                else:
+                    qemu_cmd = qemu_cmd + f" -hda {self.vmSpecs[5]}"
 
             if self.vmSpecs[2] != "Let QEMU decide":
                 qemu_cmd = qemu_cmd + f" -M {self.vmSpecs[2]}"
@@ -381,6 +396,13 @@ def start_virtual_machine(self):
             print(f"The SQLite module encountered an error: {e}.")
 
         except:
-            print("Qemu couldn't be executed. Please check the settings.")
+            print("Qemu couldn't be executed. Trying subprocess.run")
+
+            try:
+                qemu_cmd_split = qemu_cmd.split(" ")
+                subprocess.run(qemu_cmd_split)
+            
+            except:
+                print("Qemu couldn't be executed. Please check if the settings of your VM and/or the QEMU paths are correct.")
 
         self.close()

dialogExecution/__pycache__/usbTabletDepreciation.cpython-39.pyc

@@ -0,0 +1,35 @@
+from uiScripts.ui_USBTabletCheckboxDepreciated import Ui_Dialog
+from PySide6.QtWidgets import *
+import platform
+import platformSpecific.windowsSpecific
+import platformSpecific.unixSpecific
+
+class UsbTabletDepreciated(QDialog, Ui_Dialog):
+    def __init__(self, parent = None):
+        super().__init__(parent)
+        self.setupUi(self)
+        self.vmSpecs = self.readTempVmFile()
+        self.setWindowTitle(f"EmuGUI - {self.vmSpecs[0]} uses a depreciated feature")
+        self.connectSignalsSlots()
+
+    def connectSignalsSlots(self):
+        self.pushButton.clicked.connect(self.close)
+
+    def readTempVmFile(self):
+        # Searching temporary files
+        if platform.system() == "Windows":
+            tempVmDef = platformSpecific.windowsSpecific.windowsTempVmStarterFile()
+        
+        else:
+            tempVmDef = platformSpecific.unixSpecific.unixTempVmStarterFile()
+
+        vmSpecs = []
+
+        with open(tempVmDef, "r+") as tempVmDefFile:
+            vmSpecsRaw = tempVmDefFile.readlines()
+
+        for vmSpec in vmSpecsRaw:
+            vmSpecNew = vmSpec.replace("\n", "")
+            vmSpecs.append(vmSpecNew)
+
+        return vmSpecs