This is a cache of https://vccplus.brianholman.com/manuals/users-handbook/desk/. It is a snapshot of the page as it appeared on 2026-11-21T00:00:45.817+0000.
Find your way around · 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 1 of 10

Find your way around

You can tell quite a lot about a CoCo before pressing a single key. Look at the top of its window to see which machine you have. Look at the bottom to see whether it is running and what you have put in its drives. The part in between is yours to rearrange.

Bring the app onto your Mac

For the packaged edition, use a Mac running macOS 14 or later, with an Apple Silicon or Intel processor. Open the VCC Plus disk image in Finder. Copy VCC Plus to Applications, let the copy finish, eject the disk image, and open the copy in Applications. The disk image on the Mac delivers the app. A CoCo disk image, such as a DSK, is a file you put into one of its emulated drives.

The packaged setup used in this book includes the machine ROM, disk controller firmware and starter media. The first launch makes local working copies for you. Saving a BASIC program to your starter disk writes to your own copy. If your edition asks you to open a ROM, choose the appropriate CoCo 3 system ROM that you have available; the hardware section explains how this differs from choosing a cartridge. The development tools and the books work locally. Looking up a title in the Software Library and downloading that title are separate actions.

Read your desk

On a fresh installation with the supplied ROMs, VCC Plus starts in Disk BASIC. The small Using your CoCo card tells you how to get going with that particular setup. Click outside the card to put it away. The ⓘ button at the lower right brings it back. If someone else has already set up this Mac, look at the profile name and the attached media before changing anything.

System view shows the running Disk BASIC setup, with Hello World.dsk in FD0 and Hello World.cas attached. Camera, capture options and video controls sit above the toolbar; the information button at the lower right opens the setup guide.

Start with three landmarks:

  • The nameplate and the badge. The number on the left is the amount of RAM in this CoCo. The badge on the right identifies its processor. Click either to inspect Machine Settings. You can look and close the window without applying a change.
  • The screen. The lettering inside the monitor comes from the CoCo. On a Disk BASIC startup screen, OK means BASIC is ready for a command. A game may draw its own title or ask you for a key instead. Pause in the toolbar means the machine is running and you can pause it. Run means you can start or resume it.
  • The bottom edge. Read the status word at the left. A filename beside FD0 identifies the disk image in floppy drive zero. Select that name to inspect the drive. A tape or hard-disk name opens its corresponding window. A name here tells you which medium is attached. To find a program inside it, use the guest's directory or loading instructions.

Locate a device without guessing

Choose Display → Interactive System. Move the pointer over the monitor's lower bezel, then over a drive face. The blue outline follows the target. Show Clickable Areas draws a thin dashed outline around all available targets. Turn it off when you want to see the artwork on its own.

Try one round trip. Click Devices at the upper left, find floppy drive zero and open its disclosure. Compare the filename there with the FD0 name below the picture. The list also reaches a Multi-Pak slot hidden behind a cartridge. Connections helps trace each group of drives back to its controller. Turn it on when you want to know how a disk request reaches a drive.

On the desk What you can do there
Wooden bookshelf Open the Software Library to look for something to run.
Keyboard case or joystick Find input controls. Click the screen when you want to type into the guest.
Tape recorder or printer Inspect the transport or open Printer Output. Export a new tape or save the captured printout when you want to keep it.
Monitor bezel Choose a video signal. Click Expand monitor below the picture for a larger live display.
Multi-Pak switch and numbered slots Inspect the startup slot and see which cartridge or controller occupies each position. An actual slot change may restart the CoCo.
Floppy or hard-drive face Read its name and status. Open its drive window for all file choices.

Make room for the display

Choose Display → Expand Monitor, or press Shift-Command-E from System view. The monitor comes forward inside the same window. Choose Return to System to put it back. Try Display → Conventional Display if you want the picture to occupy most of the window as you work. The System and Display buttons in the toolbar make the same choice.

