kc2img(1)

📦 version 0.5.2, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 kc2img(1) — from the General Commands Manual 💖

okay bestie, sit down, hydrate, because we're about to talk about kc2img — section 1 of the general commands manual — and honestly? it's giving "small tool, big job" energy.

✨ NAME ✨

kc2img — convert KC files to raw KC tape images 🎀

no cap, that's the whole thing. it takes your fancy KC file and spits out a raw tape image. iconic behavior.

🦋 SYNOPSIS 🦋

kc2img <infile> <outfile>

two args. infile goes in, outfile comes out. that's it. she's low maintenance. 💅

🌸 DESCRIPTION 🌸

so here's the tea, bestie. kc2img converts the following file types into raw KC tape images. and the way those files work? they contain the data bytes exactly as written by the KC tape routines, with the block number and checksum removed. so every single block gets saved as 128 bytes. no more, no less. periodt.

machine code files start with an 128 byte header (that's one whole block, bestie) and that header contains the filename, the load start address, the load end address, and optionally a start address — whose presence is flagged by a status byte. yes, a whole flag byte just to say "the start address is here or not." main character energy tbh.

basic files? they're simpler. they only have a 13 byte header with the filename and the filesize. tiny. compact. adorable. 🍓

and now, the four file types she handles:

  1. files used by the KC emulator by Arne Fitzenreiter (usually named .TAP) — yeah, the classic
  2. files used by the GEMINI-SOFT KC emulator (usually named .GPF for machine code files and .GBF for basic files)
  3. BASIC files (usually named .SSS) 💜
  4. KC image files that contain the data written by the KC tape routines without block number and checksum (usually named .KCC or .KCB, where the .KCB files are BASIC files with an autostart routine) 🔥

so basically: .TAP, .GPF, .GBF, .SSS, .KCC, .KCB. six little extensions, one girl. she ate. 💅✨

😭 BUGS 😭

bestie. listen. Basic files are not handled properly. not me delivering bad news but here we are. 💀

just know it before you go blaming yourself, okay? it's not you. it's the basic files.

🌈 SEE ALSO 🌈

she doesn't work alone, she has a whole friend group 🫶:

👑 AUTHOR 👑

this manual page was written by Torsten Paul <Torsten.Paul@gmx.de>, for the Debian GNU/Linux system — but, and I quote, may be used by others. so yeah, she's for everyone. 💖

and that's the whole page, bestie!! shoutout to kc2img(1) for being the raw tape image converter of our dreams, and to the Debian GNU/Linux system for housing her. go convert something. slay. ✨🎀💅

📦 where this page comes from