NAME

       emrun - emscripten tool to compile as an HTML page

DESCRIPTION

       usage: emrun [emrun_options] filename.html -- [html_cmdline_options]

              where  emrun_options  specifies  command  line  options  for  emrun itself, whereas
              html_cmdline_options specifies startup arguments to the program.

       If you are seeing "unrecognized arguments" when trying to pass  arguments  to  your  page,
       remember to add `--` between arguments to emrun itself and arguments to your page.

   positional arguments:
              serve cmdlineparams

   options:
       -h, --help
              show this help message and exit

       --kill_start
              If  true,  any previously running instances of the target browser are killed before
              starting.

       --kill_exit
              If true, the spawned browser process is forcibly killed when it calls exit(). Note:
              Using    this    option    may    require    explicitly    passing    the    option
              --browser=/path/to/browser, to avoid emrun being detached from the browser  process
              it spawns.

       --no_server
              If specified, a HTTP web server is not launched to host the page to run.

       --no_browser
              If specified, emrun will not launch a web browser to run the page.

       --no_emrun_detect
              If  specified,  skips  printing the warning message if html page is detected to not
              have been built with --emrun linker flag.

       --serve_after_close
              If true, serves the web page even after the application quits by user  closing  the
              web page.

       --serve_after_exit
              If true, serves the web page even after the application quits by a call to exit().

       --serve_root SERVE_ROOT
              If set, specifies the root path that the emrun web server serves. If not specified,
              the directory where the target .html page lives in is served.

       --verbose
              Enable verbose logging from emrun internal operation.

       --hostname HOSTNAME
              Specifies the hostname the server runs in.

       --port PORT
              Specifies the port the server runs in.

       --log_stdout LOG_STDOUT
              Specifies a log filename where the browser process stdout data will be appended to.

       --log_stderr LOG_STDERR
              Specifies a log filename where the browser process stderr data will be appended to.

       --silence_timeout SILENCE_TIMEOUT
              If no activity is received in this many seconds, the browser process is assumed  to
              be  hung,  and the web server is shut down and the target browser killed.  Disabled
              by default.

       --timeout TIMEOUT
              If the browser process does not quit or the page exit() in this many  seconds,  the
              browser  is  assumed  to  be  hung,  and the web server is shut down and the target
              browser killed. Disabled by default.

       --timeout_returncode TIMEOUT_RETURNCODE
              Sets the exit code that emrun reports back to  caller  in  the  case  that  a  page
              timeout occurs. Default: 99999.

       --list_browsers
              Prints  out  all  detected  browser  that  emrun  is able to use with the --browser
              command and exits.

       --browser BROWSER
              Specifies the browser executable to run the web page in.

       --browser_args BROWSER_ARGS
              Specifies the arguments to the browser executable.

       --android
              Launches the page in a browser of an Android device connected  to  an  USB  on  the
              local system. (via adb)

       --system_info
              Prints information about the current system at startup.

       --browser_info
              Prints information about the target browser to launch at startup.

       --json If specified, --system_info and --browser_info are outputted in JSON format.

       --safe_firefox_profile
              If  true, the browser is launched into a new clean Firefox profile that is suitable
              for unattended automated runs. (If target browser !=  Firefox,  this  parameter  is
              ignored)

       --log_html
              If set, information lines are printed out an HTMLfriendly format.

       --private_browsing
              If specified, opens browser in private/incognito mode.

       --dump_out_directory DUMP_OUT_DIRECTORY
              If specified, overrides the directory for dump files using emrun_file_dump method.