mirror of
https://github.com/paleotronic/diskm8.git
synced 2024-09-07 21:54:28 +00:00
180 lines
7.0 KiB
Markdown
180 lines
7.0 KiB
Markdown
DiskM8 is a cross-platform command-line tool for manipulating and managing Apple II DSK (and other) images.
|
|
|
|
Download from: https://github.com/paleotronic/diskm8/releases
|
|
|
|
Features include:
|
|
|
|
- Read from ProDOS, DOS 3.X, RDOS and Pascal disk images;
|
|
- ProDOS or DOS ordered; DSK, PO, 2MG and NIB; 113-800K
|
|
- Write to Prodos and DOS 3.3 disk images;
|
|
- Extract and convert binary, text and detokenize BASIC files (Integer and Applesoft);
|
|
- Write binary, text and retokenized BASIC (Applesoft) files back to disk images;
|
|
- Copy and move files between disk images; delete files, create new folders (ProDOS), etc;
|
|
- Generate disk reports that provide track and sector information, text extraction and more;
|
|
- Compare multiple disks to determine duplication, or search disks for text or filenames.
|
|
- Use command-line flags (allows for automation) or an interactive shell;
|
|
- Builds for MacOS, Windows, Linux, FreeBSD and Raspberry Pi.
|
|
- Open source; GPLv3 licensed.
|
|
- Written in Go!
|
|
|
|
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.
|
|
|
|
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. DiskM8 can report to standard output (terminal), to a text file, or to a CSV file.
|
|
```
|
|
Shell commands (executing DiskM8 without flags enters shell):
|
|
|
|
Note: You must mount a disk before performing tasks on it.
|
|
|
|
analyze Process disk using diskm8 analytics
|
|
cat Display file information
|
|
cd Change local path
|
|
copy Copy files from one volume to another
|
|
delete Remove file from disk
|
|
disks List mounted volumes
|
|
extract extract file from disk image
|
|
help Shows this help
|
|
info Information about the current disk
|
|
ingest Ingest directory containing disks (or single disk) into system
|
|
lock Lock file on the disk
|
|
ls List local files
|
|
mkdir Create a directory on disk
|
|
mount Mount a disk image
|
|
move Move files from one volume to another
|
|
prefix Change volume path
|
|
put Copy local file to disk (with optional target dir)
|
|
quarantine Like report, but allow moving dupes to a backup folder
|
|
quit Leave this place
|
|
rename Rename a file on the disk
|
|
report Run a report
|
|
search Run a search
|
|
target Select mounted volume as default
|
|
unlock Unlock file on the disk
|
|
unmount unmount disk image
|
|
|
|
Command-line flags:
|
|
|
|
(Note: You must ingest your disk library before you can run comparison or search operations on it)
|
|
|
|
-active-sector-partial
|
|
Run partial sector match (active only) against all disks
|
|
-active-sector-subset
|
|
Run subset (active) sector match against all disks
|
|
-adorned
|
|
Extract files named similar to CP (default true)
|
|
-all-file-partial
|
|
Run partial file match against all disks
|
|
-all-file-subset
|
|
Run subset file match against all disks
|
|
-all-sector-partial
|
|
Run partial sector match (all) against all disks
|
|
-all-sector-subset
|
|
Run subset (non-zero) sector match against all disks
|
|
-as-dupes
|
|
Run active sectors only disk dupe report
|
|
-as-partial
|
|
Run partial active sector match against single disk (-disk required)
|
|
-c Cache data to memory for quicker processing (default true)
|
|
-cat-dupes
|
|
Run duplicate catalog report
|
|
-catalog
|
|
List disk contents (-with-disk)
|
|
-csv
|
|
Output data to CSV format
|
|
-datastore string
|
|
Database of disk fingerprints for checking (default "/home/myname/DiskM8/fingerprints")
|
|
-dir
|
|
Directory specified disk (needs -disk)
|
|
-dir-create string
|
|
Directory to create (-with-disk)
|
|
-dir-format string
|
|
Format of dir (default "{filename} {type} {size:kb} Checksum: {sha256}")
|
|
-extract string
|
|
Extract files/disks matched in searches ('#'=extract disk, '@'=extract files)
|
|
-file string
|
|
Search for other disks containing file
|
|
-file-delete string
|
|
File to delete (-with-disk)
|
|
-file-dupes
|
|
Run file dupe report
|
|
-file-extract string
|
|
File to delete from disk (-with-disk)
|
|
-file-partial
|
|
Run partial file match against single disk (-disk required)
|
|
-file-put string
|
|
File to put on disk (-with-disk)
|
|
-force
|
|
Force re-ingest disks that already exist
|
|
-ingest string
|
|
Disk file or path to ingest
|
|
-ingest-mode int
|
|
Ingest mode:
|
|
0=Fingerprints only
|
|
1=Fingerprints + text
|
|
2=Fingerprints + sector data
|
|
3=All (default 1)
|
|
-max-diff int
|
|
Maximum different # files for -all-file-partial
|
|
-min-same int
|
|
Minimum same # files for -all-file-partial
|
|
-out string
|
|
Output file (empty for stdout)
|
|
-quarantine
|
|
Run -as-dupes and -whole-disk in quarantine mode
|
|
-query string
|
|
Disk file to query or analyze
|
|
-search-filename string
|
|
Search database for file with name
|
|
-search-sha string
|
|
Search database for file with checksum
|
|
-search-text string
|
|
Search database for file containing text
|
|
-select
|
|
Select files for analysis or search based on file/dir/mask
|
|
-shell
|
|
Start interactive mode
|
|
-shell-batch string
|
|
Execute shell command(s) from file and exit
|
|
-similarity float
|
|
Object match threshold for -*-partial reports (default 0.9)
|
|
-verbose
|
|
Log to stderr
|
|
-whole-dupes
|
|
Run whole disk dupe report
|
|
-with-disk string
|
|
Perform disk operation (-file-extract,-file-put,-file-delete)
|
|
-with-path string
|
|
Target path for disk operation (-file-extract,-file-put,-file-delete)
|
|
```
|
|
|
|
## Getting Started
|
|
|
|
Ingest your disk collection, so diskm8 can report on them:
|
|
|
|
```diskm8 -ingest "C:\Users\myname\LotsOfDisks"```
|
|
|
|
### Simple Reports
|
|
|
|
Find Whole Disk duplicates:
|
|
|
|
```diskm8 -whole-dupes```
|
|
|
|
Find Active Sectors duplicates (inactive sectors can be different):
|
|
|
|
```diskm8 -as-dupes```
|
|
|
|
Find Duplicate files across disks:
|
|
|
|
```diskm8 -file-dupes```
|
|
|
|
### Limiting reports to subdirectories
|
|
|
|
Find Active Sector duplicates but only under a folder:
|
|
|
|
```diskm8 -as-dupes -select "C:\Users\myname\LotsOfDisks\Operating Systems"```
|
|
|
|
### Putting a file onto a disk in a particular path
|
|
|
|
```diskm8 -with-disk prodos_basic.dsk -with-path practice -file-put start#0x0801.BAS```
|