The running program, sound and attached media belong to the machine. Switching views lets you look at it another way. A custom hardware combination may require conventional controls. If you see Custom configuration, use Cartridges… to inspect the actual devices. Your installed cards can stay where they are.

Keep the emulator and this book side by side

In System view, click the red help button below the Multi-Pak to open the manual index. From either view, Help → Manual Library… brings the reader forward. Move the reader to one side and the emulator to the other. From a chapter, choose a numbered Contents entry to change chapters, or a topic below the current chapter to jump within it. Use Book contents to search this volume, or Manual Library to search the whole shelf. Select a figure to open it at full size and go Back to your place.

The reader remembers where you left it. Close and reopen the window, or quit and relaunch VCC Plus, then open Manual Library to continue. Each book keeps its own reading position. A topic link, search result or bookmark takes you to that specific location rather than restoring a different page. Library Home still returns to the shelf deliberately. These reading choices stay on this Mac; opening a book does not restore or run a CoCo program.

Keep a manual bookmark

While reading, choose the toolbar's Bookmark this location icon. Its filled bookmark symbol identifies a location already saved; clicking it again finds the existing bookmark instead of adding a duplicate. You can keep several useful places in each book. Reading farther changes your last-read position without moving those bookmarks.

Choose Bookmarks, the list icon beside it, to open the one bookmark list. All Books groups locations by book; This Book shows only the book you are reading. Bundled CMOC and LWTools reference manuals appear under their own names. The list is for the manuals, separate from Software Library's Favorites.

Select a bookmark to open it. Its actions menu also offers Open, Open Book, Rename… and Remove Bookmark. Rename supplies your own reminder while retaining the original section name. Removing a bookmark does not remove a book or its contents. If an updated book no longer has that exact section, the reader keeps the bookmark and reports Location changed. Use Open Book to find a new place deliberately. Bookmarks and reading positions stay outside disposable document caches and are not included in update-check statistics.

The Bookmarks popover offers All Books and This Book. Here This Book lists a saved location in the User’s Handbook, with an actions menu beside it. The filled bookmark symbol identifies the saved reading location.

To find a word on the page you are reading, choose Find on This Page in the reader toolbar or press ⌘F. The counter shows your place among the matches. Use ⌘G for the next match and ⇧⌘G for the previous one. Press Escape to return to the page.

The magnifying glass beside Ask the Manuals opens page Find. Here the reader highlights the first of 18 matches for “CoCo.”

The book window has its own keyboard focus. To send the next character to the CoCo choose Input → Focus CoCo Display. If you click the emulator's red close button while reading, choose File → Show Emulator (Command-1) to bring the same session back. A half-finished flight number makes a good way to prove this to yourself.

New to the green OK prompt? Get your first reply. Returning from a physical CoCo? Match the hardware to the Mac controls.

Ask the Manuals

Choose Ask the Manuals in the reader toolbar to search the twelve books written for VCC Plus and installed with the app. Type one or more keywords. Try joystick keyboard to find sections that mention both, or PRINT@ to look up that exact command. Matching is case-insensitive and keeps punctuation in command names.

A PRINT@ search lists the command reference first, followed by examples that use it.

Select a section title to open it. Each result shows the book, chapter, and an excerpt with matching words highlighted. Choose Back to return to your results. The shelf in a browser uses the same offline search.

Find a page in the Color Computer Archive

Help → Archive Library… is the place to browse period manuals, magazines, diagrams and supporting documents. Manual Library contains the books written for VCC Plus; Archive Library searches the historical collection preserved by the Color Computer Archive. Reading either leaves the running CoCo and your development documents in place.

Leave Search Archive empty to browse. Choose All Documents, or a collection in the sidebar such as Magazines. Expand publication folders to see issues grouped by year where the filenames supply dates. At the bottom of the list, the previous/next result buttons move through further batches. In a narrow window, Collections opens the sidebar.

