omsxctl

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

install

you can install omsxctl with cargo:

sh 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.