KCEMU-REMOTE(1)

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

✨ KCEMU-REMOTE 💅

okay bestie, so this is the manual for kcemu-remote — it lives in the General Commands Manual section and it's literally a remote controller for the KC 85/4 Emulator 🎀. yes, like a TV remote but for an emulator. iconic behavior honestly.

🌸 NAME 🌸

kcemu-remote — a remote controller for the KC 85/4 Emulator 🕹️✨

🦋 SYNOPSIS 🦋

kcemu-remote command [param1=value1] [param2=value2] ...

so like… you give it a command, and then you can pile on as many param=value pairs as you need. simple. clean. slay 💅

💖 DESCRIPTION 💖

okay so real talk: this page gives you the quick-and-dirty rundown on the kcemu-remote command 📖. and ngl, this manual page exists because of Debian GNU/Linux specifically — the original program straight up did not ship with a manual page, so Debian said "fine, we'll write one ourselves" 🫶.

here's the vibe: kcemu-remote can control a KCemu that's already running by sending it commands 📨. the way it talks to it is through the X Window System, and it's network transparent — as long as the X Window Display is reachable, you're good 🔥.

🎀 EXAMPLE COMMANDS 🎀

here's the lineup, bestie. memorize it, it's giving study guide 📝✨

  • emu-reset — reset the emulator 🔄. just… reset it.
  • emu-power-on — Power-On Reset the emulator ⚡. yes that's a different kind of reset than the one above. no i will not elaborate further, that's what it says 💀.
  • emu-quit — exit the emulator 👋 bye bestie.
  • kc-image-load filename=/absolute/path/to/imagefile — load a program into the emulator 📂. and heads up: if the file you named isn't found, a filerequester will pop up 🙈 (yes, the emulator comes to you and asks).
  • kc-image-run filename=/absolute/path/to/imagefile — literally just like kc-image-load, except it also tries to start the program after it's loaded 🏃♀️💨. load + run, main character combo.
  • floppy-attach filename=/absolute/path/to/diskimage — attach a disk image 💾. and fr fr, this is the only way to change disk images for now — the user interface is not functional ;-) 😭 (yes, the semicolon-winky is canon, i'm not taking it out).
  • keyboard-replay test=text_to_insert — send the text to the emulator ⌨️💌. just fire that text right in there.
⚠️ quick note: filename= and test= above are shown exactly as the page shows them — so don't go renaming them, bestie. copy them character for character 🫶

💀 BUGS 💀

okay so, not to be the bearer of bad news, but:

  • There is no error handling 🙃. none. zero. it just goes.
  • And it is not possible to specify an emulator instance if more than one emulator is running 😭 — so if you've got multiple emulators open, good luck divining which one is gonna answer.

periodt. that's the tea ☕💅

👑 SEE ALSO 👑

go read these too, they're the friend group:

🌈 AUTHOR 🌈

This manual page was written by Torsten Paul <Torsten.Paul@gmx.de>, for the Debian GNU/Linux system (but may be used by others) 💜. so credit where credit is due, bestie — they did that 🫶

🎀 cute sign-off time: this whole page is from the General Commands Manual, the source line is KCEMU-REMOTE(1), and that footer stamp at the bottom also says KCEMU-REMOTE(1) — so yeah, it's a little self-titled album moment. stan. 💖✨🌸🦋

that's the whole page, you're welcome, go remote-control something 😌💅

📦 where this page comes from