Prerequisites - Required
- Visual Studio 2013 - Any version including Express, however Express users require additional steps (see below).
- VMWare - Cosmos can run on real hardware or in other virtualization environments (VPC, Bochs, etc) but for default builds and full debugging functionality VMWare must be used. You can use VMWare Player (free) or VMWare Workstation
Prerequisites - Recommended
- VMWare VIX API - Cosmos will run without VIX API, but some debugger functions will not fully function unless VIX API is installed. Download
- Download the latest release of Cosmos (big purple button)
- Wait for the download to complete then run the installer. Allow it to run as admin.
- Make sure VS2013 is NOT running when you do this.
- Make sure VMWare isn't running.
- Make sure you aren't about to do a Windows Update restart or something similarly stupid...
- Click "Next" then "Install"
- (if you fail this step you should give up now...)
- Wait for the install to progress. (Tip: At the end the installer may look like it is stalling, it is still doing something, just in the background)
- When finished it will very obviously say it has finished and have a "Finish" button - click the "Finish" button.
- Cosmos should now be installed. Follow other tutorials to find out how to create your first OS.
Visual Studio Express Users
- Visual Studio 2013 Isolated Shell
- Visual Studio 2013 Integrated Shell
- Follow the same instructions as for Pro/Ultimate but note this:
You should not use the Express Edition Start menu link!
Cosmos does not work with the Express editions. Express editions must be installed only to provide the necessary language tools.
When you install VS 2013 Integrated Shell, it will create a Start menu link
called Visual Studio 2013
(unless you already have a higher version installed e.g. Pro/Premium/Ultimate). Use this Start menu link!
Here's a video to help!
- When debugging in VS, DO NOT have the Autos window open or VS will probably crash!
- ASM Steppin works with VS buttons! Toggle Step Mode in asm window and use VS step buttons.
- To shut-down the debugging session you can use the stop debugging button.
- If VS crashes, do not allow windows to "try to fix the issue.." or immediately restart VS. Close VMWare first.
- If VM says "Internal error" when starting, do not despair. Just find the VMWare installer exe, run it and choose repair. You won't lose your VMs or setup.