A general purpose ASM libriary for the Apple II. Assembled in Merlin 8 Pro
Go to file
Nathan D Riggs 3577df3db7
Update README.md
2022-08-02 11:19:14 -04:00
.github/ISSUE_TEMPLATE Update issue templates 2019-01-06 21:38:46 -05:00
bin Updated Disks 1-4 2021-06-15 21:33:08 -04:00
documentation Disk 1: REQUIRED disk and documentation 2021-06-06 21:50:54 -04:00
source updated source files 2021-06-05 21:40:51 -04:00
versions Create AppleIIAsmLib_0.6.0.zip 2021-06-03 23:13:15 -04:00
.gitattributes Update .gitattributes 2019-12-17 13:56:36 -05:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2019-01-06 21:24:44 -05:00
CONTRIBUTING.md Create CONTRIBUTING.md 2019-01-06 21:37:07 -05:00
LICENSE Initial commit 2018-10-31 14:16:27 -04:00
README.md Update README.md 2022-08-02 11:19:14 -04:00
README.md~ 0.3.1 updates 2019-01-28 22:41:53 -05:00



A general purpose ASM libriary for the Apple II. Assembled in Merlin 8 Pro. While this source is currently in constant flux, save for "stable" releases, you may find the project's current technical documentation, v0.6.1 here.

Since this is in flux, you may also find the previous documentation,v0.5.0, here. Note that this documentation is in .pdf format.



I am currently in the process of redesigning how the entire library works, so updates on this won't be piecemeal again until that is finished; if not, the library as a whole would not work together until the updates are finished. A lot of the documentation is changing, and I'm additionally rewriting and optimizing a lot of code. Of particular note is that the next version of the library will not force you to use the RETURN memory location for passing back data from subroutines, and switching every case of passing addresses via the registers to hold high bytes in .A instead of .X (to keep in line with standard practice of the day).

I don't have a 100% clear finish date, but the updates are substantial so don't expect anything within a couple of months. In the meantime, if you would like to contribute, please fork this instead of contributing here until the update is done.


Wow! It's been a year since any updates. Life happened. But I am currently working on v0.7.0 of the library. This will be incompatible with all past versions, but if you only used macros, and didn't call the subroutines yourself, the changes should be minimal. You should expect the first round of changes to update by the end of the month, which will mostly consist of rewritten required routines. Then, we'll resume the running TODO lists.



  • add page flipping to stdio, which requires adding to each subroutine
  • fix 8-bit bresenham in stdio and lores
  • reorganize mac files on stdio
  • delete pct,gcf,lcm in math collection
  • add modulus subroutines/macros to math
  • add/fix memory catalog subroutine/macro in DOS
  • change dos fmfil, etc. to be subroutines to decrease bytes
  • fix 16bit bresenham in hires
  • add bresenham circle routine to hires
  • add rect, frect routines to hires
  • add signed macros to math collection
  • add floating point examples to math collection, if room exists
  • revise all documentation to reflect changes (also previous changes)


  • Updated all required collection macros and subroutines on every disk
  • Revised all subroutines and macros to fit with new zero page names


  • Updated all disks as part of a small reorganization of the REQUIRED library collection
  • Added High Resolution Graphics Disk
  • Added Apple II Internal Speaker Disk
  • Rewrote all documentation in markdown


  • Really Finished all goals previously made on 17-DEC-2019, and then some
  • Began reworking Disk 2: STDIO to conform to new software architecture and documentation
  • next version will be 0.6.1, but no package will be created due to incompatibilities between libraries. From this point onward, releases will only be made if the entire collection is inter-compatible. The second digit will increase, and the third digit reset, in order to reflect compatible versus incomplatible current versions at this point. Later down the road, this version system will simply reflect major versus minor changes.
  • updated base README.md to point toward documentation


  • Currently working on version 0.6.0, which includes:
    • an updated architecture
    • deliberate use of markdown for documentation
      • with the eventual goal of translating it to Madoko, a markdown variant that allows for more visual control on a printend page
    • Still transforming entire disk system to adhere to a singular software architecture.
    • Added Alias macros for 8080 and z80 instruction sets.
    • Major changes to Disk 1, including merger of REQUIRED and COMMON libraries


  • As of version 0.5.0, updates will occur on a disk-by-disk basis (as well as appropriate changes to the documentation).
  • version 0.5.0 pretty much breaks any prior work that used the library. While future updates won't be so extreme, now that a stable system is in place, this is to be expected in any update prior to an official version 1.0.
  • The main documentation has been moved to a .docx and pdf file, rather than here, due to the length of the document. In the future, this file will be changed to a more open format, as well as converted into a hard-copy friendly design.