HCONSOLE(1)

💖 HCONSOLE(1) 💖

Hatari utilities · hconsole — bestie, it's the interactive Python console for using Hatari's remote API 🌸

---

✨ NAME ✨

hconsole — an interactive Python console so you can vibe with Hatari's remote API 🦋

---

🌈 SYNOPSIS 🌈

hconsole.py [[consoleoptions] [commandfile] --] [hatarioptions]

---

💅 DESCRIPTION 💅

Okay so hconsole is a Python script that literally invokes Hatari and then hands you an interactive shell — with full readline editing capabilities, no cap — where you can run Hatari remote API commands. 👑

It's giving perfect first-date energy for exploring Hatari's remote API interactively, and then (once you're comfy) writing scripts that automate your Hatari usage in some way. Those scripts can borrow hconsole's whole thing just by doing import hconsole and calling the appropriate methods — see example.py that ships with hconsole, iykyk. ✨

---

🎀 USAGE 🎀

So normally hconsole forwards all of its arguments to the Hatari instance it just invoked. That's the default, that's the vibe.

But if you wanna give arguments to hconsole itself? You gotta drop a -- argument after the hconsole arguments and before the arguments headed to Hatari. That's the little divider, the velvet rope, the ✨ boundary ✨.

If you hand it a file name as an hconsole argument, the commands inside it get read and executed through Hatari's remote API before you land in the hconsole interactive shell. Pre-game commands, basically. 💖

Hconsole accepts these options, bestie:

• --exit — bounce out right after starting Hatari and parsing arguments. Like, done, bye. 👋
• --help, -h — show the command line help. Not me forgetting the flags every single time 😭

---

🌟 EXAMPLES 🌟

Start Hatari with all of the given arguments:

hconsole.py --monitor mono -d test/

Start Hatari with no extra arguments, execute commands from the given commands.txt file, and exit once the file ends:

hconsole.py commands.txt --exit --

---

🍓 FILES 🍓

By default, hconsole and its examples are installed under the /usr/share/hatari/hconsole/ directory. That's where they live. That's their home. 🏠

---

🧚 SEE ALSO 🧚

hatari(1), hatariui(1)

---

💜 AUTHOR 💜

Written by Eero Tamminen <oak at helsinkinet fi>. Legend behavior, fr fr. 👑

---

🔥 LICENSE 🔥

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

---

💀 NO WARRANTY 💀

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Okay bestie this part is not a joke: no warranty, none, zero, nada. It's giving "hope for the best" energy and nothing more. 🙈

---

And that's the whole page, periodt. This one came from the Hatari crew, dated 2010-10-10, and it's filed under HCONSOLE(1) — go forth and console interactively, you main character. 💅✨