This is a cache of https://vccplus.brianholman.com/manuals/users-handbook/recovery/. It is a snapshot of the page as it appeared on 2026-11-21T00:00:56.461+0000.
Get back to a working setup · The VCC Plus User’s Handbook · VCC Plus
← Manual LibraryVCC Plus 3.7.1 · Reading on the web

Try the exercises in VCC Plus. Example links download files here; open them in the app to work beside the emulator.

The complete book · PDF editionBook 4: The VCC Plus User’s Handbook

77 pages · VCC Plus 3.7.1 · Keep a copy to read or print.

Download PDF
Contents

Chapter 10 of 10

Get back to a working setup

Before reaching for Restart, read the status at the bottom of the emulator. Then ask where the last good copy of your work lives. Those two observations can turn a scary moment into a small repair.

My keys do nothing

  1. If the emulator window is missing, choose File → Show Emulator (Command-1). A visible BASIC editor is a different window.
  2. Read the toolbar. Run is an invitation to resume. If a debugger deliberately stopped your program, switch back to its source window first and look at the highlighted line. Continue there when you are ready.
  3. Choose Input → Focus CoCo Display. At a BASIC input question, type a digit and look for it before pressing Return. In a game, consult its manual or readme for the key or joystick port it expects.
  4. If only a few keys go missing, open Input → Keyboard and Joysticks…. An assigned keyboard joystick can consume arrows and fire keys. If punctuation lands in surprising places, check Keyboard mode. Find the keyboard again separates window focus from input mapping.

Run and Restart are unavailable while Disk Image Editor is open. A mounted disk's editor deliberately pauses and locks the machine. Finish its private edits with the appropriate save/apply action, or close it and decide whether to discard them. Closing releases the lock and leaves the CoCo paused. Click Run when you are ready; see Edit files inside a disk image.

The picture, speed or sound seems wrong

A game is in black and white. Try Display → Composite TV while the game waits for input. Allow a frame to be drawn. If orange and blue appear on opposite sides from the colors you remember, try the alternate composite phase. For a CoCo 3 program designed for an RGB monitor, select RGB Monitor. Compare the two landing pads.

The monitor has empty space around it. Check Display Settings…. Integer Pixels leaves room when another whole multiple of the image would be too large. A fit-to-window choice uses more of the space while respecting the picture's shape. In System view, Expand Monitor gives some of the desk space back to the screen.

Time races or a tone goes quiet. Look for Machine → Fast-forward. Return to normal speed, check Run/Pause, and open Media → Cassette… to inspect app sound and volume. The cassette transport and app sound control different things. Your Mac's selected sound output and its own mute or volume still apply. If the game alone sounds wrong, check the title's required sound cartridge.

I cannot see the program or the drive I expected

What you see First check Where to go
A Software Library search turns up empty Select All Software, clear filters and shorten the title. The Cover Collection shows a subset. Find a title
BASIC lists somebody else's files Read the active profile and the mounted filename. FD0, a hard-disk volume numbered zero and an SDC mount numbered zero can each answer a directory request in their own setup. Which drive zero?
The filename is remembered but the drive is unavailable Check that the device's controller is connected; then locate the original Mac file if it moved. Reconnect external storage or choose the correct replacement. Floppy file safety
The controls show a controller but a cartridge starts instead Check the Multi-Pak startup switch and the live routing. A running program can select a different ROM or I/O slot. See a live route change
A game ignores a moving stick Check for activity in the Mac controller preview, then in the expected CoCo port. Look up the fire button or start key in the game's instructions. Assign a port

A save needs attention

Leave the affected medium attached while you investigate. Read the message on its drive row. Write protected, Temporary changes, and a failure to write the backing file each call for a different response.

  • Protected. The guest can read the image. To keep the original as a master, make a writable practice copy and attach that for future writes.
  • Temporary changes. Edits are in the mounted working copy. Use the drive's save-to-another-file action and give the result a recognizable name before ejecting or changing profiles.
  • Failed save or changed file on the Mac. If another program changed that image, save the emulator's version under a separate name so you can compare the copies. If a disconnected volume caused the failure, reconnect it and retry. Read a discard confirmation all the way through before choosing it.
  • Tape recording needs export. Open Media → Cassette…, stop recording and export the tape to a Mac file. Closing and reopening the recorder window lets you return to the same transport. A cassette attached beside a program in RAM does not by itself save that program.

Busy lights can flash during a perfectly good save. Look for an actual message before taking recovery action. For a practice run in which the fate of each line is visible, see Keep your work.

A picture or movie did not finish saving

Open Capture Settings… from the camera disclosure or Display menu. For a failed still picture, Save Captured Image As… keeps the picture from the original click rather than taking a new one. A disconnected or read-only capture folder can be changed deliberately; the app does not silently send the file to a different destination.

For a movie, look under Retained Recordings. Try Recover MP4 after restoring storage access or choosing a writable Recordings Folder. Show Files locates the retained working movie. Partial recovery may stop at the last completed fragment. Keep those files until you have checked the recovered MP4. Recording and finalizing a long movie need free space; a failed completion is not a reason to delete other media or restart the guest. Record the CoCo picture and sound

I want my old machine back

If the Software Library changed your setup to play a title, use Return to Previous Setup there. If you made a personal profile earlier, select it under Machine → Configuration Profiles… and review its files before Load…. Both routes bring back equipment and media assignments. Loading the saved program inside the guest is a separate step.

For a familiar Disk BASIC setup, first save your Mac source, guest program, temporary images and recordings as needed. Read Machine → Restore App Defaults… before confirming. For a pristine starter disk you can experiment on, choose Create Fresh Starter Media… from the appropriate built-in profile and give the new setup a different name. Preserve your existing working disk for its saved files.

If you have already restarted and the numbered lines are gone, a matching source document or a copy saved inside an image can bring them back. Opening the same profile over and over cannot reconstruct unsaved RAM. Compare the restart choices before the next experiment.

Original VCC Plus manuals © 2026 Brian K. Holman. Third-party references retain their authors’ copyrights and licenses. Artwork notices. Edition 3.7.1; source and export identity. Printable edition: PDF source and export identity.

A closer look

Open original