Marauder’s Map is a fun and interactive way of showing where people are in an area in realtime. When someone enters, a set of footprints appear on the map where they're standing. As they walk around, and go from place to place, the map periodically updates their location. There is no app to install or secret phrase to recite. Anyone with a smartphone or Wi-Fi device can participate in this interactive map.
Non-functioning demo: http://accoleon.github.io/marauders-map/priv/newmap
For an overview of the architecture and the design rationale behind Marauder's Map, take a look at the software architecture.
For a detailed description of what makes Marauder's Map tick, check out the technical documentation.
Adventurous administrators can try installing their own setup with the instructions below.
- Minimum of 3 computers (4 computers recommended)
- Computers must have 802.11 b/g/n network interface (Wi-Fi) cards compatible with Wireshark (recommended wireless cards)
- Computers running updated versions of OS X 10.9+ or Linux Kernel 3.5
- Erlang R16B02
- GNU make 3.5 or above
- GNU wget (required for
erlang.mk) - Git 1.7
- Python 2.7 (not version 3)
- scikit-learn 0.14
- numpy
- pandas
The above software components must all be installed and accessible in the $PATH. Some installation instructions are included below.
Installing Xcode command-line developer tools:
xcode-select --install
Installing Homebrew:
ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"
Add the following line to your ~/.bashrc:
export PATH="$(brew --prefix coreutils)/libexec/gnubin:/usr/local/bin:$PATH"
Installing GNU make:
brew install make
Installing GNU wget:
brew install wget
Installing Python 2.7:
brew install python
and add the following to your ~/.bashrc:
export PATH=/usr/local/share/python:$PATH
Run the following to install pandas and scikit-learn (which should also pull in numpy as a dependency):
pip install scikit-learn pandas
Installing development tools:
sudo aptitude install build-essential
Installing wireshark:
sudo aptitude install wireshark
The Erlang Solutions page has instructions for installing Erlang R16B02 on Ubuntu.
Installing Python and pip:
sudo aptitude install python python-pip
Using pip to install the Python packages:
pip install scikit-learn pandas
git clone git://git.assembla.com/cis422f13_team3.maraudersmap.git
cd cis422f13_team3.maraudersmap
You are now ready to build the project.
To build the Marauder's Map server, run:
make
To start the server node in the foreground:
$./_rel/bin/mm console
To start the server in the background:
$./_rel/bin/mm start
After starting the server in the background, the server will run as a background process. To view the server console, run:
$./_rel/bin/mm attach
On the server, point a browser to http://localhost:8080 to bring up Marauder's Map.
The server node should run fine for testing, but if you want to run the server node and make it accessible from a network, run this:
./startserver.sh
which will build, change the host to the detected IP address reported by
ifconfig, then run the server.
Building and running the capture nodes is done differently from the server node.
In the root of the Marauder's Map project, edit the file mm_capture.src:
{mm-receiver, 'mm@localhost'}.
Change localhost to the IP address or hostname of the server.
Run ifconfig to determine the interface name of your wireless card, then change en0 to whatever ifconfig says is your wireless interface:
{interface, <<"en0">>}.
After changing the settings, run the start script, where nodeA is whichever node you were assigned to run (nodeA, nodeB, or nodeC):
./startnode nodeA
This starts a capture node with all the settings filled in correctly.
Make sure that all capture nodes are on the same wireless channel, and are able to communicate with the server node. Usually the best wireless channel to capture on is the same as the dominant wireless network in the area. Note that if you are unable to join this network and use it to connect the nodes, a short-range option is to create an ad-hoc network with the same channel.
Be sure to have wget, Erlang, GNU make installed and available in your $PATH.
Be sure to have a compatible wireless interface card that supports libpcap capturing in monitor mode. Read the short guide for compatible wireless cards.
Be sure that your server and all your capture nodes are on the same local area
network and subnet, and can ping each other. Check your firewall, and open port
4369 for the Erlang Port Mapper Daemon (epmd) to communicate.
To troubleshoot connection problems, enter nodes(). in the server's Erlang console to see the list of connected nodes.
Be sure that your firewall has not blocked port 8080, and that the server is
running without errors.
Marauder's Map uses SVG and WebSocket, and requires a modern browser. It has been tested to work with Chrome v31 and Safari 7.0.