Help
Check out the FAQ for answers to other common questions.
Troubleshooting
Apple IIe: The mouse pointer doesn't move.
On the Apple IIe, an Apple 9-pin mouse must be plugged into a dedicated Apple mouse interface card. Although it has the same physical connector as the Apple IIe's external joystick port, it won't work in that port.
Apple IIc: The mouse pointer only moves up and down or left and right, not both.
The M0100 mouse is known to have compatibility issues with the Apple IIc and IIc Plus where the mouse may not be detected, or one axis may stop being measured. This is due to a hardware problem affecting only some mice with that model number. Mice with model numbers starting with A2 should function correctly. This problem is not specific to Apple II DeskTop. More details and a fix.
Double-clicking on icons doesn't open them.
Double-clicking works by responding to the first click and selecting the icon, then waiting to see if another click happens nearby in a short period of time.
On systems with an accelerator running at more than 1MHz, or emulators, a double-click might not be detected. Go to Apple > Control Panels and open Control.Panel (using File > Open or △-O) then click a different Double-Click Speed option.
On systems without an accelerator and running at just 1MHz, you may be clicking too fast for the computer to notice that you have clicked twice. Try clicking more slowly.
My system has a clock but I don't see the time on the menu bar.
ProDOS has built-in support for the Apple IIgs clock and Thunderclock compatible clock cards. For other system clocks, ProDOS needs an additional driver to talk to the clock. If you boot your machine using a disk image with no driver present, DeskTop will not be able to see the clock. Instead, boot ProDOS off a disk with your clock driver, then start DeskTop by launching DESKTOP.SYSTEM. A generic clock driver named CLOCK.SYSTEM is included on DeskTop live installation disk images that supports many common clocks, including the No-Slot Clock, DClock, ROMX, The Cricket!, and FujiNet.
⚠️ WARNING: For some types of clocks the date and time must be set using a separate utility for the clock. If you don't do this, CLOCK.SYSTEM will not be able to detect the clock, and DeskTop will not show the time on the menu bar.
The screen has color fringes everywhere and text is difficult to read.
Apple II DeskTop uses monochrome double hi-res graphics. On systems with a color composite monitor, the monochrome dot patterns are interpreted as color. While this was true on vintage color displays, the appearance is much worse with modern VGA adapters and LCD displays.
On the following systems, the video mode will switch automatically from color to monochrome:
The Apple IIgs with a composite or analog RGB monitor.
The Apple IIe with Video 7 RGB Interface card, AppleColor RGB card, Le Chat Mauve Feline or Eve card, and a digital RGB monitor.
The Apple IIe with a modern VGA adapter card such as Apple II VGA or ∀2 Analog VGA which support Video-7 mode. I can personally recommend the A2 VidGA by Joe's Computer Museum.
The Apple IIc with a Video 7 RGB Interface adapter and a digital RGB monitor.
The Apple IIc with a Le Chat Mauve IIc and an RGB monitor with SCART input.
In MAME, enter the menu (press the Delete key or Fn+Delete, then press the Tab key), select Machine Configuration, and for Monitor type select Video-7 RGB.
In AppleWin, for Video settings select Color (RGB Card/Monitor).
In Apple //jse, under Options, ensure both Mono Screen and GL Renderer are disabled.
Otherwise, you will need to switch modes manually if you can:
The AppleColor Composite Monitor has a color/monochrome toggle button in the control panel.
The Laser 128 line of computers have a MONO/COLOR switch above the keyboard.
The Apple IIe Option Card for Macintosh has Monochrome and Color display options in the IIe Option Panel.
The a2heaven.com Apple IIc VGA Adapter has a button to toggle modes.
The Virtual ][ emulator and Apple2TS have a color/monochrome toggle button on the toolbar. Most other emulators have similar controls.
You can modify an Apple IIc to add a monochrome/color switch. See YouTube video by Scott Lawrence.
Otherwise, you will need to use an actual monochrome monitor to see Apple II DeskTop as intended.
I don't see any desk accessories in the Apple menu.
There is not enough room on 140k floppy disks to include desk accessory files. The 140k floppy disk images are really intended for installing Apple II DeskTop onto a hard disk, not for running DeskTop.
I have a ZIP CHIP but the System Speed DA buttons don't change the speed.
This can happen if you have your mouse card in a slot that causes the ZIP CHIP to run at "normal" speed instead of "fast" speed. Use the ZIP.SYSTEM utility to set your mouse card slot to "fast", or move your mouse card to a default "fast" slot (1 or 4).
File and volume names are capitalized strangely.
ProDOS-8 doesn't support lowercase in filenames directly. Files and volumes named using the Apple IIgs Finder as well as AppleWorks files will appear with the specified mix of uppercase and lowercase letters, which may be all uppercase if named while Caps Lock was down. Other files and volumes will have uppercase and lowercase letters inferred using an algorithm.
There is a setting in the Options control panel that will make DeskTop preserve file and disk names exactly as typed.
MAME: When using arrow keys to navigate menus, it skips over items.
In the MAME emulator, by default the arrow keys move the mouse as well, and this double movement confuses DeskTop. In MAME, enter the menu (press the Delete key or Fn+Delete, then press the Tab key), select Input Settings, then Input Assignments (this system) then highlight Mouse X Analog Inc and press fn+delete. Repeat this for Mouse X Analog Dec, Mouse Y Analog Inc, and Mouse Y Analog Dec. Then press Escape to exit and save the settings.
DeskTop doesn't start with my experimental version of ProDOS.
DeskTop assumes full compatibility with the documented ProDOS-8 MLI and global page. It works with official ProDOS versions from 1.1 to 2.0.3 and unofficial ProDOS version 2.4. Several experimental versions of ProDOS make breaking changes to this API which are not compatible with DeskTop. ProDOS 2.5 changes unit number encoding and time encoding. ProDOS.FX changes flag results from MLI calls and enforces case-sensitive filename usage.
I can't shift+click to extend selection.
By default, only the Apple IIgs and extended keyboard ("Platinum") Apple IIe provide a way to detect when the shift key is down when clicking. On other Apples, the Open Apple key must be used instead. An Apple IIe without the extended keyboard can be modified to support this via the "Shift-key mod"; see page 42 of the Apple IIe Technical Reference Manual for details. This is not supported on the Apple IIc and Apple IIc Plus.