Cordova based Stingray (IMSI-Catcher) detection
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.meteor Change location provider. Bump Meteor. Jul 2, 2016
client Remove debug logs. Display simulated threat on screen Jun 5, 2016
cordova-build-override/platforms/android Move Twitter config out of StingWatch and into stinraymappingproject.org Jun 6, 2016
cordova
imports
public changed the backgroud source, added 2 pictures May 12, 2016
server
.gitignore
README.md README Jun 4, 2016
mobile-config.js DeviceId on cordova and browser Jun 9, 2016
package.json Wait until map div rendered before mapbox init May 8, 2016
settings-example.json update with readme May 9, 2016
stingwatch

README.md

About StingWatch

StingWatch is an Android app built with Meteor (using React + Cordova) to catch IMSI-catchers (aka Stingrays or cell site simulators). These are electronic devices for mass surveillance used by many local police departments and other groups around the world. Learn more.

In a nutshell, StingWatch:

  • is based on modular components that in the long run should make the code reusable across many types of devices (PCs, iPhones, IoT, RaspberryPi, etc.)
  • will contribute and pull from a shared database for advanced detections
  • is more limited functionality and reliability than other well established apps like SnoopSnitch and AIMSICD
  • does not require rooting

imsi-catcher-catcher

The main package that StingWatch relies on is imsi-catcher-catcher. imsi-catcher-catcher is also being incorporated into another project at the same time, StingWatch Desktop, a version of StingWatch that can run on anything that supports gnuradio and Meteor, like an Intel Compute Stick.

Get StingWatch

APKs

  • Google Play (in beta testing)
  • FDroid coming soon
  • Direct APK link coming soon

Install from source

Make sure the following are installed:

Get the code and plugins

Both these methods are assuming an installation into ~/.stingwatch.

Option 1: Script

curl https://stingraymappingproject.org/install.sh | sh

Option 2: Manual

These instructions are copied from the install script above:

# Get StingWatch
git clone git@github.com:marvinmarnold/stingwatch.git
cd stingwatch

# Install NPM packages
sudo meteor npm install --save react react-addons-pure-render-mixin react-dom react-hammerjs react-router twitter

# Setup location for packages
mkdir packages
cd packages

# Link to Bootstrap
git clone git@github.com:marvinmarnold/bootstrap.git
cd bootstrap
git checkout stingwatch
cd ..

git clone git@github.com:marvinmarnold/cordova-plugin-telephony.git
git clone git@github.com:marvinmarnold/meteor-device-id.git
git clone git@github.com:marvinmarnold/meteor-imsi-catcher-catcher.git
git clone git@github.com:marvinmarnold/meteor-reactive-local-store.git
cd ..

# Copy over settings
cp settings-example.json settings.json

chmod +x stingwatch.sh

Configure settings

Register with Mapbox and Twitter. Fill in settings.json with keys.

Use StingWatch

Make sure your Android device is plugged in and that adb devices shows it.

Local server

The fastest way to get started it to make your computer the server the app talks to.

cd ~/.stingwatch
./stingwatch

The server will start the server on localhost:4000 and is equivalent to running meteor run android-device -p 4000 --settings settings.json .