Using VirtualBox to run Purple Pen on Mac OS X or Linux

Although Purple Pen is a Windows-only program, you can use the free Virtual Box program to run a virtual machine on your Mac or Linux computer. Within that virtual machine, you can run a copy of Windows, and inside that copy of Windows, download and run Purple Pen. This document gives an overview on how to set this up.

Your main computer and operating system (Linux or Mac OS X) is called the "host" computer. You will need approximately 20 GB of free disk space on your host computer.

First, you need to download a copy of Windows 10 in the form of an "ISO" file; a file with the .iso extension. This is a very large file (around 4 GB), which can be treated by Virtual Box as a DVD disc. To download this ISO file, I recommend reading the following article and following the instructions: https://www.windowscentral.com/you-do-not-need-activate-windows-10  If that site no longer exists, try downloading the Windows 10 download tool at  http://www.microsoft.com/software-download/windows10

Once you have the Windows 10 ISO file on your host computer, you need to install VirtualBox. Browse to https://www.virtualbox.org/ Click the large "Download" button, then download one of the platform packages, either "OSX hosts" for a Mac, or "Linux distributions" for Linux. Download and run the installation. For Mac, the installation may at first be blocked from installing a system extension. If that happens, allow the system extension to be installed through Settings, and run the installation again.

Once VirtualBox is installed, run it. From the Virtual Box Manager window, click "New". Select Type as "Microsoft Windows" and Version as "Windows 10 (64-bit)". On the next screen, I recommend 4096MB Memory Size. On the new few screens, select to create a virtual hard disk now, VDI file type, dynamically allocated, and 20 GB in size (go larger if you intend to install significant other software besides Purple Pen; otherwise 20 GB is enough.)

Now click the Start button in the Virtual Box Manager window. Another Virtual Machine window should appear, which prompts you to select a virtual optical disk file. Click the folder icon with the small green up arrow, and select the Windows 10 ISO file that you downloaded at the beginning of this process.

After a short time (or maybe long, depending on the speed of your computer), your VirtualBox window should now show the Windows 10 installation program. Continue through the Windows 10 installation. If you haven't purchased a product key, you can select "I don't have a product key" at the bottom of the "Activate Windows" screen. Select "Windows 10 Home" as the operating system to install, and choose "Custom: Install Windows only (advanced)" when asked what type of installation. For the rest of the installation you should be able to use the default options. At this point, it may take half an hour to an hour to install Windows.

After the Windows installation is finally complete, use Microsoft Edge (the Windows web browser) in your Virtual Machine to navigate to "http://purple-pen.org" and download and install Purple Pen.

When you close the Virtual Box window, it's easiest to select "Save Machine State". The next time you start Virtual Box, select "Start" on your virtual machine and you will be back in Purple Pen right away.

You can get improved performance and better ease of use by installing the Virtual Box "Guest Additions". From the Virtual box menu bar, from the "Devices" menu, select "Insert Guest Additions CD Image". Then, from the Windows File Explorer in your virtual machine, select the "D:" drive, and run the "VBoxWindowsAdditions" program. Be sure to allow it to install the device drivers that it needs to. Reboot the virtual machine when finished. You should only need to do this once in each virtual machine that you create.

It is important to realize that your "virtual" Windows computer has a separate, "virtual" disk and file system. Your host computer files will not show up directly on the virtual Windows computer, you can't access any files on the virtual Windows computer from your host operating system. If you installed the VirtualBox "Guest Additions" as explained above, you should be able to access your host computer files as a network drive from your Windows installation with the shared folders feature of Virtual Box (on the Devices menu). If you can't get that to work, using a network file service such as OneDrive, DropBox, or Google Drive can be useful to transfer files back and forth from you virtual Windows to your host computer operating system.

Once you are complete with installing Windows, you can delete the Windows installation ISO file from your host computer.

If you have questions, please use the Purple Pen Yahoo Groups email mailing list for questions.