Logo

Retro computing with a touch of modern and the home for all things, retroCombs (aka Steven Combs).

Disclosure Statement: When you click on links to various merchants on this site and make a purchase, this can result in this site earning a commission. Affiliate programs and affiliations include, but are not limited to Amazon, the eBay Partner Network, and/or others.

Custom Stickers, Die Cut Stickers, Bumper Stickers - Sticker Mule
4 February 2023

Install C64 OS using the VICE Commodore Emulator

by Steven B. Combs, Ph.D.

You have C64 OS and you can’t wait to install and play with this new incredible operating system for the beloved Commodore 64. The only problems is, your C64 is kaput or has yet to arrive from that eBay seller who promised it you days ago. Never fear! You can install C64 OS on VICE for Windows or Mac and I’m going to show you how to get C64 OS up and running as quickly as possible.

I show how to install C64 OS on VICE 3.7 for Mac; however, the steps are almost identical in Windows. I’ve not yet tried this on Linux, but hope to give that a shot later. Let’s get started.

Table of Contents

Support the Blog and Channel

Check out the supporters page to learn about my amazing supporters and how you can join our community.

Companion YouTube Video

Title: Install C64 OS using the VICE Emulator on a Mac or Windows Computer

Video Errata

None as of 2023-02-04.

I use affiliate links. Thanks for your support of the blog and the YouTube channel when you use these links.

  1. C64 OS Simplified VICE Configuration
  2. C64 OS
  3. CMD HDD Boot ROM 2.80 Binary Image - RETRO Innovations
  4. JiffyDOS 64 KERNAL ROM Overlay Image - RETRO Innovations
  5. Insync
  6. VICE - the Versatile Commodore Emulator

Required Files

Before you install C64 OS on VICE, you will need to make two required and one optional purchase:

  1. Required: C64 OS - There are two bundles available: Starter for $59 CAD and Standard $64 CAD. I use the Standard bundle and recommend you spend the extra $5 CAD.
  2. Required: CMD HDD Boot ROM 2.80 Binary Image - RETRO Innovations for $8.00. This is the ROM VICE required to read and write a virtual CMD HD device.
  3. Optional: JiffyDOS 64 KERNAL ROM Overlay Image - RETRO Innovations for $8.00. This is not required, but will significantly speed access to the CMD HDD virtual device.

Prepare Files

This next step is optional and a matter of choice; however, I recommend you copy the contents of the C64 OS card to a cloud drive and synced to a local drive your Mac. This provides three advantages:

  1. You have a backup.
  2. Once configured, you can port your C64 OS environment to another Mac or PC.
  3. With Google Drive, you have versioning so you can back up to a previous version of your C64 OS install.

Below are the steps I used to sync with Google Drive:

  1. Created a new folder within my Mac’s Google Drive folder (that is synced using Insync tool) called C64 OS ver 1 and then copied the contents of the C64 OS SD card into that folder, as shown in the image below:

    SD Card Files

  2. Copy the required CMD HDD ROM ( doscmdh_v280.bin) and the optional JiffyDOS ROMs (jiffydos_c64.bin and jiffydos_c1541.bin) into the vice support folder. There are other files in that folder we will use later.

Install VICE

The next step is optional if you already have a VICE install; however, in December 2022 the developers released version 3.7 and I recommend the upgrade. The previous version, 3.6.1, had several Mac GUI issues.

  1. Download VICE - the Versatile Commodore Emulator
  2. VICE for Mac doesn’t have a native installer. Unpack the archive to get a folder full of emulators and tools.

  3. Drop the folder into the Applications folder.

    NOTE: I’m sure others will tell me, “NO!!!” since the folder includes command-line tools. I deal with those in another way and I will not cover in this blog post.

  4. Open ~/Applications/VICE 3-7-1/x64sc.app to ensure the application works properly.

Vice on Mac

Configure the Pointing Device

