--- hatari/python-ui/README 2019/04/09 08:49:56 1.1.1.4 +++ hatari/python-ui/README 2019/04/09 08:52:28 1.1.1.7 @@ -11,8 +11,9 @@ itself. The UI is done with PyGtk i.e. i Gtk widget set. The main points of this new UI over the Hatari internal one are its -configurability and providing a GUI for the (console based) debugger -included with the Hatari emulator. +configurability, more usable file selector, internationalization +support and providing a GUI for the (console based) debugger included +with the Hatari emulator. Note: this is an additional UI, the built-in Hatari SDL UI isn't being replaced or going anywhere! @@ -22,16 +23,16 @@ Requirements ------------ My guess at the required versions for the dependencies are: -- Python >= 2.4 +- Python >= 2.6 - PyGtk >= 2.12 (on Debian/Ubuntu PyGtk is in python-gtk2 package) Hatari UI is included with the Hatari sources: http://hg.tuxfamily.org/mercurialroot/hatari/hatari/file/tip/python-ui -Hatari UI has been tested only on Linux (Ubuntu v7.04 and Debian Lenny -& Squeeze). I would assume it works also on other unix systems such as -Apple OSX. It won't work on Windows as the required Windows socket -support is missing from the Hatari emulator. +Hatari UI has been tested on several Linux versions. I would assume +it to work also on other unix systems such as Apple OSX. It may work +with the Hatari Windows version, as long as it is built with socket +support. Embedding the Hatari emulator window is currently supported only for systems using an X window system (from libSDL sources it would seem @@ -39,13 +40,17 @@ that Windows would also support window e would need to be added both to Hatari and Hatari UI because SDL's own embedding disables all keyboard events in SDL program). +Here are instructions on installing the dependencies for non-Linux +platforms (neither tested nor supported as I don't use/have them): + http://pygtk.org/downloads.html + Running ------- Being a Python program, Hatari UI doesn't need to be built. You can just run it from where you extracted it (or checked -it out of BerliOS HG repo) by calling its wrapper script: +it out of TuxFamily HG repo) by calling its wrapper script: /path/to/script/hatariui Or you can run just the debugger: @@ -61,7 +66,7 @@ Notes Hatari UI runs a Hatari version found on $PATH. If you want to use a version of Hatari that hasn't been installed, you need to modify the search path, for example like this: - PATH=../src:$PATH hatariui + PATH=../build/src:.:$PATH hatariui If UI is started without the embedding option, the actions (in menus and toolbars) have also shortcuts. They cannot @@ -69,4 +74,5 @@ be used when Hatari window is embedded b shortcuts couldn't be used with Hatari. -URL: http://koti.mbnet.fi/tammat/hatari/hatari-ui.shtml +A www-page with more information about Hatari UI is here: + http://koti.mbnet.fi/tammat/hatari/hatari-ui.shtml