2016-10-29 01:20:20 +00:00
|
|
|
diskii
|
|
|
|
|
======
|
2016-10-30 01:45:58 +00:00
|
|
|
|
2016-11-13 21:59:38 +00:00
|
|
|
**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.
|
|
|
|
|
|
2016-10-29 01:20:20 +00:00
|
|
|
diskii is a commandline tool for working with Apple II disk images.
|
|
|
|
|
|
2016-11-13 03:41:03 +00:00
|
|
|
It is also a library of code that can be used by other Go programs.
|
|
|
|
|
|
2016-11-14 03:35:38 +00:00
|
|
|
Its major advantage is that it's written in Go, hence
|
2016-11-14 03:58:20 +00:00
|
|
|
cross-platform.
|
2016-10-30 01:57:08 +00:00
|
|
|
|
|
|
|
|
Its major disadvantage is that it mostly doesn't exist yet.
|
|
|
|
|
|
2016-10-30 01:45:58 +00:00
|
|
|
[](https://travis-ci.org/zellyn/diskii)
|
|
|
|
|
|
2016-11-13 03:41:03 +00:00
|
|
|
It rhymes with “whiskey”.
|
2016-10-29 01:20:20 +00:00
|
|
|
|
2016-10-29 02:15:30 +00:00
|
|
|
Discussion/support is in
|
|
|
|
|
[#apple2 on the retrocomputing Slack](https://retrocomputing.slack.com/messages/apple2/)
|
|
|
|
|
(invites [here](https://retrocomputing.herokuapp.com)).
|
2016-10-30 01:45:58 +00:00
|
|
|
|
2016-11-13 03:41:03 +00:00
|
|
|
### Goals
|
|
|
|
|
|
|
|
|
|
Eventually, it aims to be a comprehensive disk image manipulation
|
|
|
|
|
tool, but for now only the `applesoft decode` command works.
|
|
|
|
|
|
2016-11-14 04:04:48 +00:00
|
|
|
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](https://github.com/zellyn/goapple2).
|
2016-11-13 03:41:03 +00:00
|
|
|
|
2016-11-14 03:58:20 +00:00
|
|
|
Current disk operations supported:
|
|
|
|
|
|
|
|
|
|
| Feature | DOS 3.3 | NakedOS/Super-Mon |
|
|
|
|
|
| ------------- | ------------------ | ------------------ |
|
2016-11-15 03:54:57 +00:00
|
|
|
| ls | :white_check_mark: | :white_check_mark: |
|
|
|
|
|
| dump | :x: | :white_check_mark: |
|
2016-11-13 03:41:03 +00:00
|
|
|
|
2016-10-30 01:45:58 +00:00
|
|
|
### Installing/updating
|
|
|
|
|
Assuming you have Go installed, run `go get -u github.com/zellyn/diskii`
|
|
|
|
|
|
2016-11-14 03:58:20 +00:00
|
|
|
You can also download automatically-built binaries from the
|
|
|
|
|
[latest release
|
|
|
|
|
page](https://github.com/zellyn/diskii/releases/latest). If you
|
|
|
|
|
need binaries for a different architecture, please send a pull
|
|
|
|
|
request or open an issue.
|
|
|
|
|
|
2016-10-30 01:45:58 +00:00
|
|
|
### Short-term TODOs/roadmap
|
|
|
|
|
|
2016-11-14 04:04:48 +00:00
|
|
|
- [x] Build per-platform binaries for Linux, MacOS, Windows.
|
|
|
|
|
- [ ] Implement CATALOG, deletion, and creation of files in DOS 3.3 images.
|
2016-11-01 03:00:16 +00:00
|
|
|
|
2016-11-13 03:41:03 +00:00
|
|
|
### Related tools
|
2016-11-01 03:00:16 +00:00
|
|
|
|
|
|
|
|
- http://a2ciderpress.com/
|
|
|
|
|
- http://applecommander.sourceforge.net/
|
|
|
|
|
- https://github.com/cybernesto/dsktool.rb
|
|
|
|
|
- https://github.com/cmosher01/Apple-II-Disk-Tools
|
|
|
|
|
- https://github.com/madsen/perl-libA2
|
|
|
|
|
- https://github.com/markdavidlong/AppleSAWS
|
|
|
|
|
- https://github.com/dmolony/DiskBrowser
|
|
|
|
|
- https://github.com/deater/dos33fsprogs
|
|
|
|
|
- https://github.com/jtauber/a2disk
|
