Apple-2-Tools/diskm8
1
0
Fork 0
mirror of https://github.com/paleotronic/diskm8.git synced 2024-12-21 18:29:43 +00:00
Code Issues Projects Releases Wiki Activity

Fix readme

Browse Source
This commit is contained in:
April Ayres-Griffiths 2018-01-20 11:07:15 +11:00
parent 75d42c4597
commit d8e6b1d719
1 changed files with 14 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
README.md
View File

@ -1,6 +1,6 @@
DSKalyzer is a cross-platform command-line tool for manipulating and managing Apple II DSK (and other) images.
DiskM8 is a cross-platform command-line tool for manipulating and managing Apple II DSK (and other) images.
Download from: https://github.com/paleotronic/dskalyzer/releases
Download from: https://github.com/paleotronic/diskm8/releases
Features include:
@ -17,17 +17,17 @@ Features include:
- Open source; GPLv3 licensed.
- Written in Go!
DSKalyzer is a command line tool for analyzing and managing Apple II DSK images and their archives. Its features include not only the standard set of disk manipulation tools -- extract (with text conversion), import to disk (including tokenisation of Applesoft BASIC), delete, and so forth -- but also the ability to identify duplicates — complete, active sector, and subset; find file, sector and other commonalities between disks (including as a percentage of similarity or difference); search de-tokenized BASIC, text and binary / sector data; generate reports identifying and / or collating disk type, DOS, geometry, size, and so forth; allowing for easier, semi-automated DSK archival management and research.
DiskM8 is a command line tool for analyzing and managing Apple II DSK images and their archives. Its features include not only the standard set of disk manipulation tools -- extract (with text conversion), import to disk (including tokenisation of Applesoft BASIC), delete, and so forth -- but also the ability to identify duplicates — complete, active sector, and subset; find file, sector and other commonalities between disks (including as a percentage of similarity or difference); search de-tokenized BASIC, text and binary / sector data; generate reports identifying and / or collating disk type, DOS, geometry, size, and so forth; allowing for easier, semi-automated DSK archival management and research.
DSKalyzer works by first “ingesting” your disk(s), creating an index containing various pieces of information (disk / sector / file hashes, catalogs, text data, binary data etc.) about each disk that is then searchable using the same tool. This way you can easily find information stored on disks without tediously searching manually or through time-consuming multiple image scans. You can also identify duplicates, quasi-duplicates (disks with only minor differences or extraneous data), or iterations, reducing redundancies.
DiskM8 works by first “ingesting” your disk(s), creating an index containing various pieces of information (disk / sector / file hashes, catalogs, text data, binary data etc.) about each disk that is then searchable using the same tool. This way you can easily find information stored on disks without tediously searching manually or through time-consuming multiple image scans. You can also identify duplicates, quasi-duplicates (disks with only minor differences or extraneous data), or iterations, reducing redundancies.
Once you've identified a search you can also extract selected files. DSKalyzer can report to standard output (terminal), to a text file, or to a CSV file.
Once you've identified a search you can also extract selected files. DiskM8 can report to standard output (terminal), to a text file, or to a CSV file.
```
Shell commands (executing DSKalyzer without flags enters shell):
Shell commands (executing DiskM8 without flags enters shell):
Note: You must mount a disk before performing tasks on it.
analyze Process disk using dskalyzer analytics
analyze Process disk using diskm8 analytics
cat Display file information
cd Change local path
copy Copy files from one volume to another
@ -81,7 +81,7 @@ Command-line flags:
-csv
Output data to CSV format
-datastore string
Database of disk fingerprints for checking (default "/Users/melody/DSKalyzer/fingerprints")
Database of disk fingerprints for checking (default "/Users/nnnnn/DiskM8/fingerprints")
-dir
Directory specified disk (needs -disk)
-dir-create string
@ -145,23 +145,23 @@ Command-line flags:
```
Getting Started
Ingest your disk collection, so dskalyzer can report on them:
Ingest your disk collection, so diskm8 can report on them:
dskalyzer -ingest "C:\Users\myname\LotsOfDisks"
diskm8 -ingest "C:\Users\myname\LotsOfDisks"
Simple Reports
Find Whole Disk duplicates:
dskalyzer -whole-dupes
diskm8 -whole-dupes
Find Active Sectors duplicates (inactive sectors can be different):
dskalyzer -as-dupes
diskm8 -as-dupes
Find Duplicate files across disks:
dskalyzer -file-dupes
diskm8 -file-dupes
Limiting reports to subdirectories
Find Active Sector duplicates but only under a folder:
dskalyzer -as-dupes -select "C:\Users\myname\LotsOfDisks\Operating Systems"
diskm8 -as-dupes -select "C:\Users\myname\LotsOfDisks\Operating Systems"
```