For a lookup across publications, choose Entire Archive in the scope picker and type a few words, such as JOYSTK or MOTD strip buffer. Results are matching pages or sections, grouped under their publication titles. To limit a search, choose the intended collection and select that collection in the scope picker. Typing a query does not by itself open the first result. Click the page or section you want, or move the selection with the arrow keys. Clearing the query returns to the browse list.

A title opens with one click; no separate Read or Download button is required. If the file is not cached, the reader shows Downloading…, the amount received and verification progress. Cancel stops that transfer; Try Again retries a canceled or failed load. Verified cached originals and the installed index can be used offline. A first download still needs a connection and enough local storage. In compact view, Browse or Results returns from the reader to the list; Return can reopen the selected row.

Archive Library remembers your collection, search/scope, selection and useful list position after closing the window or relaunching. Each document also keeps its own reading position, including supported PDF zoom and text/image scroll. A search hit still opens the exact cited location; it takes precedence over an older remembered page. Clearing the query returns to your browse context. Reading history stays local and does not grant an assistant new access.

From Software Library, a title's Guides & References can bring you directly here. A Raaka-Tu walkthrough, for example, opens as text separate from the game's main manual. The source software selection and running CoCo remain in place.

Raaka-Tu Walkthrough opens directly as text in Archive Library. Its Walkthroughs collection stays visible, and Archive source and Copy Citation retain the Color Computer Archive reference.

Read the kind of document you found

What opened Controls to use
A PDF scan Previous/next page, the page-number field, zoom and Fit. A search hit opens its cited physical PDF page. Find in PDF and Find Next search the PDF's own text layer; Command-F focuses the field.
A photograph, map or diagram Zoom in, Zoom out, scrolling and Fit Image. Fitting changes the preview, not the original file.
Plain text, including a text listing Select text and use the Mac's Copy command or Command-C. This is a read-only viewer; paste into an appropriate working document to edit it.
Indexed web, mail, word-processing or worksheet text Read the extracted text in the app. Longer items have previous/next section controls and a section-number field. Worksheets retain row references and tabs when copied; this is not a live spreadsheet application.

Archive source opens the upstream document or parent archive. Use it when an edition cannot be displayed in the app, a cited PDF page cannot be opened, or you need the original layout rather than indexed text. A filename and a search excerpt alone do not prove a document is the edition you expected; check its title, collection, page and any ZIP member named above the reader.

A walkthrough opens as selectable text inside Archive Library. It remains a historical reference rather than an editable guest program.
An archived Sierra map opens directly in the image reader with Fit Image and zoom controls.

Copy text without mistaking OCR for source code

An OCR match means the search index recognized words from a page image. It does not mean the displayed PDF has a selectable text layer, and it does not mean its program listing has been corrected. A search can find the right page even when Find in PDF reports no matching text. The image viewer itself has no OCR-to-code button.

If the PDF has selectable text, select the passage and press Command-C. Plain-text and indexed-text views also support selection and copying. Check copied program text against the scan: zeros and letter O, ones and letter I, quotes, punctuation, line wrapping and BASIC line numbers can be misread or rearranged. A selected paragraph, a search excerpt and a complete runnable program are different things. Preserve the original reference while you repair a working copy.

Use a reviewed example or snippet

On selected PDF pages, actions above the scan provide a reviewed source rendition associated with that exact publication edition and page range. These actions are available only where the index contains such a rendition. Their absence on another page is normal.

Action What goes to your clipboard or workspace
Copy Snippet The selected reviewed fragment as plain source text, including its stored line breaks. It can depend on definitions or surrounding code elsewhere in the article.
Copy Example The selected reviewed example's source text. Read its language and provenance before deciding where to paste it.
Open in BASIC Editor A complete reviewed BASIC program in its own BASIC Example workspace. This action is offered for BASIC programs, not every listing.
Example source information or Examples on this page The example title, language, author and provenance notes. When a page has several examples, choose the intended title before copying or opening it.

