NAME
    App::screenorama - Application output to websocket stream

VERSION
    0.05

DESCRIPTION
    This program allow you to pipe STDOUT and STDERR from a program over a
    websocket.

  Protocol
    The data transmitted over the websocket connection is JSON in each
    frame:

    *   Startup

          {"program":$str,"program_args":...}

        Same as "program" and "program_args".

    *   Output

          {"output":$str}

        Comes after each time the program emit data. NOTE: There's no
        guaranty that it will be emitted on newline.

    *   Exit

          {"exit_value":$int,"signal":$int}

        The exit value of the application. The websocket will be closed
        after you see this.

    *   Error

          {"error":$str}

        If something goes wrong with the application or other operating
        system errors.

SYNOPSIS
  Server
      # let others connect to the running program
      $ screenorama --listen http://*:5000 --single -- 'while sleep 1; do echo "hey!"; done'

      # pipe the output on incoming request
      $ screenorama -- ls -l

  Client
    Connect a browser to <http://localhost:5000> or <ws://localhost:5000> to
    see the output.

AUTHOR
    Jan Henning Thorsen - "jhthorsen@cpan.org"