Allows for viewing Images in fullscreen!, Fixes gaps with Kext select…

…ion, Adds new Gallery images.
royalgraphx · Feb 7, 2024 · c90fbd6 · c90fbd6
1 parent 40f835d
commit c90fbd6
Show file tree

Hide file tree

Showing 34 changed files with 97 additions and 192 deletions.
diff --git a/README.md b/README.md
@@ -18,6 +18,16 @@
   <img width="650" height="200" src="./Assets/HeaderGallery.png">
 </p>
 
+<h3 align="center">macOS Sonoma 14.4 Beta</h3>
+<p align="center">
+  <img src="./showcase/HacProKVM144Beta.png">
+</p>
+
+<h3 align="center">macOS Sonoma 14.3</h3>
+<p align="center">
+  <img src="./showcase/HacProKVM143.png">
+</p>
+
 <h3 align="center">macOS Sonoma 14.2.1 (Credits: @heliokroger)</h3>
 <p align="center">
   <img src="./showcase/Helio1421.png">

diff --git a/docs/_infocenter/01-FileOverview/03-Kexts.md b/docs/_infocenter/01-FileOverview/03-Kexts.md
@@ -20,6 +20,6 @@ Here is a basic chart of a Kext, its use, and the status of the requirement. Che
 | [RestrictEvents](https://github.com/ExtremeXT/RestrictEvents) | Recommended | Lilu plugin for blocking unwanted processes causing compatibility issues on different hardware and unlocking the support for certain features restricted to other hardware. We will use it for changing the name of the CPU cosmetically and fixing Bluetooth support on macOS Sonoma. |
 | [VirtualSMC](https://github.com/acidanthera/VirtualSMC) | Optional | Emulates the SMC chip found on real macs, but we are already emulating it from the XML file, only use it for kexts that send temperature info to the SMC, like SMCRadeonGPU. |
 | [RadeonSensor](https://github.com/NootInc/RadeonSensor) | Optional | Kext and Gadget to show AMD GPU temperature on macOS. |
-| [AppleALC](https://github.com/acidanthera/AppleALC) | Optional | Used for [Motherboard Audio](../../writeups/04-MotherboardAudio/index), Additional setup required! |
+| [AppleALC](https://github.com/acidanthera/AppleALC) | Optional | Used for [Motherboard Audio](../../../writeups/05-MotherboardAudio/index), Additional setup required! |
 
 ## You can now continue to the next <a href="../04-Tools">page</a>.
diff --git a/docs/_infocenter/01-FileOverview/04-Tools.md b/docs/_infocenter/01-FileOverview/04-Tools.md
@@ -13,3 +13,5 @@ UEFI Shell is already provided by TianoCore / EDK2 UEFI BIOS. No Tools needed, t
 | Tool  | Status | Description | 
 | ----- | ----- | ----- |
 |  |  |  |
+
+<h2 align="center">You can now proceed to the <a href="../../../docs/04-GuestSupport/index">Guest Support Table</a>!</h2>
diff --git a/docs/_infocenter/06-FetchingInstaller/01-Recovery/01-DarwinFetch.md b/docs/_infocenter/06-FetchingInstaller/01-Recovery/01-DarwinFetch.md
@@ -13,26 +13,18 @@ Open a terminal and navigate to the DarwinFetch directory.
 
 You can now run ``src/main.py`` or use ``./DarwinFetch.sh`` to attempt to autolaunch.
 
-<p align="center">
-  <img src="../../../../assets/DarwinFetchMainMenu.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/DarwinFetchMainMenu.png"><img src="../../../../assets/DarwinFetchMainMenu.png" alt=""></a>
 
 Selecting the second option will take you to a submenu to select a version to fetch.
 
 For this example, we'll be getting the latest macOS Sonoma 14.3 RecoveryOS image.
 
-<p align="center">
-  <img src="../../../../assets/DarwinFetchRecoverySources.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/DarwinFetchRecoverySources.png"><img src="../../../../assets/DarwinFetchRecoverySources.png" alt=""></a>
 
-<p align="center">
-  <img src="../../../../assets/DarwinFetchRecoverySonoma.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/DarwinFetchRecoverySonoma.png"><img src="../../../../assets/DarwinFetchRecoverySonoma.png" alt=""></a>
 
 After some time, and a verification of the accompanying chunklist, you will be ready!
 
-<p align="center">
-  <img src="../../../../assets/DarwinFetchDirectoryRecovery.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/DarwinFetchDirectoryRecovery.png"><img src="../../../../assets/DarwinFetchDirectoryRecovery.png" alt=""></a>
 
 ## You can now continue to the next <a href="../02-addingtoOC">page</a>.
diff --git a/docs/_infocenter/06-FetchingInstaller/01-Recovery/02-addingtoOC.md b/docs/_infocenter/06-FetchingInstaller/01-Recovery/02-addingtoOC.md
@@ -11,17 +11,13 @@ nav_order: 3
 
 DarwinFetch sorts all downloads within its respective downloads folder. Within that folder, you will find a named subfolder that has the version number, and the build number of whatever macOS RecoveryOS image you chose to fetch. Within that folder it then creates a ``com.apple.recovery.boot`` folder. Inside you'll find a BaseSystem.dmg and a chunklist file which holds the recoveryOS for retrieving and installing macOS from scratch over the internet.
 
-<p align="center">
-  <img src="../../../../assets/DarwinFetchDirectoryRecovery.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/DarwinFetchDirectoryRecovery.png"><img src="../../../../assets/DarwinFetchDirectoryRecovery.png" alt=""></a>
 
 Because we'd like to maintain SecureBootModel and various other aspects for security reasons, we'll want to follow the same method as using a baremetal USB. Drag the ``com.apple.recovery.boot`` folder to the root of the OpenCore image.
 
 With this, you can later boot Base System and thus, RecoveryOS.
 
-<p align="center">
-  <img width="650" height="200" src="../../../../assets/BaseSystemInstallLegacyScreenshot.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/BaseSystemInstallLegacyScreenshot.png"><img src="../../../../assets/BaseSystemInstallLegacyScreenshot.png" alt=""></a>
 
 Now that you've completed configuring your OpenCore disk image, <span style="color: #ffab52;">**DO NOT FORGET TO UNMOUNT**</span> before continuing to the XML importing and OS Installation sections.
 

diff --git a/docs/_infocenter/06-FetchingInstaller/01-Recovery/03-Installation.md b/docs/_infocenter/06-FetchingInstaller/01-Recovery/03-Installation.md
@@ -11,83 +11,58 @@ nav_order: 4
 
 OpenCore Menu, shows recoveryOS detected.
 
-<p align="center">
-  <img src="../../../../assets/OpenCoreVMBootRecovery.png">
-</p>
+{: .headsup }
+Booting from the RecoveryOS image on the OpenCore Disk Image, is known to take anywhere from a few seconds, to a minute to load! You are not frozen. Simply wait for macOS to finish loading.
+
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/OpenCoreVMBootRecovery.png"><img src="../../../../assets/OpenCoreVMBootRecovery.png" alt=""></a>
 
 macOS Ventura recoveryOS booting
 
-<p align="center">
-  <img src="../../../../assets/BootingRecovery.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/BootingRecovery.png"><img src="../../../../assets/BootingRecovery.png" alt=""></a>
 
 macOS Ventura Disk Utility showing OpenCore drive.
 
-<p align="center">
-  <img src="../../../../assets/macOSRecoveryDiskUtility.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/macOSRecoveryDiskUtility.png"><img src="../../../../assets/macOSRecoveryDiskUtility.png" alt=""></a>
 
 {: .highlight }
 From here on out, the screenshots will show macOS Sonoma because I had the USB prepared nearby and wanted to test everything working still even in Sonoma. This won't make a difference for you, it's the same for macOS Ventura.
 
-<p align="center">
-  <img src="../../../../assets/OpenCoreSonomaRecoveryBoot.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/OpenCoreSonomaRecoveryBoot.png"><img src="../../../../assets/OpenCoreSonomaRecoveryBoot.png" alt=""></a>
 
 Open Disk Utility, and format the target drive to APFS.
 
-<p align="center">
-  <img src="../../../../assets/macOSRecoveryFormatInstallTarget.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/macOSRecoveryFormatInstallTarget.png"><img src="../../../../assets/macOSRecoveryFormatInstallTarget.png" alt=""></a>
 
-<p align="center">
-  <img src="../../../../assets/macOSRecoveryFormatInstallTarget2.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/macOSRecoveryFormatInstallTarget2.png"><img src="../../../../assets/macOSRecoveryFormatInstallTarget2.png" alt=""></a>
 
-<p align="center">
-  <img src="../../../../assets/macOSRecoveryFormatInstallTarget3.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/macOSRecoveryFormatInstallTarget3.png"><img src="../../../../assets/macOSRecoveryFormatInstallTarget3.png" alt=""></a>
 
 You are now ready to proceed to the installation!
 
-<p align="center">
-  <img src="../../../../assets/OpenCoreSonomaRecoveryInstallation1.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/OpenCoreSonomaRecoveryInstallation1.png"><img src="../../../../assets/OpenCoreSonomaRecoveryInstallation1.png" alt=""></a>
 
-<p align="center">
-  <img src="../../../../assets/OpenCoreSonomaRecoveryInstallation2.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/OpenCoreSonomaRecoveryInstallation2.png"><img src="../../../../assets/OpenCoreSonomaRecoveryInstallation2.png" alt=""></a>
 
 Second Boot Phase
 
-<p align="center">
-  <img src="../../../../assets/OpenCoreSonomaSecondBootPhase.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/OpenCoreSonomaSecondBootPhase.png"><img src="../../../../assets/OpenCoreSonomaSecondBootPhase.png" alt=""></a>
 
 Third Boot Phase, further unpacking.
 
-<p align="center">
-  <img src="../../../../assets/OpenCoreSonomaThirdBootPhase.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/OpenCoreSonomaThirdBootPhase.png"><img src="../../../../assets/OpenCoreSonomaThirdBootPhase.png" alt=""></a>
 
 {: .note }
 You may get a fourth reboot, if not, eventually, you will the proper name of your drive:
 
-<p align="center">
-  <img src="../../../../assets/OpenCoreSonomaInstallationComplete.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/OpenCoreSonomaInstallationComplete.png"><img src="../../../../assets/OpenCoreSonomaInstallationComplete.png" alt=""></a>
 
 Here we are at the desktop of our Virtual Machine.
 
-<p align="center">
-  <img src="../../../../assets/macOSSonomaDesktop.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/macOSSonomaDesktop.png"><img src="../../../../assets/macOSSonomaDesktop.png" alt=""></a>
 
 Our OpenCore image is mounted easily and recognized by macOS. Allowing easy modification within and out of the Virtual Machine. Any changes made here, can easily be viewed by mounting on the host. This can be useful for moving small files.
 
-<p align="center">
-  <img src="../../../../assets/macOSSonomaNoMountEFIneeded.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/macOSSonomaNoMountEFIneeded.png"><img src="../../../../assets/macOSSonomaNoMountEFIneeded.png" alt=""></a>
 
 <h2 align="center">Now that macOS is installed, we can now do GPU Passthrough!</h2>
 

diff --git a/docs/_infocenter/07-XML/00-ImportingXML.md b/docs/_infocenter/07-XML/00-ImportingXML.md
@@ -14,9 +14,7 @@ Run the following command in the root directory of DarwinKVM:
 
 Which will now allow you to view it in Virt-Manager.
 
-<p align="center">
-  <img src="../../../assets/VManTemplateImport.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManTemplateImport.png"><img src="../../../assets/VManTemplateImport.png" alt=""></a>
 
 Notice this template is missing a few things you must set up.
 

diff --git a/docs/_infocenter/07-XML/01-ConfigDisplay.md b/docs/_infocenter/07-XML/01-ConfigDisplay.md
@@ -8,16 +8,12 @@ nav_order: 2
 # Configuring Virtio Display
 #### This is required to have a display.
 
-Select the "Add Hardware" button and navigate to Graphics. Select the ``Listen Type:`` to None. then select the "Finish" button.
+Select the "Add Hardware" button and navigate to Graphics. Select the ``Listen Type:`` to ``None``. then select the ``Finish`` button.
 
-<p align="center">
-  <img src="../../../assets/VManAddRecoveryDisplay1.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManAddRecoveryDisplay2.png"><img src="../../../assets/VManAddRecoveryDisplay2.png" alt=""></a>
 
 Select the Video tab on the left-hand side, and choose the ``Virtio`` model.
 
-<p align="center">
-  <img src="../../../assets/VManAddRecoveryDisplay2.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManAddRecoveryDisplay2.png"><img src="../../../assets/VManAddRecoveryDisplay2.png" alt=""></a>
 
 ## You can now continue to the next <a href="../02-ConfigDrives">page</a>.
diff --git a/docs/_infocenter/07-XML/02-ConfigDrives.md b/docs/_infocenter/07-XML/02-ConfigDrives.md
@@ -12,20 +12,13 @@ nav_order: 3
 
 Select the "Add Hardware" button to bring up the Storage prompt. Select the OpenCore image via the "Manage..." button. The ``Bus type:`` should be set to VirtIO. Cache mode set to none, and Discard mode is set to unmap.
 
-<p align="center">
-  <img src="../../../assets/VManAddVirtIOInstallation2.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManAddVirtIOInstallation2.png"><img src="../../../assets/VManAddVirtIOInstallation2.png" alt=""></a>
 
-
-<p align="center">
-  <img src="../../../assets/VManAddOpenCore1.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManAddOpenCore1.png"><img src="../../../assets/VManAddOpenCore1.png" alt=""></a>
 
 Don't forget to set it as your boot drive.
 
-<p align="center">
-  <img src="../../../assets/VManAddOpenCore2.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManAddOpenCore2.png"><img src="../../../assets/VManAddOpenCore2.png" alt=""></a>
 
 ## Creating a Virtual SSD for installation
 
@@ -36,8 +29,6 @@ To create a virtual SSD, when selecting the "Add Hardware" button to bring up th
 
 Here you can see me creating the disk image I'll be installing macOS on.
 
-<p align="center">
-  <img src="../../../assets/VManAddVirtIOInstallation.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManAddVirtIOInstallation.png"><img src="../../../assets/VManAddVirtIOInstallation.png" alt=""></a>
 
 ## You can now continue to the next <a href="../03-ConfigNIC">page</a>.
diff --git a/docs/_infocenter/07-XML/03-ConfigNIC.md b/docs/_infocenter/07-XML/03-ConfigNIC.md
@@ -12,8 +12,6 @@ nav_order: 4
 
 Select the "Add Hardware" button and choose the Network category on the left-hand side. You can now see your network source settings, for the default network you simply have to set the model to ``virtio``. 
 
-<p align="center">
-  <img src="../../../assets/VManDefaultNetworkNIC.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManDefaultNetworkNIC.png"><img src="../../../assets/VManDefaultNetworkNIC.png" alt=""></a>
 
 ## You can now continue to the next <a href="../04-Review">page</a>.
diff --git a/docs/_infocenter/07-XML/04-Review.md b/docs/_infocenter/07-XML/04-Review.md
@@ -8,9 +8,7 @@ nav_order: 5
 # Finished Example
 #### Notice the display, drives, and NIC added.
 
-<p align="center">
-  <img src="../../../assets/VManExampleReadyToInstall.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/VManExampleReadyToInstall.png"><img src="../../../assets/VManExampleReadyToInstall.png" alt=""></a>
 
 <h2 align="center">Depending on your decision of using the Recovery or Offline Installer, you may now proceed to installing the OS.</h2>
 

diff --git a/docs/_infocenter/08-sGPUpt/02-HookModification.md b/docs/_infocenter/08-sGPUpt/02-HookModification.md
@@ -16,8 +16,6 @@ sudo nano /etc/libvirt/hooks/qemu
 
 Example modified file:
 
-<p align="center">
-  <img src="../../../assets/QEMUHookModification.png">
-</p>
+<a href="https://raw.githubusercontent.com/royalgraphx/DarwinKVM/main/docs/assets/QEMUHookModification.png"><img src="../../../assets/QEMUHookModification.png" alt=""></a>
 
 ## You can now continue to the next <a href="../03-VManUpdate">page</a>.