NOTE: THIS WILL BE DELETED ON JAN 1, 2025. IF YOU NEED IT, DOWNLOAD THE FILES AND HOST THEM SOMEWHERE ELSE YOURSELF

This is a guide to install a pre-made VirtualBox VM image with Vivado
2018.3. To use it, you must download the image, install VirtualBox,
import the image, and run the VM.

=== Download the Image ===
 1. You can download the image (a 20GB file) from:
    https://confuzer.cloud/misc/vivado-manjaro.ova
    You should start the download and then continue to the next step
    (installing VirtualBox) while you wait since it will take a while.
    You will need about 50GB free while installing, then you can delete
    the image file afterwards and you will reclaim 20GB, so in the end
    it will only use 30GB.
 2. (Optional) Verify the checksum with:
    https://confuzer.cloud/misc/vivado-manjaro.ova.checksums.txt

=== Installing VirtualBox ===
 1. Go to https://www.virtualbox.org/wiki/Downloads
 2. Find where it says "Windows Hosts," "OS X Hosts," and "Linux Hosts"
    and click on the one for your operating system.
 3. Follow the install process. If you have trouble, search online for
        "install virtualbox [your operating system]"

=== Importing the Image ===
 1. Open VirtualBox and click on File->Import Appliance
 2. Click on the folder icon, select the image file
    (vivado-manjaro.ova), and Next.
 3. Optional: You may want to increase the allocated RAM or CPUs.
 4. Click Import and wait for it to extract the VM.
 5. If the process fails, make note of the error and search for it
    online. One possibility is that it did not have enough disk space.
    Note that it needs 50GB (20 for the image file, 30 for the extracted
    VM) during install.

=== Running the VM ===
 1. In the manager window, click on the VM on the left, then Settings.
 2. Click on "Advanced" and set "Shared Clipboard" to "Bidirectional."
    This will allow copy/paste from the VM to/from your main system.
 1. In the VBox manager window, click on the VM on the left, then Start.
 2. This will start up another window with the VM which will boot up in
    a few seconds depending on your computer.
 3. Once you make sure the VM boots up, you can safely delete the
    vivado-manjaro.ova file to save space on your computer.
 4. There are shortcuts to run Vivado on the desktop.
 5. Any files saved will be inside the VM. To copy them to your main
    operating system, you can search online how to set up a shared
    folder in VirtualBox, or transfer them with a cloud file sharing
    service if you are lazy. :)
 6. To shut down, open the start menu, type "poweroff" and hit Enter.

=== Bonus Info ===
 * If you ever need to enter credentials for the user inside the VM
    o The username is: user
    o The password is: password
 * The VM is running Manjaro Linux XFCE, a lightweight distribution.
    Since it is minimal, it leaves more resources (RAM, CPU, disk space)
    to Vivado, and saves battery life if running on a laptop.
 * To save space, Manjaro only has a limited set of apps installed, such
    as Firefox, Libreoffice (office suite), and Meld (a diff tool).
 * It also has the online version of Microsoft apps such as OneNote.
 * You can very easily install more software with the "Add/Remove
    Software" tool on the Desktop. Just open it and start typing to
    search for any software. Select what you want and hit Install.