HCONSOLE(1)							 Hatari utilities						       HCONSOLE(1)

NAME

       hconsole - Interactive Python console for using Hatari's remote API

SYNOPSIS

       hconsole.py [[consoleoptions] [commandfile] --] [hatarioptions]

DESCRIPTION

       Hconsole  is  a Python script that invokes Hatari and then provides an interactive shell (with full readline editing capabilities) for exe-
       cuting Hatari remote API commands.

       It can be useful for first exploring Hatari's remote API usage interactively and then writing scripts that  somehow  automate  your  Hatari
       usage.	They  can  invoke  hconsole functionality simply by doing "import hconsole" and calling appropriate methods (see example.py coming
       with hconsole).

USAGE

       Normally hconsole forwards  all of its arguments to Hatari instance it invoked.	If you want to give arguments  for  hconsole  itself,  you
       need to add '--' argument after the hconsole arguments and before the arguments going to Hatari.

       If  you	give  a  file  name as hconsole argument, commands in it will be read and executed through Hatari's remote API before you get into
       hconsole interactive shell.

       Hconsole accepts following options:

       --exit Exit after starting Hatari and parsing arguments.

       --help, -h
	      Show command line help.

EXAMPLES

       Start Hatari with all of the given arguments:
	    hconsole.py --monitor mono -d test/

       Start Hatari without extra arguments, execute commands from the given commands.txt file, exit after the file ends:
	    hconsole.py commands.txt --exit --

FILES

       By default hconsole and its examples are installed under the /usr/share/hatari/hconsole/ directory.

SEE ALSO

       hatari(1), hatariui(1)

AUTHOR

       Written by Eero Tamminen <oak at helsinkinet fi>.

LICENSE

       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.

NO WARRANTY

       This  program  is  distributed  in  the	hope  that  it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

Hatari								    2010-10-10							       HCONSOLE(1)