C64 OS requires the use of a joystick or 1351 mouse. You can’t connect original 9 pin DIN devices directly to your Mac, but you can configure VICE to use your trackpad or connected BT or USB mouse as a Commodore 1351 Mouse. Let’s set that up using the steps below:

  1. From the pull-down menu, select Preferences | Settings | Input devices | Control port.
  2. Use the Control Port #1 drop-down selector to choose Mouse (1351).

  3. While on this page, ✓ the Save settings on exit option to ensure VICE continually saves your preferences. Your dialog box should look similar to the one below:

    Control Settings

  4. Select the Close button.

ROM Configuration

Remember those JiffyDOS and CMD HDD ROMs we downloaded and you placed in the vice support directory? It’s time to use the ROMs in the steps below:

  1. Select Preferences | Settings | Machine.
  2. Ensure Machine ROMs is highlighted.
  3. Click the Browse… button to the right of the Kernal option.

  4. Navigate to the vice support folder you created earlier on the Mac and select the jiffydos_c64.bin file as shown below:

    Machine ROM

  5. Click the Open button.
  6. Click the Drive ROMs option at the top of the page.
  7. Click the Browse… button to the right of the 1541 option.

  8. Navigate to the vice support folder and select the jiffydos_c1541.bin file as shown below:

    Drive ROM

  9. Click the Open button.
  10. Click the Browse… button to the right of the CMD HD option.
  11. Navigate to the vice support folder and select the doscmdhd_v280.bin file as shown above.
  12. Click the Open button.
  13. Leave the Settings dialog box open.

Configure and Attach Virtual Floppy Drives

Configure the virtual drive 8 to use JiffyDOS and access a .d64 disk image within C64 OS.

  1. From the open Settings dialog box, select Peripheral devices | Drive.
  2. Optional - ✓ the Drive sound emulation option.
  3. Optional - Adjust the Drive volume: to 50%.
  4. Ensure Drive 8 tab is highlighted.
  5. Select CBM 1541-II in the Drive model pull-down menu.
  6. ✓ the True drive emulation option.

  7. The dialog box should look like the one below:

    Drive Settings

  8. Click Close to close the Settings dialog box.

NOTE: To attach a virtual disk image to C64 OS, select File | Attach disk image | Drive #8 and when the file selection dialog box appears, navigate and select the .D64 disk image. If you don’t have a virtual disk image, you can create one using the File | Create and attach an empty disk image … option.

Configure and Attach Virtual CMD HD

With drive #8 configured to support virtual floppy disks, it is now time to configure drive #9 to emulate a CMD HD.

  1. Select Settings | Peripheral devices | Drive and highlight Drive 9.
  2. Select CMD HD in the Drive model pull-down menu.
  3. Verify the CMD-HD fixed size is 8G.

  4. The dialog box should look like the one below:

    CMD HD Settings

Let’s attach the CMD HD to drive #9.

  1. Close the Settings dialog box.
  2. Select File | Attach disk image | Drive #9 from the pull-down menu.

  3. Select the c64os v1.0.dhd found in the vice support folder. When you select the file, VICE will present a preview like the one found below.

    Attach CMD HD Drive

  4. Select the Attach / Load button.

Your virtual C64 OS CMD HD is attached. The next step is to configure C64 OS.

Configure C64 OS

We will use a Commodore 64 program, the C64 OS configure tool, to prepare the OS to boot. Type the commands below in Commodore 64 immediate mode:

@#9
@CD//OS/SETTINGS
↑CONFIGURE

HINT: The ↑ is not the up arrow on the Mac keyboard. Use ⇧ + 6 to enter this character.

The Configure Tool will load as shown below:

C64 OS Configure Tool

