1hatariui(1) Hatari UI hatariui(1)
2
6 hatariui - Python/Gtk UI for Hatari
7
9 hatariui | hatariui.py [options] [directory|diskimage|program]
10
12 hatariui is a Python/Gtk UI for Hatari which can either embed the
13 Hatari window (on X11 systems) or run in a separate window. By default
14 it provides a normal application menu and some extra button for faster
15 access to fast-forward etc. functionality, but these are fully config‐
16 urable with the command line options. While it lacks support for some
17 of the Hatari configuration options that Hatari's SDL GUI has, it also
18 supports some options that the Hatari's built-in SDL UI doesn't.
19 Besides the UI configurability, some of the other advantages hatariui
21 has over the SDL interface included with Hatari itself are use of a
22 normal Gtk file selector with all of its features (directory shortcuts
23 etc), support for UTF-8 (in file names) and in general blending better
24 to the user's desktop environment.
25 Additionally, Hatari can run while one uses UI configuration dialogs,
27 and it can stop Hatari completely to better save the battery on mobile
28 computers. For devices without a keyboard, it offers a a text input
29 dialog and one can configure (from command line) buttons for often used
30 strings.
31
33 hatariui is actually a shell script wrapper for the hatariui.py Python
34 script. It's used to run the Python script with suitable options for
35 default usage and to set up the correct installation directory for the
36 rest of the Hatari UI Python scripts and data files.
37 Options below are actually for hatariui.py script. If you want to
39 change options given for it, modify the hatariui shell script or make
40 your own based on the installed one.
41
43 -h, --help
44 Hatari UI command line help
45 -n, --nomenu
47 Omit menubar from the window
48 -e, --embed
50 Embed Hatari window (to middle of controls)
51 -f, --fullscreen
53 Start in fullscreen
54 -l, --left <controls>
56 Add a toolbar at left
57 -r, --right <controls>
59 Add a toolbar at right
60 -t, --top <controls>
62 Add a toolbar at top
63 -b, --bottom <controls>
65 Add a toolbar at bottom
66 -p, --panel <name>,<controls>
68 Add a separate window with given name and controls
69 You can have only one toolbar on each side of the Hatari window. Pan‐
71 els are separate windows and you can has as many of them as you wish.
72 For each panel you need to add a control with the name of the panel
73 (see "MyPanel" in examples).
74 Following controls can are available for toolbars and panels:
76 | Separator between controls
78 > Next toolbar in panel windows
80 compatibility
82 Hatari compatibility list
83 harddisk
85 Hard disk images and directories
86 reset Warm or cold reset Hatari
88 sconfig
90 Save configuration
91 bugs Report a bug
93 display
95 Display settings
96 authors
98 Hatari authors
99 forward
101 Whether to fast forward Hatari (needs fast machine)
102 debug Activate Hatari debugger
104 quit Quit Hatari UI
106 hatari Hatari home page
108 recanim
110 Record animation
111 recsound
113 Record YM/Wav
114 mails Hatari mailing lists
116 floppy Floppy images
118 device Toggle Midi, Printer, RS232 peripherals
120 load Load emulation snapshot
122 lconfig
124 Load configuration
125 path Device & save file paths
127 machine
129 Hatari st/e/tt/falcon configuration
130 todo Hatari TODO
132 hatariui
134 Hatari UI home page
135 save Save emulation snapshot
137 joystick
139 Joystick settings
140 trace Hatari tracing setup
142 pause Pause Hatari to save battery
144 about Hatari UI information
146 release
148 Hatari release notes
149 full Toggle whether Hatari is fullscreen
151 manual Hatari manual
153 input Simulate text input and mouse clicks
155 sound Sound settings
157 changes
159 Latest Hatari changes
160 run (Re-)run Hatari
162 shot Grab a screenshot
164 <panel name>
166 Button for the specified panel window
167 <name>=<string/code>
169 Synthetize string or single key <code>
170 If no options are given, the UI uses basic controls.
172
174 Example on how to add top, right and bottom toolbars and a separate
175 "MyPanel" panel window:
176 hatariui.py --embed \
177 -t "about,run,pause,quit" \
178 -p "MyPanel,Macro=Test,Undo=97,Help=98,>,F1=59,F2=60,>,close" \
179 -r "paste,debug,trace,machine,MyPanel" \
180 -b "sound,|,forward,|,fullscreen"
181 For more examples on Hatari UI options usage, see the hatariui shell
183 script.
184
186 hmsa(1), hatariui(1), hconsole(1)
187
189 Hatari UI is written by Eero Tamminen <eerot@berlios.de>.
190 This program is free software; you can redistribute it and/or modify it
192 under the terms of the GNU General Public License as published by the
193 Free Software Foundation; either version 2 of the License, or (at your
194 option) any later version.
195 This program is distributed in the hope that it will be useful, but
197 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
198 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
199 Public License for more details.
200Hatari 2010-05-30 hatariui(1)