For a concrete fragment, search MOTD strip buffer and open MOTD 1986 04, PDF page 4. Copy Snippet supplies Strip's character constants. On PDF page 12, the buffer-setup snippet has different instructions and depends on definitions elsewhere in the listing. The provenance notes identify what was transcribed or checked; neither fragment is the whole Strip utility.

The Strip article opens at the cited physical PDF page. Copy Snippet and Example source information identify the reviewed source associated with that page; Copy Citation keeps the Archive reference.

For complete BASIC programs, the January 2005 CoCo Nutz! issue offers Mini Data Base and Pill on physical PDF page 13. Choose the title under Examples on this page, then Open in BASIC Editor. Each reviewed source has a separate, recoverable workspace. Reopening the same example can return to your existing edits or recovered draft. Use the editor's Save or Save As… to keep a named Mac source document.

Opening an example does not overwrite your main BASIC document, load the CoCo or execute the program. Inspect the source and the required environment first. Load into CoCo and Run are explicit editor actions. They validate the numbered source and retain the usual confirmation before replacing an unrelated guest BASIC program or taking over an assembly session. Save any program and variables you need before confirming replacement. The editor rechecks the source before transfer; if you changed it while deciding, review the current version again.

There are currently no direct Open in C Editor or Open in Assembly Editor buttons in Archive Library. For C or assembly material, copy the reviewed source or verified text, create or choose the intended document in the corresponding workspace, and paste there. Preserve an existing draft before replacing its contents. Add any required headers, symbols or surrounding project files deliberately; then compile or assemble and test through that workspace. Copying a listing does not configure its build or prove it runs on the selected processor.

A reviewed rendition records a specific review or correction, not a guarantee that every historical program works in every setup. If Example information could not be read or This example is unavailable in this Archive index appears, use the scan and its citation; do not substitute an unrelated listing just because its name is similar.

Keep the source of what you copied

Copy Citation is separate from copying code. It gives the publication, the current page or section, any ZIP member name and the original Color Computer Archive link. Keep the physical PDF page distinct from a printed page number. After pasting the source into your working document, copy the citation into your notes or an appropriate source comment, and keep the author/provenance from the example information as well. Copy Citation replaces the clipboard's previous contents.

The scan or asset may be delivered from VCC Plus hosting and cached locally. Its citation still identifies the Color Computer Archive as the source. Cached original bytes and a reviewed source rendition have separate identities: editing your example does not change the archived scan, and corrected code should not be described as an unchanged transcription unless its provenance says so.

Let an assistant search the Archive

The Archive window's connection control offers Save Archive Search Connection…. This separate, read-only connection permits Archive searches and citation lookup. It does not grant control of the CoCo or a development project, and finding a citation is not proof that the assistant read the scanned page or validated its code. Keep VCC Plus open, and use Revoke Archive Access when finished. For project-editing permissions, see Work with an assistant.

App updates and your sharing choice

VCC Plus → Check for Updates… asks the website whether a newer compatible download is available. Updates & Privacy… shows the current version and build, offers the same check, and lets you choose whether to check when the app opens. An available update offers a DMG download. Open that image and install the app yourself when your work is safely saved; checking does not replace the app or restart the CoCo. If the website cannot be reached, keep using the app and try again later.

The first check asks whether you will share basic platform information to help understand the types of Macs people use. Share includes macOS major/minor version, Apple Silicon or Intel processor family, primary language, configured region and a random installation ID. Don't Share leaves those optional details out. Either choice is remembered across app updates, and checks and downloads work either way. Your configured region is a preference, not a measurement of your physical location. The app does not send your documents, disks, assistant conversations, account name or hardware identifiers.

Change Share basic platform information in Updates & Privacy at any time. Reset Installation ID starts a new statistical identity; it does not erase earlier server history. The update service records checks and download-button selections in a private history. Website hosting and security logs are separate from optional app statistics. Privacy Information opens the website's full description. DriveWire has equivalent commands and remembers its own sharing choice and installation ID independently.

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