summaryrefslogtreecommitdiff
path: root/README
blob: 5ec1804c14076cfab841dae1f6cd1991278e8d27 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
Spice Javascript client

Instructions and status as of March, 2015.

Requirements:

  1.  Modern Firefox or Chrome (IE will work, but badly)
      
  2.  A WebSocket proxy

      I've used websockify:
        https://github.com/kanaka/websockify
      works great.

  3.  A spice server

      At this point, I've tested with qemu hosting
      a Fedora image, a Vista image, and with Xspice.  
      Vista was pretty bad; I recommend either Linux or Xspice.

Optional:
  1.  A web server

      With firefox, you can just open file:///your-path-to-spice.html-here

      With Chrome, you have to set a secret config flag to do that, or 
      serve the files from a web server.


Steps:

  1.  Start the spice server

  2.  Start websockify; my command line looks like this:
        ./websockify 5959 localhost:5900

  3.  Fire up spice.html, set host + port + password, and click start


Status:

  The TODO file should be a fairly comprehensive list of tasks
  required to make this client more fully functional.