Scroll to navigation

hatariui(1) Hatari UI hatariui(1)

NAME

hatariui - 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's SDL GUI has, it also supports some options that the Hatari's built-in SDL UI doesn't.

Besides the UI configurability, some of the other advantages hatariui has over the SDL interface 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 a text input dialog and one can configure (from command line) buttons for often used strings.

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
compatibility
Hatari compatibility list
harddisk
Hard disk config dialog
reset
Warm or cold reset Hatari
sconfig
Save configuration
bugs
Report a bug
display
Display settings dialog
authors
Hatari authors
forward
Toggle Hatari fast-forward
debug
Activate Hatari debugger
quit
Quit Hatari UI
hatari
Hatari home page
recanim
Record animation
recsound
Record YM/Wav
mails
Hatari mailing lists
floppy
Floppy image dialog
device
Midi / Printer / RS232 enabling dialog
load
Load emulation snapshot
lconfig
Load configuration
path
Path config dialog
machine
Hatari machine config dialog
todo
Hatari TODO
hatariui
Hatari UI home page
save
Save emulation snapshot
joystick
Joystick settings dialog
trace
Hatari tracing dialog
pause
Pause Hatari to save battery
about
Hatari UI information
release
Hatari release notes
full
Toggle whether Hatari is fullscreen
manual
Hatari manual
input
Text / mouse click injection dialog
sound
Sound settings dialog
changes
Latest Hatari changes
run
(Re-)run Hatari
shot
Grab a screenshot
<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), hatariui(1), hconsole(1)

COPYRIGHT

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.

2020-12-15 Hatari