dmolony-DiskBrowser/README.md

72 lines
3.0 KiB
Markdown
Raw Normal View History

2017-03-16 02:47:14 +00:00
# Apple II Disk Browser
2015-06-01 09:52:04 +00:00
2017-03-16 02:47:14 +00:00
### Features
2019-10-21 23:57:19 +00:00
- Cross-platform (Windows, MacOS, Linux)
2020-05-15 10:08:48 +00:00
- Disk formats
- DOS
- Prodos
- Pascal
- CPM
- HDV
- 2mg
- shrinkIt, gzip, zip
- hybrid disks
- woz
- Unidos
- File Formats
- Applesoft and Integer Basic
2020-05-15 10:12:18 +00:00
- Pascal
2020-05-15 10:21:24 +00:00
- 6502
2020-05-15 10:08:48 +00:00
- Appleworks
- Visicalc
2020-05-15 10:12:18 +00:00
- Graphics files
2020-05-15 10:08:48 +00:00
- Disk Internals
- Wizardry
- Infocom
2020-05-15 10:14:46 +00:00
- Track / Sector / Block display
2016-12-13 22:51:09 +00:00
- Comprehensive disk listing
2015-06-01 09:52:04 +00:00
2016-07-31 02:25:03 +00:00
### Documentation
2016-07-31 02:27:33 +00:00
* [Usage](resources/usage.md)
2016-07-31 02:25:03 +00:00
2016-07-31 02:21:28 +00:00
### Installation
2021-05-22 01:10:59 +00:00
* Install the **latest** version of the [Open JDK](https://jdk.java.net/16/) or [AdoptOpenJDK](https://adoptopenjdk.net).
2016-07-31 02:22:29 +00:00
* Download DiskBrowser.jar from the [releases](https://github.com/dmolony/diskbrowser/releases) page.
* Double-click the jar file, or enter 'java -jar DiskBrowser.jar' in the terminal.
2019-11-22 05:42:07 +00:00
* Set your root folder (the top-level folder where you keep your disk images).
2016-07-31 02:21:28 +00:00
2017-03-16 02:47:14 +00:00
### Example Screens
#### Disk listing
2018-10-13 22:22:38 +00:00
Select a disk from the Disk Tree tab to display the catalog and disk layout.
2015-06-01 11:15:38 +00:00
![Disk listing](resources/disk1.png?raw=true "Disk listing")
2017-03-16 02:47:14 +00:00
#### Disk contents
2018-10-13 22:22:38 +00:00
Double-click a disk from the Disk Tree tab and a new tab appears. This tab contains a list of all the files on the disk. Click on a file and the Output panel will display the contents of that file. The disk sectors containing the file will also be highlighted in the Disk Layout panel.
2015-06-01 11:15:38 +00:00
![Disk catalog](resources/disk2.png?raw=true "Disk catalog")
2018-08-13 09:27:16 +00:00
#### Detailed sector display
2018-10-13 22:22:38 +00:00
Click on any sector in the Disk Layout panel and the Output panel will display the contents of that sector. If it is a recognised sector type, it will be formatted for easier reading.
2018-08-13 09:27:16 +00:00
![Sector details](resources/sector.png?raw=true "Sector details")
2020-05-15 10:24:09 +00:00
#### Cross-platform
Java runs on Windows, MacOS and Linux.
2020-09-14 08:10:36 +00:00
2019-10-22 06:02:54 +00:00
![Windows](resources/windows.png?raw=true "Windows")
2020-05-15 10:24:09 +00:00
#### Graphics
![Graphics](resources/graphics.png?raw=true "Graphics")
2021-01-15 22:16:40 +00:00
#### Applesoft Formatting and Analysis
2021-05-22 00:41:04 +00:00
Applesoft programs are displayed in a modern, easily-readable format. A comprehensive cross-listing of variables, strings, calls and jumps is available. Easily find duplicate variable names.
2021-07-02 05:43:17 +00:00
For the truly retro look, programs can be displayed in the [original 40-column line wrap](resources/basic.md) mode.
2021-01-15 22:16:40 +00:00
![Applesoft](resources/basic.png?raw=true "Applesoft")
2017-03-16 02:47:14 +00:00
#### Pascal code
2015-06-01 11:15:38 +00:00
![Pascal](resources/pascal.png?raw=true "Pascal")
2018-08-13 09:27:16 +00:00
#### Infocom
![Infocom](resources/zork.png?raw=true "Infocom")
2017-03-16 02:47:14 +00:00
#### Wizardry
2015-06-01 11:15:38 +00:00
![Wizardry](resources/wizardry.png?raw=true "Wizardry")
2017-03-16 02:47:14 +00:00
#### Visicalc
2021-05-22 00:31:33 +00:00
DiskBrowser includes an inbuilt Visicalc processor which will evaluate the sheet and display the results.
2015-06-01 11:15:38 +00:00
![Visicalc](resources/visicalc.png?raw=true "Visicalc")
2017-03-16 02:47:14 +00:00
#### Complete Disk List
2021-05-22 00:31:33 +00:00
Generates a list of all the disks in your collection. The list can be sorted by any of the table headings. Checksums can be generated as needed, or for the whole collection.
2016-12-13 04:37:04 +00:00
![Disk List](resources/disklist.png?raw=true "Disk List")
2021-05-22 00:31:33 +00:00
Select a disk and click the duplicates button to see all of the disks that share the same checksum.
![Duplicates](resources/duplicates.png?raw=true "Duplicates")