omsxctl

omsxctl is a small rust cli console for controlling openMSX over its socket API.

install

you can install omsxctl with cargo:

cargo install omsxctl

I may offer builds and/or packages in the future - we'll see.

use

first, start openMSX in the default socket ouput mode (in Linux/MacOS). then fire up omsxctl and enjoy:

$ omsxctl
2022-07-01T18:04:53.288463Z  INFO omsxctl: openmsx is ready.
openmsx> set power off
ok: false
openmsx> set power on
ok: true
openmsx> set power bananas
nok: can't set "power": expected boolean value but got "bananas"

openmsx>

$

if you do this on your own machine, you'll see that openMSX power cycles the emulator.

development

things are pretty informal. the program doesn't have a lot of surface area to unit test - heck, the entire thing is in a single line right now. but otherwise cargo run and friends work.

I don't see a ton of feature work on this project going forward. the biggest missing feature in my mind is non-pretty output formats such as json or even xml. if you want to take a crack at it, don't let me stop you!

license

I'm putting this out there with an Apache 2.0 license. Read the LICENSE file for more.