2018-04-28 03:40:39 +00:00
# Apple II DeskTop
2017-08-29 04:21:31 +00:00
2018-04-11 04:28:29 +00:00
[](https://travis-ci.org/inexorabletash/a2d)
2019-04-23 04:23:36 +00:00
Work-in-Progress disassembly and enhancements for Apple II Desktop (a.k.a. MouseDesk)
💾 Disk images can be found on the [Releases ](https://github.com/inexorabletash/a2d/releases ) page 💾
2017-08-29 03:58:09 +00:00
2017-08-29 04:21:31 +00:00
## Background
2019-04-23 04:23:36 +00:00
This application started its life as **MouseDesk** by Version Soft. It
2018-04-28 03:40:39 +00:00
is a mouse-driven Mac-like "Finder" GUI application for 8-bit Apples
2019-04-23 04:23:36 +00:00
and clones with 128k of memory, utilizing double-hires monochrome graphics
(560x192), an optional mouse, and the ProDOS operating system.
2017-08-29 04:21:31 +00:00
2018-04-28 03:40:39 +00:00
Apple Computer acquired the software and released it - rebranded as
2019-04-23 04:23:36 +00:00
**Apple II DeskTop** - as the initial
[system software for the Apple IIgs ](](http://www.whatisthe2gs.apple2.org.za/system-applications ))
2018-04-28 03:40:39 +00:00
before 16-bit GS/OS replaced it. The rebranded version still functions
2019-04-23 04:23:36 +00:00
on 8-bit Apples, including the Apple IIe, Apple IIc, Apple IIc Plus,
Apple IIe Option Card for Macintosh, and the Laser 128 family.
* [History of MouseDesk/Apple II DeskTop versions, by Jay Edwards ](https://mirrors.apple2.org.za/ground.icaen.uiowa.edu/MiscInfo/Misc/mousedesk.info )
* Overviews: [GUI Gallery ](http://toastytech.com/guis/a2desk.html ) — [GUIdebook ](https://guidebookgallery.org/guis/apple2/mousedesk )
* Manual: [Apple IIgs System Disk User’ ](https://mirrors.apple2.org.za/ftp.apple.asimov.net/documentation/misc/Apple%20IIgs%20System%20Disk%20Users%20Guide%20%281986%29.pdf ) - Chapter 2 “The DeskTop”
* [Disk Images ](https://mirrors.apple2.org.za/ftp.apple.asimov.net/images/masters/other_os/gui/ ) for MouseDesk and Apple II DeskTop
Other GUI environments exist for the 8-bit Apples, including
[GEOS ](http://toastytech.com/guis/a2geos.html ) (which includes productivity applications) and
[Quark Catalyst ](http://toastytech.com/guis/qcat.html ).
While Apple II DeskTop is more limited -
2017-08-29 04:21:31 +00:00
serving only as a file manager and application launcher - it is (subjectively)
more visually appealing and better integrated with ProDOS.
2019-04-23 04:23:36 +00:00
## This Project
2017-08-29 04:21:31 +00:00
The goal of this project is to disassemble/reverse-engineer the suite
2019-04-23 04:23:36 +00:00
with an eye towards understanding how it functions, fixing bugs, and
adding functionality.
See the [Release Notes ](RELEASE-NOTES.md ) for a list of enhancements and fixes so far.
[](https://www.youtube.com/watch?v=zbElPj5zaBs)
< br >
_KansasFest 2018 presentation by @mgcaret_
Additional help is welcome! See the guide for [Contributing ](CONTRIBUTING.md ).
2017-08-29 04:21:31 +00:00
## Tools
The [cc65 ](http://cc65.github.io/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.
2018-04-12 04:38:08 +00:00
Please read the full [Code of Conduct ](CODE_OF_CONDUCT.md ).
