Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
May 13, 2020 15:36
July 16, 2016 05:01
November 10, 2016 15:57
February 8, 2017 08:20
October 3, 2017 14:47
April 16, 2016 11:28
September 11, 2016 07:42
December 21, 2017 09:24
April 22, 2016 19:01
October 3, 2017 14:47
October 3, 2017 14:47
December 7, 2016 09:20
October 3, 2017 14:47
April 16, 2016 10:58
May 5, 2018 14:09
February 21, 2017 08:53
February 25, 2017 10:14
May 1, 2016 19:14
December 11, 2016 19:44
January 31, 2017 14:02
February 25, 2017 10:14
December 2, 2016 10:48
January 31, 2017 14:02
August 10, 2017 16:29
January 9, 2017 09:28
August 10, 2017 16:29
July 21, 2016 13:32
December 2, 2016 14:18


Version 2.4 Github All Releases FIND documentation Coverage Donate Say Thanks

Keywords: indoor GPS, WiFi positioning, indoor mapping, indoor navigation, indoor positioning

There is a new version, FIND3. It has numerous improvements over this version.


The Framework for Internal Navigation and Discovery (FIND) allows you to use your (Android) smartphone or WiFi-enabled computer (laptop or Raspberry Pi or etc.) to determine your position within your home or office. You can easily use this system in place of motion sensors as its resolution will allow your phone to distinguish whether you are in the living room, the kitchen or the bedroom, etc. The position information can then be used in a variety of ways including home automation, way-finding, or tracking!

Simply put, FIND will allow you to replace tons of motion sensors with a single smartphone!

The system is built on two main components - a server and a fingerprinting device. The fingerprinting device (computer program or android app) sends the specified data to the machine learning server which stores the fingerprints and analyzes them. It then returns the result to the device and stores the result on the server for accessing via a web browser or triggering via hooks.

FAQ (abbreviated):

More questions? See the unabbreviated FAQ.


If you'd like to install things yourself, see the documentation. You don't need to do this to try it though. Follow the 3 steps below to get started quickly.

1. Download the software

Android users: download the current version of the app. Sorry iPhone users but the Apple store prevents apps that access WiFi information, so I will be unable to release a iPhone version.


Computer users: you can download the current version of the fingerprinting program, available for Rasbperry Pi, OSX, Linux, and Windows.

2. Gather fingerprint data

First, to get started using FIND you will need to gather fingerprint data in your locations.

Android users: When you start up the app you will be asked for a username (enter whatever you want) and you'll be assigned a unique group name. Simply click "Learn" and you'll be prompted for a location name. After you enter a location, the app will connect to the server and then submit fingerprints.

Computer users: To start learning locations simply use ./fingerprint -e.

3. Track yourself

Once you've collected data in a few locations, you can track yourself.

Android users: Just press the "Track" button when you're ready to track.

Computer users: Type in ./fingerprint to start tracking yourself.

More information

See the documentation at


Funding from Duke University Colab

Thanks to tscholl2, sjsafranek, and jschools for their help in guiding the development of FIND and creating the early versions of FIND with me! Thanks to Rishabh Rajgarhia and CanvasJS for help implementing a nice graph. Thanks arafsheikh for adding interface selection, Pugio and ScottSWu for adding OS X/Windows support for the fingerprint program, including a better Windows scanning utility! Thanks Thom-x for the Dockerfile. Thanks certifiedloud for implementing the change to DELETE requests and implementing sockets for unix. Thanks bebus77 for making a awesome generic struct for OS support on the fingerprinting program! Thanks christoph-wagner for help with polling interval on app. Thanks to patorjk and asciiworld for the ASCII art. Thanks to Imgur for hosting images.


Like this? Help me keep it alive by donating $5 to pay for server costs.