pcjs/modules/diskdump

layout	title	permalink
page	DiskDump Module	/modules/diskdump/

DiskDump Module

DiskDump is a Node module with both a command-line interface and a web server API for converting disk images to/from various formats (eg, JSON files, JSON files with comments, IMG disk images, etc).

Building Disk Images from Folders/Files

In addition to converting disk images to/from JSON, DiskDump can also create disk images from the contents of local files/folders.

For example, from the root directory of the project, you could run:

node modules/diskdump/bin/diskdump --path="apps/pcx86/1981/visicalc/README.md" --format=img --output=disk.img

to produce a disk.img containing one file, "README.md", which you could then mount on your local operating system or inside a PCjs machine.

To make the disk image more useful, you might want to download a copy of VisiCalc into that folder as well, so that you could then run:

node modules/diskdump/bin/diskdump --path="apps/pcx86/1981/visicalc/vc.com;README.md" --format=img --output=disk.img

to produce a disk.img containing both "VC.COM" and "README.md". In fact, this is exactly how the disk.json stored in the VisiCalc folder was generated.

The equivalent web server API request would look like:

http://localhost:8088/api/v1/dump?path=/apps/pcx86/1981/visicalc/vc.com;README.md&format=img

DiskDump is a port of the original JavaScript Machines convdisk.php utility.