dmolony-DiskBrowser/README.md

# Apple II Disk Browser

### Features
- Cross-platform (Windows, MacOS, Linux)
- Applesoft and Integer Basic
- Pascal disassembler
- 6502 disassembler
- Wizardry internals and maps
- Infocom text adventure internals
- Appleworks
- Visicalc
- HDV and 2mg
- Compressed disks - shrinkIt, gzip, zip
- Track and sector display
- Dual DOS disks
- DOS 4.1 disks
- CPM disks
- Comprehensive disk listing
- woz format disks
- UniDos disks

### Documentation
* [Usage](resources/usage.md)

### Installation
* Install the **latest** version of the [Java Runtime Environment](http://www.oracle.com/technetwork/java/javase/downloads/index.html) (JRE or JDK).
* 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.
* Set your root folder (the top-level folder where you keep your disk images).

### Example Screens
#### Disk listing
Select a disk from the Disk Tree tab to display the catalog and disk layout.
![Disk listing](resources/disk1.png?raw=true "Disk listing")
#### Disk contents
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.
![Disk catalog](resources/disk2.png?raw=true "Disk catalog")
#### Detailed sector display
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.
![Sector details](resources/sector.png?raw=true "Sector details")
#### Windows
![Windows](resources/windows.png?raw=true "Windows")
#### Hard disk
![Hard disk](resources/disk3.png?raw=true "Hard disk")
#### Pascal code
![Pascal](resources/pascal.png?raw=true "Pascal")
#### Infocom
![Infocom](resources/zork.png?raw=true "Infocom")
#### Graphics 
![Graphics](resources/planetfall.png?raw=true "Graphics")
#### Wizardry
![Wizardry](resources/wizardry.png?raw=true "Wizardry")
#### Visicalc
![Visicalc](resources/visicalc.png?raw=true "Visicalc")
#### Complete Disk List
![Disk List](resources/disklist.png?raw=true "Disk List")
fixed headings 2017-03-16 13:47:14 +11:00			`# Apple II Disk Browser`
Create README.md 2015-06-01 19:52:04 +10:00
fixed headings 2017-03-16 13:47:14 +11:00			`### Features`
updated doco 2019-10-22 09:57:19 +10:00			`- Cross-platform (Windows, MacOS, Linux)`
Update README.md 2015-06-01 19:54:53 +10:00			`- Applesoft and Integer Basic`
			`- Pascal disassembler`
			`- 6502 disassembler`
			`- Wizardry internals and maps`
			`- Infocom text adventure internals`
			`- Appleworks`
			`- Visicalc`
			`- HDV and 2mg`
Update README.md 2017-03-20 10:44:13 +11:00			`- Compressed disks - shrinkIt, gzip, zip`
Update README.md 2015-06-01 19:54:53 +10:00			`- Track and sector display`
			`- Dual DOS disks`
Update README.md 2019-01-25 17:25:41 +11:00			`- DOS 4.1 disks`
Update README.md 2016-02-27 10:11:06 +11:00			`- CPM disks`
Update README.md 2016-12-14 09:51:09 +11:00			`- Comprehensive disk listing`
doco 2018-08-13 19:27:16 +10:00			`- woz format disks`
doco 2019-11-22 15:42:07 +10:00			`- UniDos disks`
Create README.md 2015-06-01 19:52:04 +10:00
Update README.md 2016-07-31 12:25:03 +10:00			`### Documentation`
Update README.md 2016-07-31 12:27:33 +10:00			`* [Usage](resources/usage.md)`
Update README.md 2016-07-31 12:25:03 +10:00
Update README.md 2016-07-31 12:21:28 +10:00			`### Installation`
			`* Install the latest version of the [Java Runtime Environment](http://www.oracle.com/technetwork/java/javase/downloads/index.html) (JRE or JDK).`
Update README.md 2016-07-31 12:22:29 +10: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.`
doco 2019-11-22 15:42:07 +10:00			`* Set your root folder (the top-level folder where you keep your disk images).`
Update README.md 2016-07-31 12:21:28 +10:00
fixed headings 2017-03-16 13:47:14 +11:00			`### Example Screens`
			`#### Disk listing`
better descriptions 2018-10-14 09:22:38 +11:00			`Select a disk from the Disk Tree tab to display the catalog and disk layout.`
Update README.md 2015-06-01 21:15:38 +10:00			`![Disk listing](resources/disk1.png?raw=true "Disk listing")`
fixed headings 2017-03-16 13:47:14 +11:00			`#### Disk contents`
better descriptions 2018-10-14 09:22:38 +11: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.`
Update README.md 2015-06-01 21:15:38 +10:00			`![Disk catalog](resources/disk2.png?raw=true "Disk catalog")`
doco 2018-08-13 19:27:16 +10:00			`#### Detailed sector display`
better descriptions 2018-10-14 09:22:38 +11: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.`
doco 2018-08-13 19:27:16 +10:00			`![Sector details](resources/sector.png?raw=true "Sector details")`
windows screen image 2019-10-22 16:02:54 +10:00			`#### Windows`
			`![Windows](resources/windows.png?raw=true "Windows")`
fixed headings 2017-03-16 13:47:14 +11:00			`#### Hard disk`
Update README.md 2015-06-01 21:15:38 +10:00			`![Hard disk](resources/disk3.png?raw=true "Hard disk")`
fixed headings 2017-03-16 13:47:14 +11:00			`#### Pascal code`
Update README.md 2015-06-01 21:15:38 +10:00			`![Pascal](resources/pascal.png?raw=true "Pascal")`
doco 2018-08-13 19:27:16 +10:00			`#### Infocom`
			`![Infocom](resources/zork.png?raw=true "Infocom")`
			`#### Graphics`
			`![Graphics](resources/planetfall.png?raw=true "Graphics")`
fixed headings 2017-03-16 13:47:14 +11:00			`#### Wizardry`
Update README.md 2015-06-01 21:15:38 +10:00			`![Wizardry](resources/wizardry.png?raw=true "Wizardry")`
fixed headings 2017-03-16 13:47:14 +11:00			`#### Visicalc`
Update README.md 2015-06-01 21:15:38 +10:00			`![Visicalc](resources/visicalc.png?raw=true "Visicalc")`
fixed headings 2017-03-16 13:47:14 +11:00			`#### Complete Disk List`
Update README.md 2016-12-13 15:37:04 +11:00			`![Disk List](resources/disklist.png?raw=true "Disk List")`