Disassembly of the Apple II Desktop - ProDOS GUI
Go to file
Joshua Bell 3e5bc7d5de DeskTop: bump release 2019-04-04 09:08:40 -07:00
desk.acc Macro tidying: use param blocks; dedupe macros that differ only by order 2019-03-30 08:34:49 -07:00
desktop Disk Copy: Don't hard-code cross-overlay addresses. Fixes #147 2019-04-04 09:04:05 -07:00
desktop.system Macro tidying: use param blocks; dedupe macros that differ only by order 2019-03-30 08:34:49 -07:00
docs DeskTop: apple-backtick and apple-tab cycle windows. Fixes #143 2019-03-25 22:04:54 -07:00
fonts Remove desk.acc/fonts, update tools. Resolves #76 2018-04-27 19:37:12 -07:00
inc Hook reset to cleanly quit DeskTop back to ProDOS. Resolves #141 2019-03-29 18:52:52 -07:00
preview Add 'Screen Saver' DA, issue #27. Also adds DrawMenu to MGTK, fixes #136. 2019-03-11 19:44:07 -07:00
res Include ProDOS 2.4.2/BASIC.SYSTEM 1.6 for packaging 2019-04-03 22:38:55 -07:00
.gitignore add script to generate ShrinkIt file if nulib2 is available (#128) 2019-02-14 11:06:08 -08:00
.travis.yml Travis CI: Fix preview path 2019-04-02 21:34:15 -07:00
APIs.md Add "Preview DAs", allow opening text/graphics directly (Issue #101) 2019-01-21 12:35:43 -08:00
CODE_OF_CONDUCT.md Create standardized code of conduct 2018-04-11 21:36:56 -07:00
CONTRIBUTING.md Update docs regarding branch structure 2018-12-09 20:43:56 -08:00
CodingStyle.md disasm: copy/delete/lock/unlock/size operations 2019-01-14 20:43:17 -08:00
MGTK.md Add 'Screen Saver' DA, issue #27. Also adds DrawMenu to MGTK, fixes #136. 2019-03-11 19:44:07 -07:00
README.md Documentation updates 2018-04-27 20:40:39 -07:00
RELEASE-NOTES.md Hook reset to cleanly quit DeskTop back to ProDOS. Resolves #141 2019-03-29 18:52:52 -07:00
desktop.inc DeskTop: bump release 2019-04-04 09:08:40 -07:00
macros.inc Macro tidying: use param blocks; dedupe macros that differ only by order 2019-03-30 08:34:49 -07:00
mgtk.inc Add 'Screen Saver' DA, issue #27. Also adds DrawMenu to MGTK, fixes #136. 2019-03-11 19:44:07 -07:00

README.md

Apple II DeskTop

Build Status

Work-in-Progress disassembly of Apple II Desktop (a.k.a. MouseDesk)

Background

Apple II Desktop started its life as "MouseDesk" by Version Soft. It is a mouse-driven Mac-like "Finder" GUI application for 8-bit Apples with 128k of memory (Enhanced Apple //e, Apple //c) using double-hires monochrome graphics (560x192) and the ProDOS operating system.

Apple Computer acquired the software and released it - rebranded as Apple II Desktop - as the initial system software for the Apple IIgs before 16-bit GS/OS replaced it. The rebranded version still functions on 8-bit Apples.

Overview: http://toastytech.com/guis/a2desk.html

Manual: Apple IIgs System Disk Users Guide (1986) - Chapter 2 “The DeskTop”

A pieced-together history, details of versions, bug reports and feature requests: https://mirrors.apple2.org.za/ground.icaen.uiowa.edu/MiscInfo/Misc/mousedesk.info

Disks can be found at: ftp://ftp.apple.asimov.net/pub/apple_II/images/masters/other_os/gui/

Other GUI environments exist for the 8-bit Apples, including GEOS (which includes productivity applications) and Quark Catalyst. While A2.Desktop is more limited - serving only as a file manager and application launcher - it is (subjectively) more visually appealing and better integrated with ProDOS.

Goal

The goal of this project is to disassemble/reverse-engineer the suite with an eye towards understanding how it functions, and eventually fixing bugs and adding functionality.

Tools

The cc65 tool chain will be used; source files will target the ca65 macro assembler. Cross-development on modern systems will be assumed. (Sorry, Merlin purists! We still love you.)

Code of Conduct

Discussions should be polite, respectful and inclusive, and focus on the code. Harassment will not be tolerated. Keep comments constructive. Please read the full Code of Conduct.