I won’t cover each option in the configure tool. The goal of this blog post is to get you up and running as quickly as possible using VICE. The list below provides the option (in bold) I used.

  1. Display time in the menu bar? = Y
  2. Use 12 hour time? = N
  3. Blink the seconds indictor? = Y
  4. Which mouse pointer? = 1
  5. Mouse speed? = 20
  6. Double-click delay? = 480 ms
  7. Pointer inner color? = black
  8. Pointer outer color? = l.grey
  9. Mouse hand right or left? = R
  10. Show CPU busy indicator? = Y
  11. Toggle menu bar: CTRL+space Accept? = Y
  12. Toggle status bar: CTRL+COMMODORE+space Accept = Y
  13. Toggle GFX mode: COMMODORE+← Accept = Y
  14. Take screenshot: CTRL+COMMODORE+p Accept = Y
  15. Which status bar mode at boot-up? = 1
  16. How many fast app switching slots? = 0KB
  17. Double click free memory to open: = 1
  18. Display memory values in: = 1
  19. Realtime clock driver? = 4
  20. Pointer input driver? = 1
  21. Configure default places? = Y

Once you make the choices, a Configuration Complete prompt will appear along with the READY prompt. You can return to the Configure Tool to make changes when you become more familiar with C64 OS.

Reset VICE

I’ve found after using the configuration tool that a VICE hard reset makes things smoother. Follow this step:

  1. Select File | Reset | Hard Reset

VICE will reset and remove your attached drives. This is not an issue! We will reconnect our CMD HD.

Boot C64 OS

The easiest way to boot C64 OS is to attach the .dhd disk image and use the Autostart feature following the instructions below:

  1. Select File | Attach disk image | Drive #9 from the pull-down menu.
  2. Select the c64os v1.0.dhd in the vice support folder.
  3. Select Autostart.

VICE will attach the drive and load the first program on the drive, C64 OS.

I won’t cover each option in the C64 OS Setup Tool. The selections I use are below.

  1. Yes, I have read and agree. = Y
  2. Fresh installation. = C
  3. C64 OS Device # = 9
  4. C64 OS Partition # = 1
  5. System Directory? = os
  6. Is that correct? [y/n] = y
  7. Options: = b

C64 OS startup will begin as shown in the image below:

C64 OS Startup Screen

After the C64 OS setup screen appears, C64 OS is ready to use, as shown in the image below:

C64 OS Intro Screen

Using the Pointing Device

It may frustrate you, at this point, to use the mouse or trackpad. Never fear, use the ⌘ + M to “capture” the mouse movements in the C64 OS environment. Use the same keyboard combination to return the pointing device back to Mac OS.

Exit and Load C64 OS

I’m going to the use of C64 OS in this blog post. This is a software best left to the user. Dig in, click here, click there, and have a great time exploring. When you are done:

  1. Select Options | Exit to BASIC in the C64 OS pull-down menu.
  2. Select File | Exit emulator from the VICE pull-down menu.

To load C64 OS for future 8-bit mousing action, use the steps below:

  1. Load VICE
  2. Select File | Attach disk image | Drive #9 from the pull-down menu.
  3. Select the c64os v1.0.dhd in the vice support folder.
  4. Select Autostart.

The dialog box will close. VICE will mount the C64 OS virtual image and auto-load the OS. If you want to speed up the loading process, you can use the VICE warp mode by clicking the warp indicator as shown in the image below; however, remember to turn off warp mode afterward or you will have issues using the UI.

VICE Warp Mode

Because we turned on the auto-save option, you will not need to go back and change any of the settings.

Homework

Want to dig in and have more fun? Try to determine how to do these things on your own:

  1. Use a virtual RAM expansion unit (REU).
  2. Use Wi-Fi to connect to a BBS.
  3. Display the fun image C64 OS includes.
  4. Play a game of chess.
  5. Change the C64 OS theme.

Conclusion

That concludes my quick installation of C64 OS in VICE. If you want to see more C64 OS content or have a question? Drop a comment below. I’d also love to read your tips and tricks to get the most out of C64 OS. That’s it for now…

… 🕹️ retroCombs OUT!