)
Contents
Use the Astapor program to remotely open URLs on browser windows.
Slave runs on Raspberry Pis or Apple Mac Minis connected to monitors. The master runs on one Raspberry Pi or Apple Mac Mini. Together, they make a delicious Apple-Raspberry-Pi system.
For more details, please refer to our GitHub wiki.
)
- website and/or HipChat bot
- Sends user input as JSON in a POST request to master.
- master
- Receives JSON from the website or HipChat bot.
- Parses the input and passes JSON to proper slave.
- Compatible with OS X.
- slave
- Receives URL from master and loads URL in a browser.
- Compatible with OS X and Linux operating systems with Google Chrome installed.
Alternatively, the slave can be extended with a proxy to open sites that require user authentication.
- proxy (mitmproxy)
- Receives and forwards all GET requests from slave.
- If request is for a domain that requires authentication, attaches the proper authentication header to the request.
- Sends website content back to slave.
)
If you are not familiar with Go and run into trouble with the following instructions, please visit "How to Write Go Code" for more details. In particular, pay attention to the GOPATH environment variable.
You will need Go installed to run and/or compile the source code. Clone this repository to the machine that will run the master.
To run the code from the cloned repository directory,
dashboard-controller$ go run src/master/master.go
Again, you will need Go installed to run and/or compile the source code. We recommend that you compile the slave.go file to produce a binary file executable on one slave machine, then copy the slave binary file to all your slaves. A slave does not need Go installed to run the binary file, so you can save yourself the Go installation time for each slave. (We used Raspberry Pis as slaves, and each Go installation took 70-100 minutes.)
From the repository directory, compile slave code with the command,
dashboard-controller$ go install slave
Then run the executable with a speficied slave name and master IP address.
dashboard-controller$ $GOPATH/bin/slave -slaveName="Main Lobby" -masterIP=10.0.0.195
The slave will begin listening on its default port number: 8080. The master's default port number is 5000. Optionally, you can specify a port number for the slave and/or master with the -port and -masterPort flags, respectively.
dashboard-controller$ $GOPATH/bin/slave -slaveName="Main Lobby" -port=9999 -masterIP=10.0.0.195 -masterPort=9090
The slave will automatically map itself to the master and periodically emit heartbeats to the master. If the slave's heartbeats do not reach the master for some period of the time, the master will mark the slave as dead and remove it from the map of available slaves.
Access the website running on your localhost. Fill in the text fields, submit, and see your URL post on the indicated slave. :)
Enjoy!