Apple-2-SW
/
a2d
mirror of https://github.com/mi57730/a2d.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Disassembly of the Apple II Desktop - ProDOS GUI
1,196 Commits 4 Branches 15 Tags 5.5 MiB
Assembly 93.5%
PHP 4.2%
Perl 1%
Shell 0.6%
Pascal 0.5%
Other 0.2%
Go to file
Joshua Bell 157c6a3f0c Add MGTK Font file support for Preview. 
Correct docs for some DeskTop icon APIs, and improve resilience of
some of the APIs to having atypical grafports selected when called.
 		2019-07-26 20:44:22 -07:00
desk.acc Calculator DA: Fix FSUB call. Fixes #159 2019-07-11 21:18:48 -07:00
desktop Add MGTK Font file support for Preview. 2019-07-26 20:44:22 -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 Preview: Infer BIN at $4000 as image too 2019-07-20 10:06:01 -07:00
fonts Remove desk.acc/fonts, update tools. Resolves #76 2018-04-27 19:37:12 -07:00
inc Add MGTK Font file support for Preview. 2019-07-26 20:44:22 -07:00
preview Add MGTK Font file support for Preview. 2019-07-26 20:44:22 -07:00
res Travis CI: Deploy tagged versions as pre-releases 2019-05-05 18:12:50 -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: Deploy tagged versions as pre-releases 2019-05-05 18:12:50 -07:00
APIs.md Add MGTK Font file support for Preview. 2019-07-26 20:44:22 -07: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 docs about Mouse Keys mode 2019-05-12 19:01:53 -07:00
README.md Updated README 2019-04-22 21:23:36 -07:00
RELEASE-NOTES.md Add MGTK Font file support for Preview. 2019-07-26 20:44:22 -07:00
desktop.inc Add MGTK Font file support for Preview. 2019-07-26 20:44:22 -07:00
macros.inc Correct icon clipping while dragging. Fixes #162 2019-07-22 21:14:20 -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 and enhancements for Apple II Desktop (a.k.a. MouseDesk)

💾 Disk images can be found on the Releases page 💾

Background

This application started its life as MouseDesk by Version Soft. It is a mouse-driven Mac-like "Finder" GUI application for 8-bit Apples and clones with 128k of memory, utilizing double-hires monochrome graphics (560x192), an optional mouse, 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, including the Apple IIe, Apple IIc, Apple IIc Plus, Apple IIe Option Card for Macintosh, and the Laser 128 family.

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

This Project

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

See the Release Notes for a list of enhancements and fixes so far.

Alt text
KansasFest 2018 presentation by @mgcaret

Additional help is welcome! See the guide for Contributing.

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.