hatariui - Man Page

Python/Gtk UI for Hatari

Synopsis

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

Description

hatariui is a Python/Gtk UI for Hatari which can either embed the Hatari window (on X11 systems) or run in a separate window.  By default it provides normal application menus and some extra buttons for faster access to fast-forward and other functionality, but these are fully configurable with the command line options. While it lacks support for some of the Hatari configuration options that Hatari SDL GUI has, it also supports some options that the Hatari built-in SDL GUI doesn't.

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

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 rest of the Hatari UI Python scripts and data files.

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.

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!

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

hmsa(1), hconsole(1)

Referenced By

hatari(1), hatari_profile(1), hconsole(1).

2025-05-28 Hatari UI