diskii/README.md

105 lines
4.6 KiB
Markdown
Raw Normal View History

diskii
======
**Note:** diskii is not stable yet! I don't expect to remove
functionality, but I'm still experimenting with the command syntax and
2016-12-01 03:33:08 +00:00
organization, so don't get too comfy with it.
2017-03-17 03:12:07 +00:00
![Seagull Srs Micro Software](img/seagull-srs.png)
2016-12-20 04:51:20 +00:00
diskii-the-tool is a commandline tool for working with Apple II disk
images. Given that
[AppleCommander](http://applecommander.sourceforge.net/) already does
everything, it's not terribly necessary. It is, however, mine. Minor
benefits (right now) are binaries you can copy around (no Java
2017-03-09 04:00:05 +00:00
needed), support for Super-Mon symbol tables on NakedOS disks, and
creation of
"[Standard Delivery](https://github.com/peterferrie/standard-delivery)"
disk images.
2016-12-20 04:51:20 +00:00
diskii-the-library is probably more useful: a library of
disk-image-manipulation code that can be used by other Go programs.
2016-11-13 03:41:03 +00:00
2016-12-20 04:51:20 +00:00
diskii's major disadvantage is that it mostly doesn't exist yet.
2016-10-30 01:57:08 +00:00
[![Build Status](https://travis-ci.org/zellyn/diskii.svg?branch=master)](https://travis-ci.org/zellyn/diskii)
[![Report Card](https://goreportcard.com/badge/github.com/zellyn/diskii)](https://goreportcard.com/report/github.com/zellyn/diskii)
2017-01-27 03:56:28 +00:00
[![GoDoc](https://godoc.org/github.com/zellyn/diskii/lib?status.svg)](https://godoc.org/github.com/zellyn/diskii/lib)
2016-11-13 03:41:03 +00:00
It rhymes with “whiskey”.
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-11-13 03:41:03 +00:00
### Goals
Eventually, it aims to be a comprehensive disk image manipulation
2017-03-18 03:17:17 +00:00
tool, but for now only some parts work.
2016-11-13 03:41:03 +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:
2017-03-18 02:26:43 +00:00
| Feature | DOS 3.3 | ProDOS | NakedOS/Super-Mon |
| ---------------- | -------- | ------ | ------------------ |
2017-03-18 03:17:17 +00:00
| basic structures | ✓ | ✓ | ✓ |
2017-03-18 02:26:43 +00:00
| ls | ✓ | ✗ | ✓ |
| dump | ✓ | ✗ | ✓ |
| put | ✗ | ✗ | ✓ |
| dumptext | ✗ | ✗ | ✗ |
| delete | ✗ | ✗ | ✗ |
| rename | ✗ | ✗ | ✗ |
| put | ✗ | ✗ | ✗ |
| puttext | ✗ | ✗ | ✗ |
| extract (all) | ✗ | ✗ | ✗ |
| lock/unlock | ✗ | ✗ | ✗ |
| init | ✗ | ✗ | ✗ |
| defrag | ✗ | ✗ | ✗ |
2016-11-13 03:41:03 +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-11-16 02:50:06 +00:00
### Short-term TODOs/roadmap/easy ways to contribute
2017-03-18 02:26:43 +00:00
My rough TODO list (apart from anything marked (✗) in the disk
operations matrix is listed below. Anything that an actual user needs
will be likely to get priority.
- [x] Build per-platform binaries for Linux, MacOS, Windows.
2017-03-18 03:17:17 +00:00
- [x] Implement `GetFile` for DOS 3.3
2016-11-16 02:50:06 +00:00
- [ ] Add and implement the `-l` flag for `ls`
2016-12-20 04:51:20 +00:00
- [x] Add `Delete` to the `disk.Operator` interface
- [x] Implement it for Super-Mon
2016-11-16 02:50:06 +00:00
- [ ] Implement it for DOS 3.3
- [ ] Make 13-sector DOS disks work
- [ ] Read/write nybble formats
- [ ] Read/write gzipped files
2017-03-18 03:17:17 +00:00
- [ ] Add basic ProDOS structures
- [ ] Add ProDOS support
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/ - the great grandaddy of them all. Windows only, unless you Wine
- http://applecommander.sourceforge.net/ - the commandline, cross-platform alternative to CiderPress
- http://brutaldeluxe.fr/products/crossdevtools/cadius/index.html - Brutal Deluxe's commandline tools
2016-11-01 03:00:16 +00:00
- 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
2016-12-03 19:00:02 +00:00
- https://github.com/datajerk/c2d
- https://github.com/thecompu/Driv3rs - A Python Script to work with Apple III SOS DSK files
- http://www.callapple.org/software/an-a-p-p-l-e-review-shink-fit-x-for-mac-os-x
2017-03-14 02:19:59 +00:00
- https://github.com/dmolony/DiskBrowser - graphical (Java) disk browser that knows how to interpret and display many file formats