Installation

Windows

Procedure courtesy of @fuininthefalls (Anthony Bolgar)

On Windows 7 and above, please use the following instructions. We are assuming from a vanilla Windows installation so your mileage may vary depending on things you already have installed. If you find conflicts, please let us know via a GitHub Issue

Prerequisites:

1. Download and install Node.js version node-v0.12.7 from https://nodejs.org/download/release/v0.12.7/
2. Install Google Chrome if not already installed
3. Download and install Git For Windows from https://git-scm.com/download/win

LaserWeb install instructions:

1.  Start a windows command prompt by typing "cmd" in windows search (do not type the quotes)
2   Type "git clone https://github.com/openhardwarecoza/LaserWeb.git" (do not type the quotes)
3.  Type "cd LaserWeb" (do not type the quotes)
4.  Type "npm install" (do not type the quotes)

The software is now installed.

To start the software:

1.	Start a windows command prompt by typing "cmd" in windows search (do not type the quotes) 
2.	In the command prompt window type "cd\laserweb" at the command prompt (do not type the quotes)
3.	In the command prompt window type "node server" at the command prompt (do not type the quotes)
4.	Start the google Chrome web browser (software is only tested to work with Chrome)
5.	At the top of the Chrome window type "localhost:8000" in the web address bar (do not type the quotes)

You should now see the software in the Chrome browser window.

Vagrant

For a clean testing environment use Vagrant. For details on "public_network" see VagrantDocs.

1. Open a terminal

$ mkdir LaserWeb
$ cd LaserWeb
$ vagrant init
$ vagrant box add ubuntu/trusty64

2. Edit: Vagrantfile

config.vm.box = "hashicorp/precise32"
config.vm.network "public_network"

3. In the terminal

$ vagrant up
$ vagrant ssh
$ sudo apt-get install nodejs nodejs-legacy npm build-essential git
$ git clone https://github.com/openhardwarecoza/LaserWeb.git
$ cd LaserWeb
$ npm install

4. Find public IP

$ ifconfig eth1 is your "public_address"

5. Start LaserWeb! (Use public_address:8000 on your local machine)

$ nodejs server.js

Ubuntu

Procedure courtesy of @quillford : https://github.com/openhardwarecoza/LaserWeb/pull/10

1. Open a terminal
2. Enter the following command sudo apt-get install nodejs nodejs-legacy npm build-essential git
3. Go to the directory you would like to install LaserWeb in by entering cd Desktop for example
4. Enter git clone https://github.com/openhardwarecoza/LaserWeb.git then cd LaserWeb
5. Next install the npm modules by entering the followingnpm install
6. Finally enter nodejs server.js

Ubuntu MJPG_Streamer Install

1. Open a terminal
2. Enter the following command sudo apt-get install build-essential libjpeg-dev imagemagick subversion libv4l-dev checkinstall
3. Enter svn co svn://svn.code.sf.net/p/mjpg-streamer/code/ mjpg-streamer
4. Enter cd mjpg-streamer/mjpg-streamer ; make
5. Enter sudo make install
6. Run MJPG_Streamer with a USB Webcam: mjpg_streamer -i "/usr/local/lib/input_uvc.so -d /dev/video0 -y -r 320x240 -f 15" -o "/usr/local/lib/output_http.so -w /usr/local/www"

Raspberry Pi 2 (Jessie)

Procedure courtery of @LordFennec : https://github.com/openhardwarecoza/LaserWeb/pull/3

1. Open a terminal
2. Enter the following command sudo apt-get install build-essential python g++ make
3. Install node.js for the Raspberry Pi using this script: https://github.com/midnightcodr/rpi_node_install
4. Go to the directory you would like to install LaserWeb in by entering cd Desktop for example
5. Enter git clone https://github.com/openhardwarecoza/LaserWeb.git then cd LaserWeb
6. Next install the npm modules by entering the following npm install
7. Finally enter nodejs server.js

Mac OS X

Procedure courtery of @quillford : https://github.com/openhardwarecoza/LaserWeb/pull/10

1. Download and install nodejs version node-v0.12.7 (NOTE: At the time of writing SerialPort is not supported on Node,js 4.0+) from https://nodejs.org/download/release/v0.12.7/ Note2: Compiling SerialPort sometimes fails. Read the auhors blog post about why its hard to manage over at http://www.voodootikigod.com/on-maintaining-a-native-node-module/
2. cd to a directory to put LaserWeb in
3. Open a terminal and enter git clone https://github.com/openhardwarecoza/LaserWeb.git
4. Enter cd LaserWeb in the terminal window
5. Enter npm install
6. Now you can start it with node server.js

Config

edit config.js to change serial baud rate and web port edit /i/gcode-viewer/ui.js to change size of your laser's bed

Running

// standalone

node server.js

// with forever

npm install -g forever
forever start server.js

Access Instructions

After a successful start, the terminal / command promt should display something like this:

Once you see that, open a web Browser and go to the URL as shown in the terminal (usually 127.0.0.1:8000, or the IP address of the device running Laserweb for example http://192.168.0.150:8000 - you can also access this IP from any device on the network)

The default port 8000, you can change it by editing config.js.

Access: http://hostaddress:8000/

Timelapse

There is a bash script names rrw_timelapse.sh in this repository which you can run on a Linux or BSD machine to generate a timelapse from the built in RRW Webcam server.