IMGTOOL(1)

✨ IMGTOOL(1) ✨

okay bestie, so this is the manual page for imgtool, the MESS media image manipulation tool πŸ’– β€” like, it's the little icon that handles all your disk images and other image types that MESS girlies have to deal with. She's giving main character energy for real.


πŸ¦‹ NAME πŸ¦‹

imgtool β€” MESS media image manipulation tool πŸ‘‘


🌸 SYNOPSIS 🌸

imgtool create format image [option ...]
imgtool dir format image [path]
imgtool get format image file [newname] [--filter=filter] [--fork=fork]
imgtool put format image file ...  [newname] [option ...]
[--filter=filter] [--fork=fork]
imgtool getall format image [path] [--filter=filter]
imgtool del format image file ...
imgtool mkdir format image directory
imgtool rmdir format image directory ...
imgtool readsector|writesector format image track head sector file
imgtool identify image
imgtool listformats|listfilters
imgtool listdriveroptions format

πŸ’… DESCRIPTION πŸ’…

so basically imgtool is the tool for keeping up and messing around with disk images and all the other kinds of images that MESS users gotta deal with. like, she does it all ✨

her little bag of tricks includes:

  • retrieving files
  • storing files
  • CRC checking
  • validation

and also, plot twist 🫢 β€” those image files can be inside .zip files too. no cap.


πŸŽ€ OPTIONS πŸŽ€

  • create β€” creates an image, periodt πŸ’«. you can also pass image-specific parameters if you want β€” run the imgtool listdriveroptions command for the full list, bestie.
  • dir β€” lists what's inside an image. peek inside, slay 🌈
  • get β€” pulls a single file out of an image. you can hand her a filter to convert custom file formats to ASCII (check imgtool listfilters for the full list, iykyk). the file can also optionally get renamed ✨
  • put β€” drops file(s) onto an image (wildcards and rename are supported, obsessed πŸ’–). filters get supplied to convert ASCII files into custom file formats β€” again, imgtool listfilters has the whole list.
  • getall β€” grabs all the files off an image 🧚. filters can be specified to convert custom file formats to ASCII β€” imgtool listfilters for the full list.
  • del β€” deletes a file on an image. bye bestie πŸ’€
  • mkdir β€” creates a directory on an image πŸŽ€
  • rmdir β€” deletes directories on an image 🫢
  • readsector β€” extracts the content of a single sector from an image out to a file πŸ“
  • writesector β€” writes file content to a specific sector on an image ⭐
  • identify β€” tries to recognize the format of an image file. detective era πŸ”
  • listformats β€” lists every image file format that imgtool supports πŸ‘‘
  • listfilters β€” lists every filter that imgtool supports. filters are, like, a way to process data being written into or read out of an image in a certain way. it's giving transformation πŸ’…
  • listdriveroptions β€” lists all the format-specific options for the imgtool put and imgtool create commands. the receipts, basically 🧾

🌟 EXAMPLES 🌟

imgtool dir coco_jvc_rsdos myimageinazip.zip
imgtool get coco_jvc_rsdos myimage.dsk myfile.bin mynewfile.txt
imgtool getall coco_jvc_rsdos myimage.dsk

πŸ”₯ SEE ALSO πŸ”₯

  • mess (6)

okay that's the whole thing, bestie, you're officially an imgtool girlie now πŸ’œβœ¨ this was version 0.176, dated 2016-07-21 β€” yeah she's a lil vintage, vintage is iconic tho πŸŽ€ mwah, go slay some disk images πŸ«ΆπŸ’–