This document provides instructions for running a local Spacebrew server to support prototyping projects that involve interactive hardware and software components. It outlines a 5-step process to install Node.js, download the Spacebrew server software, install node modules, run the Spacebrew server, and connect client applications. It also reviews Spacebrew configuration options and popular frameworks that integrate with Spacebrew.

1. running
your
own
server

3. SUPPORTS DESIGN PROCESS THAT RELIES ON
PROTOT YPING AND LEARNING THROUGH MAKING.
AB L E TO E XPAN D TO H AN DL E G ROWIN G
E C O S YS T E M O F H A R DWA R E A N D S O F T WA R E .
D E S I G N E D F O R P RO J E C T S T H AT I N VO LV E
CHOREOGRAPHING INTERACTIVE COMPONENTS.

4. CLIENT-SERVER MODEL
client
app
client
app
client
app
client
app
APPS C AN FEATURE ONE OR MULTIPLE
PUBLISHERS, AND SUBSCRIBERS.

5. STANDARD DATA T YPES
T RU E O R FA L S E VA LU E S
I N T E G E R VA LU E S B E T W E E N 0 - 10 2 3
TEXT STRINGS

6. SWITCHBOARD FOR ROUTING

7. EXISTING LIBRARIES
JS
WEBSOCKET-BASED AND EASY TO EXTEND

8. LOCAL OR REMOTE SERVER

9. OPEN SOURCE

11. WORKSHOP
RUNNIN G A LOC AL SPACE B RE W SE RV E R

12. 5-STEPS
ONE.
INSTALL NODE.JS
T WO.
D OWN LOAD SPACE B R E W SE RV E R
THREE.
FOUR.
FIVE.
INSTALL NODE MODULES
RUN SPACE B R E W SE RV E R
CONNECT STUFF

13. ONE.
INSTALL NODE.JS
A. DOWNLOAD FROM NODEJS.ORG
B. INS TAL L PAC KAGE

14. T WO.
D OWN LOAD SPACE B R E W SE RV E R
DOWNLOAD ZIP FILE FROM
GITHUB.COM/SPACEBREW/SPACEBREW
OR
CLONE REPO FROM COMMAND LINE
$ git clone https://git hub.com/Spacebrew/spacebrew.git

15. THREE.
INSTALL NODE MODULES
A. OPEN TERMINAL OR OTHER COMMAND LINE APP
B. N AV I GAT E TO S PAC E B R E W F O L D E R
C. IN S TAL L N OD E PAC KAG E D M OD UL E S ( N PM ) D E PE N D E N CIE S
WEBSOCKETS: $
npm
FOREVER-MONITOR: $
install
npm
ws
install
forever-monitor

16. FOUR.
RUN SPACE B R E W SE RV E R
A . L AUN C H S PACE B R E W WIT H T E R M IN AL COM M AN D
$
node
node_server_forever.js
B. FIND YOUR IP ADDRESS
$
ifconfig

17. FIVE.
CONNECT STUFF
Graph:
http://labatrockwell.github.io/
spacebrew-javascript-wildstyleexamples/spacebrew_graph/
index.html?server=YOUR_IP_HERE
Slider:
spacebrew.github.io/spacebrew/
admin/admin.html?
server=YOUR_IP_HERE
Slider:
http://julioterra.github.io/
spacebrew-slider-with-admin/
index.html?server=YOUR_IP_HERE

18. MORE.
SPACE B R E W OPT ION S
--port
(-p):
set
--help
(-h):
print
--log
(-l):
sets
--loglevel:
set
--nopersist:
--persist:
--ping:
--noping:
--close
--timeout
before
on
to
to
to
of
info,
server
(default
9000)
find
level
debug,
persist
persist
warn,
error
functionality
functionality
disconnected
disconnected
clients
--ping
interval
in
close
minimum
closing
info
live
live
force
(-t):
force
off
spacebrew
text
logging
opposite
(-c):
help
clients
--pinginterval:
for
logging
turns
turns
ping
port
ms
between
clients
number
of
that
ms
to
pings
don't
wait
respond
for
to
pings
response
pong

19. MORE.
FRAMEWORKS AND LIBRARIES
JAVA S C R I P T
spacebrew.js
PROCESSING
Spacebrew-P5
library
OPEN FRAMEWORKS
ofxSpacebrew
addon
git hub.com/Spacebrew/spacebrew.js
processing.org
github.com/Spacebrew/spacebrewP5
openframeworks.cc
github.com/Spacebrew/ofxSpacebrew
PYTHON
pyspacebrew
python,org
library
github.com/Spacebrew/pySpacebrew
ARDUINO YUN
arduino.cc

20. KEEP BREWING
JOIN OUR GOOGLE GROUP AND TELL US
ABOUT YOUR PROJECTS
HTTPS://GROUPS.GOOGLE.COM/D/
FORUM/SPACEBREW-CC