dmolony-DiskBrowser/README.md

# Apple II Disk Browser
### Alternative
There is a new release of [DiskBrowser2](https://github.com/dmolony/diskbrowser2) available.
### Features
- Cross-platform (Windows, MacOS, Linux)
- Disk formats
    - DOS
    - Prodos
    - Pascal
    - CPM
    - HDV
    - 2mg
    - shrinkIt, gzip, zip
    - hybrid disks
    - woz
    - Unidos
- File Formats
    - Applesoft and Integer Basic
    - Pascal
    - 6502
    - Appleworks
    - Visicalc
    - Graphics files 
- Disk Internals
    - Wizardry
    - Infocom
- Track / Sector / Block display
- Comprehensive disk listing

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

### Installation
* Install the **latest** version of the [JDK](https://www.oracle.com/java/technologies/downloads/).
* 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")
#### Cross-platform
Java runs on Windows, MacOS and Linux.
  
![Windows](resources/windows.png?raw=true "Windows")
#### Graphics 
![Graphics](resources/graphics.png?raw=true "Graphics")
#### Applesoft Formatting and Analysis
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.
For the truly retro look, programs can be displayed in the [original 40-column line wrap](resources/basic.md) mode.
![Applesoft](resources/basic.png?raw=true "Applesoft")
#### Pascal code
![Pascal](resources/pascal1.png?raw=true "Pascal text")
![Pascal](resources/pascal2.png?raw=true "Pascal internals")
#### Infocom
![Infocom](resources/zork.png?raw=true "Infocom")
#### Wizardry
Wizardry scenarios 1 to 3 are reasonably complete, Wizardry IV and V are partially done. For a dedicated Wizardry application see [WizardryApp](https://github.com/dmolony/WizardryApp).
![Wizardry](resources/wizardry.png?raw=true "Wizardry")
Scenarios 4 and 5 come on multiple disks, and they need to be named so that the only difference between disk names is the identifier before the '.dsk' suffix.
![Wizardry](resources/wizardry4.png?raw=true "Wizardry IV")
#### Visicalc
DiskBrowser has an inbuilt Visicalc processor which will evaluate the sheet and display the results.
![Visicalc](resources/visicalc.png?raw=true "Visicalc")
#### Complete Disk List
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.
![Disk List](resources/disklist.png?raw=true "Disk List")
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")
fixed headings 2017-03-16 02:47:14 +00:00			`# Apple II Disk Browser`
link to DiskBrowserApp 2024-04-06 06:33:53 +00:00			`### Alternative`
tidying 2024-05-02 02:38:45 +00:00			`There is a new release of [DiskBrowser2](https://github.com/dmolony/diskbrowser2) available.`
fixed headings 2017-03-16 02:47:14 +00:00			`### Features`
updated doco 2019-10-21 23:57:19 +00:00			`- Cross-platform (Windows, MacOS, Linux)`
tidying 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`
tidying 2020-05-15 10:12:18 +00:00			`- Pascal`
tidying 2020-05-15 10:21:24 +00:00			`- 6502`
tidying 2020-05-15 10:08:48 +00:00			`- Appleworks`
			`- Visicalc`
tidying 2020-05-15 10:12:18 +00:00			`- Graphics files`
tidying 2020-05-15 10:08:48 +00:00			`- Disk Internals`
			`- Wizardry`
			`- Infocom`
readme 2020-05-15 10:14:46 +00:00			`- Track / Sector / Block display`
Update README.md 2016-12-13 22:51:09 +00:00			`- Comprehensive disk listing`
Create README.md 2015-06-01 09:52:04 +00:00
Update README.md 2016-07-31 02:25:03 +00:00			`### Documentation`
Update README.md 2016-07-31 02:27:33 +00:00			`* [Usage](resources/usage.md)`
Update README.md 2016-07-31 02:25:03 +00:00
Update README.md 2016-07-31 02:21:28 +00:00			`### Installation`
tidying 2021-09-15 00:51:45 +00:00			`* Install the latest version of the [JDK](https://www.oracle.com/java/technologies/downloads/).`
Update README.md 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.`
doco 2019-11-22 05:42:07 +00:00			`* Set your root folder (the top-level folder where you keep your disk images).`
Update README.md 2016-07-31 02:21:28 +00:00
fixed headings 2017-03-16 02:47:14 +00:00			`### Example Screens`
			`#### Disk listing`
better descriptions 2018-10-13 22:22:38 +00:00			`Select a disk from the Disk Tree tab to display the catalog and disk layout.`
Update README.md 2015-06-01 11:15:38 +00:00			`![Disk listing](resources/disk1.png?raw=true "Disk listing")`
fixed headings 2017-03-16 02:47:14 +00:00			`#### Disk contents`
better descriptions 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.`
Update README.md 2015-06-01 11:15:38 +00:00			`![Disk catalog](resources/disk2.png?raw=true "Disk catalog")`
doco 2018-08-13 09:27:16 +00:00			`#### Detailed sector display`
better descriptions 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.`
doco 2018-08-13 09:27:16 +00:00			`![Sector details](resources/sector.png?raw=true "Sector details")`
editing 2020-05-15 10:24:09 +00:00			`#### Cross-platform`
			`Java runs on Windows, MacOS and Linux.`
spacing 2020-09-14 08:10:36 +00:00
windows screen image 2019-10-22 06:02:54 +00:00			`![Windows](resources/windows.png?raw=true "Windows")`
editing 2020-05-15 10:24:09 +00:00			`#### Graphics`
			`![Graphics](resources/graphics.png?raw=true "Graphics")`
add applesoft screen to README 2021-01-15 22:16:40 +00:00			`#### Applesoft Formatting and Analysis`
more descriptions 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.`
doco for applesoft formatting 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.`
add applesoft screen to README 2021-01-15 22:16:40 +00:00			`![Applesoft](resources/basic.png?raw=true "Applesoft")`
fixed headings 2017-03-16 02:47:14 +00:00			`#### Pascal code`
replaced pascal screen 2021-09-18 13:28:48 +00:00			`![Pascal](resources/pascal1.png?raw=true "Pascal text")`
added second pascal screen 2021-09-15 04:30:28 +00:00			`![Pascal](resources/pascal2.png?raw=true "Pascal internals")`
doco 2018-08-13 09:27:16 +00:00			`#### Infocom`
			`![Infocom](resources/zork.png?raw=true "Infocom")`
fixed headings 2017-03-16 02:47:14 +00:00			`#### Wizardry`
fixed link to WizardryApp 2022-06-10 05:59:47 +00:00			`Wizardry scenarios 1 to 3 are reasonably complete, Wizardry IV and V are partially done. For a dedicated Wizardry application see [WizardryApp](https://github.com/dmolony/WizardryApp).`
Update README.md 2015-06-01 11:15:38 +00:00			`![Wizardry](resources/wizardry.png?raw=true "Wizardry")`
explained wiz4 naming convention 2022-05-29 09:58:12 +00:00			`Scenarios 4 and 5 come on multiple disks, and they need to be named so that the only difference between disk names is the identifier before the '.dsk' suffix.`
Wizardry IV screen 2022-05-29 09:51:19 +00:00			`![Wizardry](resources/wizardry4.png?raw=true "Wizardry IV")`
fixed headings 2017-03-16 02:47:14 +00:00			`#### Visicalc`
renamed DataPanel to OutputPanel 2021-09-18 13:44:48 +00:00			`DiskBrowser has an inbuilt Visicalc processor which will evaluate the sheet and display the results.`
Update README.md 2015-06-01 11:15:38 +00:00			`![Visicalc](resources/visicalc.png?raw=true "Visicalc")`
fixed headings 2017-03-16 02:47:14 +00:00			`#### Complete Disk List`
added duplicates screenshot 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.`
Update README.md 2016-12-13 04:37:04 +00:00			`![Disk List](resources/disklist.png?raw=true "Disk List")`
added duplicates screenshot 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")`