hatariui(1)

📦
version 2.6.1 · 2 versions
, in fedora 43, fedora 44

👑 hatariui — the Python/Gtk glow-up for Hatari 👑

okay so bestie, you're holding the manual page for hatariui(1), from the Hatari UI manual. let's get into it 💖

✨ NAME ✨

hatariui — a Python/Gtk UI for Hatari. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

hatariui | hatariui.py [options] [directory|diskimage|program]

💅 DESCRIPTION 💅

hatariui is a Python/Gtk UI for Hatari, and it's giving flexible. it can either embed the Hatari window (on X11 systems) or run in a separate window — your call, bestie. 💖

by default it hands you normal application menus plus some extra buttons for faster access to fast-forward and other functionality, but ngl those are fully configurable with the command line options. and yeah, it lacks support for some of the Hatari configuration options that the Hatari SDL GUI has, but it also supports some options that the Hatari built-in SDL GUI doesn't. balanced, as all things should be. ⚖️

besides the UI configurability, some of the other advantages hatariui has over the SDL GUI included with Hatari itself are:

  • use of a normal Gtk file selector with all of its features (directory shortcuts etc) 🗂️
  • support for UTF-8 (in file names) ✨
  • and in general blending better to the user's desktop environment 💅

additionally, Hatari can run while one uses UI configuration dialogs, and it can stop Hatari completely to better save the battery on mobile computers. 🔋 for devices without a keyboard, it offers a text input dialog and one can configure buttons for often used strings (with command line options). no cap. 🫶

🧚 HATARIUI / HATARIUI.PY 🧚

hatariui is a shell script wrapper for the hatariui.py Python script. it's used to run the Python script with suitable options for default usage, and to set up the correct installation directory for the rest of the Hatari UI Python scripts and data files. 📁

okay so the options below are actually for the hatariui.py script. if you want to change options given for it, modify the hatariui shell script or make your own based on the installed one. iykyk. 😌

🔥 OPTIONS 🔥

  • -h, --help — Hatari UI command line help 🆘
  • -n, --nomenu — Omit menubar from the window 🙈
  • -e, --embed — Embed Hatari window (to middle of controls) 🫂
  • -f, --fullscreen — Start in fullscreen 🖥️
  • -l, --left <controls> — Add a toolbar at left ⬅️
  • -r, --right <controls> — Add a toolbar at right ➡️
  • -t, --top <controls> — Add a toolbar at top ⬆️
  • -b, --bottom <controls> — Add a toolbar at bottom ⬇️
  • -p, --panel <name>,<controls> — Add a separate window with given name and controls 🪟

you can have only one toolbar on each side of the Hatari window. panels are separate windows and you can have as many of them as you wish. ✨ for each of the panels, you need to add a button with the name of the panel (see "MyPanel" in the Examples section). 📌

following buttons can be added to toolbars and panels:

  • | — Separator between action buttons
  • > — Start next toolbar row in panel windows
  • about — Hatari UI information
  • authors — Hatari authors
  • bugs — Report a bug
  • changes — Latest Hatari changes
  • compatibility — Hatari compatibility list
  • debug — Activate Hatari debugger
  • device — Midi / Printer / RS232 enabling dialog
  • display — Display settings dialog
  • floppy — Floppy image dialog
  • forward — Toggle Hatari fast-forward
  • full — Toggle whether Hatari is fullscreen
  • harddisk — Hard disk config dialog
  • hatari — Hatari home page
  • hatariui — Hatari UI home page
  • input — Text / mouse click injection dialog
  • joystick — Joystick settings dialog
  • lconfig — Load configuration
  • load — Load emulation snapshot
  • machine — Hatari machine config dialog
  • mails — Hatari mailing lists
  • manual — Hatari manual
  • path — Path config dialog
  • pause — Pause Hatari to save battery
  • quit — Quit Hatari UI
  • recanim — Record animation
  • recsound — Record YM/Wav
  • release — Hatari release notes
  • reset — Warm or cold reset Hatari
  • run — (Re-)run Hatari
  • save — Save emulation snapshot
  • sconfig — Save configuration
  • shot — Grab a screenshot
  • sound — Sound settings dialog
  • todo — Hatari TODO
  • trace — Hatari tracing dialog
  • uirelease — Hatari UI release notes
  • <panel name> — Button for the specified panel window
  • <name>=<string/code> — Synthetize string or single key <code>.
⚠️ NOTE: disable fast-forward before injection or key-repeat will repeat each injected key! 😭 fr fr, don't skip this one.

if no options are given, the UI uses basic controls. 🎀

🌈 EXAMPLES 🌈

example on how to add top, right and bottom toolbars and a separate "MyPanel" panel window:

hatariui.py --embed \
-t "about,run,pause,quit" \
-p "MyPanel,Macro=Test,Undo=97,Help=98,>,F1=59,F2=60,>,close" \
-r "pause,debug,trace,machine,MyPanel" \
-b "sound,|,forward,|,full"

for more examples on Hatari UI options usage, see the hatariui shell script. 👀

🦋 SEE ALSO 🦋

Hatari UI is written by Eero Tamminen <oak at helsinkinet fi>. 👑

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.

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.

and that's the whole page bestie, mwah 💋 — this cutie dropped as part of Hatari, dated 2025-05-28, and it's filed right there in section hatariui(1). slay, go configure some toolbars. ✨💖

📦 where this page comes from