This is a cache of https://vccplus.brianholman.com/manuals/users-handbook/keyboard/. It is a snapshot of the page as it appeared on 2026-11-21T00:01:13.571+0000.
Who has the keyboard? · 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 2 of 10

Who has the keyboard?

BASIC is asking for a flight number. You can see the question behind the source editor. If you press 4 now, will it answer the question or change the program you wrote? On a Mac, the place that receives your next keystroke has keyboard focus. You can move it deliberately.

Give the CoCo your next keystroke

Click inside the live CoCo picture, or choose Input → Focus CoCo Display (Option-Command-K). This brings the emulator forward and directs typing to the guest computer. On the toolbar, Pause means the CoCo is running. If the button reads Run and the status reads Paused, click Run before answering a guest prompt.

To operate the Mac controls, choose Input → Focus Mac Controls (Option-Command-U). The Profiles button receives focus. Press Space to open it, or use Tab and Shift-Tab to move between controls. If Tab skips buttons, check System Settings → Keyboard → Keyboard navigation on the Mac. Clicking inside a source document gives ordinary editing keys back to that editor.

The difference matters with Escape. In a Mac menu, Escape dismisses the menu. Inside the guest, it sends Break, which can interrupt a program. Command shortcuts belong to the Mac even while you're typing into the guest.

Finish an answer after reopening the window

Start in Disk BASIC. Save any BASIC program you want to keep. Follow KEYS.bas. In the app it opens in a separate BASIC Example window. In a browser, open the downloaded file in Develop → BASIC Development…. Choose Run in the window containing KEYS. Confirm replacement of the program in CoCo memory if prompted. Watch for the flight-number question.

  1. Leave the question waiting and use the Mac’s Window menu to return to the BASIC window you ran. In that editor you can see the numbered line that asks the question. Go to Input → Focus Mac Controls. Press Space to open Profiles, then close its window without loading a setup.
  2. Choose Input → Focus CoCo Display. Type 4 and leave Return alone. Look for the digit on the question line.
  3. Close the emulator window with its red close button. Keep VCC Plus open. Press Command-1 (File → Show Emulator). You should see the digit you left behind.
  4. Type 2 and press Return. The complete answer is 42. BASIC prints FLIGHT 42 and returns to OK.
The emulator after reopening. The question contains 42, followed by FLIGHT 42 and OK.

Reopening the window brought back a running program halfway through an answer. A cold restart clears that memory, and quitting ends the session. If you've written something you want tomorrow, save the source or the guest program before quitting.

Match your keyboard to the program

Open Input → Keyboard and Joysticks… and find Keyboard mode. Changes take effect immediately and are remembered.

On a fresh installation the right joystick uses the sole connected controller, or Mouse if there is no unambiguous controller; the left joystick starts at None. This keeps ordinary typing available. A controller connected later can replace the fresh Mouse fallback until you make your own right-port choice. Existing saved input choices are preserved. See joystick sources to choose another source or port.

Mode When to try it
Natural Enter a BASIC listing or a letter. The printable keys follow the characters you type on your Mac layout, including punctuation.
CoCo Follow a program's illustrated keyboard or a game that reads key positions. VCC Plus uses physical US CoCo positions, so punctuation can differ from the symbol printed on your Mac key.
Compact Use character-based typing on a small keyboard. Tab sends Clear and the unshifted grave accent key sends Break.

Return is CoCo Enter, Home is Clear, and Escape is Break. F1 and F2 reach the emulated function keys. Hold Fn or Globe if macOS otherwise uses those keys for hardware controls. Help → Keyboard & Shortcuts… lists the modes, key equivalents and Mac shortcuts together. If letters such as Z or X disappear only inside the CoCo, check whether a keyboard joystick has claimed them.

Keyboard and Shortcuts shows Mac focus commands beside the keys the guest receives.

Move text between the two computers

Choose the command for the place the text is going. Ordinary Copy and Paste in the source editor edit a Mac document. The separate commands under Edit communicate with the running CoCo.

What you want What to choose
Take a guest message back to the Mac Copy CoCo Screen Text (Shift-Command-C) copies the characters from a supported hardware text screen while running or paused. Paste into a Mac text field to read them. For a drawn game screen, save its picture.
Type clipboard text into a guest prompt Paste Text into CoCo (Shift-Command-V) sends keystrokes. A newline in the clipboard sends Return, so check for extra lines before pasting at a command prompt.
Add numbered lines at BASIC's OK prompt Paste BASIC — Merge… enters the numbered lines. Matching numbers replace existing lines. A number by itself deletes that line.
Start a fresh listing at BASIC's OK prompt Save your old work, then choose Paste BASIC — Replace…. Confirmation sends NEW before the numbered lines. Copies previously saved to files survive.

The two BASIC paste commands leave you at the prompt so you can examine the listing before running it. Edit → Cancel Paste, pausing the emulator, or typing a CoCo key stops the remaining queued input. Already-entered lines have changed BASIC memory. For a program you want to edit and run repeatedly, keep a Mac source document in BASIC Development….

VoiceOver can read the native menus, controls and media status. The Devices list in System view offers named controls alongside the drawing. For guest text, try Copy CoCo Screen Text; a game that draws its own lettering supplies pixels rather than hardware text characters.

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