Apple-2-Tools/diskii
1
0
Fork 0
mirror of https://github.com/zellyn/diskii.git synced 2024-11-25 04:31:32 +00:00
Code Issues Projects Releases Wiki Activity
apple2 disk image manipulation commandline tool
29 Commits 1 Branch 3 Tags 1.2 MiB
Go 97.2%
Shell 2.2%
Assembly 0.6%
982a3e6432
Go to file
Zellyn Hunter 982a3e6432 Add TODOs/ways to contribute to README
2016-11-15 21:50:06 -05:00
cmd Initial implementation of NakeOS/Super-Mon GetFile 2016-11-14 22:55:54 -05:00
lib supermon: set filetype, add test for GetFile 2016-11-15 21:05:22 -05:00
.gitignore Make Travis build github releases on tags 2016-11-13 22:09:03 -05:00
.travis.yml Skip cross-compilation on master 2016-11-13 23:16:03 -05:00
LICENSE Initial commit 2016-10-28 21:20:20 -04:00
main.go Initial commit 2016-10-28 21:20:20 -04:00
README.md Add TODOs/ways to contribute to README 2016-11-15 21:50:06 -05:00

README.md

diskii

Note: diskii is not stable yet! I don't expect to remove functionality, but I'm still experimenting with the command syntax and organization, so don't get too comfy with it yet.

diskii is a commandline tool for working with Apple II disk images.

It is also a library of code that can be used by other Go programs.

Its major advantage is that it's written in Go, hence cross-platform.

Its major disadvantage is that it mostly doesn't exist yet.

Build Status

It rhymes with “whiskey”.

Discussion/support is in #apple2 on the retrocomputing Slack (invites here).

Goals

Eventually, it aims to be a comprehensive disk image manipulation tool, but for now only the applesoft decode command works.

The library code aims (a) to support the commandline tool operations, and (b) to replace the "read and write disk images" code of the goapple2 emulator.

Current disk operations supported:

Feature DOS 3.3 NakedOS/Super-Mon
ls ✅ ✅
dump ❌ ✅

Installing/updating

Assuming you have Go installed, run go get -u github.com/zellyn/diskii

You can also download automatically-built binaries from the latest release page. If you need binaries for a different architecture, please send a pull request or open an issue.

Short-term TODOs/roadmap/easy ways to contribute

  • Build per-platform binaries for Linux, MacOS, Windows.
  • Implement GetFile for DOS 3.3
  • Add and implement the -l flag for ls
  • Add Delete to the disk.Operator interface
    • Implement it for supermon
    • Implement it for DOS 3.3
  • Add ProDOS support (add lib/prodos/prodos.go and register a ProDOS operator factory)

Related tools