README.md 1.9 KB
Newer Older
tmarrinan's avatar
tmarrinan committed
1 2 3 4
WebSAGE
=======

Browser based implementation of SAGE. A cluster-based html viewer used for displaying elements across multiple browser windows.
tmarrinan's avatar
tmarrinan committed
5

tmarrinan's avatar
tmarrinan committed
6
### Requirements ###
tmarrinan's avatar
tmarrinan committed
7 8
* ffmpeg
* poppler
tmarrinan's avatar
tmarrinan committed
9
* graphicsmagick
Luc Remambot's avatar
Luc Remambot committed
10
* openmp-devel (linux)
Victor Mateevitsi's avatar
Victor Mateevitsi committed
11
* nodejs-devel (linux)
tmarrinan's avatar
tmarrinan committed
12

tmarrinan's avatar
tmarrinan committed
13
##### For Windows: #####
tmarrinan's avatar
tmarrinan committed
14

tmarrinan's avatar
tmarrinan committed
15
* Download and install [Node.js](http://nodejs.org/)
tmarrinan's avatar
tmarrinan committed
16
* Download and install [7-Zip](http://www.7-zip.org/)
Victor Mateevitsi's avatar
Victor Mateevitsi committed
17
* Download and install [Awesomium](http://www.awesomium.com)
tmarrinan's avatar
tmarrinan committed
18 19
* Download [FFMpeg](http://ffmpeg.zeranoe.com/builds/)
* Download [Poppler-utils](http://manifestwebdesign.com/2013/01/09/xpdf-and-poppler-utils-on-windows/)
tmarrinan's avatar
tmarrinan committed
20
* Download [GraphicsMagick (Q8)](ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/windows/)
tmarrinan's avatar
tmarrinan committed
21 22 23 24 25 26 27 28 29 30 31

Install FFMpeg
* Move the FFMpeg 7-zip file to "C:\"
* Right-click, go to 7-Zip > Extract Here
* Rename extracted folder to "FFMpeg"

Install Poppler
* Create Folder "C:\Poppler"
* Move the Poppler-utils zip file to "C:\Poppler"
* Right-click, go to 7-Zip > Extract Here

tmarrinan's avatar
tmarrinan committed
32 33 34 35
Install GraphicsMagick
* Create Folder "C:\GraphicsMacgick"
* Move the GraphicsMagick Q8 executable to "C:\GraphicsMacgick"

tmarrinan's avatar
tmarrinan committed
36
Set Environment
tmarrinan's avatar
tmarrinan committed
37
* Add "C:\FFMpeg", "C:\Poppler" and "C:\GraphicsMacgick" to you PATH variable
tmarrinan's avatar
tmarrinan committed
38

tmarrinan's avatar
tmarrinan committed
39 40 41 42 43 44
###### Setup Node js: ######
Open 'keys/GO-windows.bat'
Add lines with list of hostnames for your server
```
cd <WebSAGE_directory>
npm install
tmarrinan's avatar
tmarrinan committed
45
cd keys\
tmarrinan's avatar
tmarrinan committed
46 47
.\GO-windows.bat
```
tmarrinan's avatar
tmarrinan committed
48

tmarrinan's avatar
tmarrinan committed
49
##### For Mac OSX: #####
tmarrinan's avatar
tmarrinan committed
50

tmarrinan's avatar
tmarrinan committed
51 52
* Download and install [Node.js](http://nodejs.org/)
* Download and install [homebrew](http://brew.sh/)
Victor Mateevitsi's avatar
Victor Mateevitsi committed
53
* Download and install [Awesomium](http://www.awesomium.com)
tmarrinan's avatar
tmarrinan committed
54 55
```
brew install ffmpeg 
tmarrinan's avatar
tmarrinan committed
56 57
brew install poppler --without-glib
brew install graphicsmagick
Victor Mateevitsi's avatar
Victor Mateevitsi committed
58
brew install libjpeg-turbo
Luc Remambot's avatar
Luc Remambot committed
59
brew install openmp
tmarrinan's avatar
tmarrinan committed
60 61
```

tmarrinan's avatar
tmarrinan committed
62 63
###### Setup Node js: ######
Open 'keys/GO-mac'
tmarrinan's avatar
tmarrinan committed
64
Edit ```servers``` to be a list of hostnames for your server
tmarrinan's avatar
tmarrinan committed
65
```
tmarrinan's avatar
tmarrinan committed
66
cd <WebSAGE_directory>
tmarrinan's avatar
tmarrinan committed
67
npm install
tmarrinan's avatar
tmarrinan committed
68
cd keys/
tmarrinan's avatar
tmarrinan committed
69
./GO-mac
tmarrinan's avatar
tmarrinan committed
70
```
tmarrinan's avatar
tmarrinan committed
71 72 73 74 75 76 77 78 79

=======

##### Run WebSAGE: #####
```
cd <WebSAGE_directory>
node server.js
```