Retro/pcjs
Watch
1
0
Fork
You've already forked pcjs
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
pcjs/modules/diskdump
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Jeff Parsons 288f28055d Starting work on disambiguating PCjs the emulator from PCjs the project/website; the emulator will become PCx86
2016-05-16 20:55:32 -07:00
..
bin v1.16.5: Getting ready for 2015 2014-12-29 23:06:28 -08:00
lib Starting work on disambiguating PCjs the emulator from PCjs the project/website; the emulator will become PCx86 2016-05-16 20:55:32 -07:00
package.json Replaced loadResource() with the more streamlined getResource(), for all your resource-getting needs (well, except for binary files, which should be coming soon) 2016-02-21 15:51:54 -08:00
README.md Updated aspect ratio for CGA configs and added experimental 'aspect' URL parameter 2016-04-01 21:36:06 -07:00

README.md

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/pc/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/pc/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/pc/1981/visicalc/vc.com;README.md&format=img

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