Skip to content

algodesigner/msxdsk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MSX Disk Manipulation Utility

A CLI tool for creating and manipulating MSX-DOS (FAT12) floppy disk images. This utility allows users to manage files on .dsk images, extract content, and create new formatted disks compatible with MSX hardware and emulators.

Features

  • Create: Generate new 720KB MSX-DOS formatted disk images with custom volume labels.
  • List: View files and subdirectories on a disk image with size and attribute information.
  • Info: Display detailed disk geometry, including total, used, and free sectors.
  • Add: Inject files from the host system into a disk image.
  • Extract: Copy files from a disk image to the host system with binary integrity.
  • Delete: Remove files from a disk image and reclaim space.

Requirements

  • GCC (or any C99 compatible compiler)
  • Make
  • Bash (for running tests)

Building

To compile the utility, simply run:

make

This will generate the msxdsk executable.

Usage

./msxdsk <command> [options]

Commands

  • create <image.dsk> [label]: Create a new disk image.
  • list <image.dsk>: List files on the disk.
  • info <image.dsk>: Show disk information.
  • extract <image.dsk> <file> [output]: Extract a file from the disk.
  • add <image.dsk> <hostfile> [msxname [ext]]: Add a file to the disk.
  • delete <image.dsk> <file>: Delete a file from the disk.

Examples

# Create a new disk image
./msxdsk create games.dsk MYGAMES

# Add a file to the disk
./msxdsk add games.dsk mygame.rom GAME ROM

# List files on the disk
./msxdsk list games.dsk

# Extract a file
./msxdsk extract games.dsk GAME.ROM extracted.rom

Testing

The project includes an automated test suite that verifies core functionality and binary integrity:

make test

License

This project is licensed under the 3-Clause BSD License. See the LICENSE file for details.

Author: Vlad Shurupov

About

MSX-DOS disk image manipulation tool. Create, list, and manage files on MSX floppy disk images from the command line.

Topics

Resources

License

Stars

Watchers

Forks

Contributors