Sensorama for iOS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Sensorama
assets
scripts
.gitignore
.travis.yml
DESIGN.md
Gemfile
Gemfile.lock
Jenkinsfile
LICENSE.md
PRIVACY.md
README.md
TERMS.md
YOUTUBE.md
build.sh

README.md

Sensorama for iOS

Build Status

This is an iOS version of the [http://www.sensorama.org](Sensorama project).

Sensorama

If you want to Donate, link: https://www.paypal.me/wkoszek

Sensorama is a data science platform. As of now (Nov, 2016) it captures the data from your phone sensors after you press "Record". Sensorama samples iPhone sensors at a given frequency and stores them on your phone, in the internal database. After you press Stop, the recorded sample is stored in a compressed JSON file and e-mailed to you. Sensorama developers (aka.: me) get the copy of this file too, for research/calibration/testing/development purposes.

How to use

I suggest you start using it from the App version available on the App Store. Then move to using it in the developer environment.

App has 3 screens:

  1. Record
  2. Files
  3. Settings

Sensorama images

You start in Record. You can tap recording ("circle") and the app will start collecting data from all sensors on your phone. You can then tap Stop ("square"). Tap on "Files" tab. Recorded file will be on top of "Files" tab. You can click it to see general file specs. You also have a way to remove the file from there. In the "Settings" tab you have an ability to see what is being recorded and modify things like sampling rate and cloud storage options.

How to build

To build this application you must have a Apple Mac computer with XCode 7 and Command Line extensions installed. You will have to have Ruby installed, and have an access to gem and bundle commands. To build the application, run:

./build.sh normal

to build using xcodebuild (most of the users will want that). To run a suite of regression tests, run:

./build.sh test_normal

Sensorama uses Fastlane tools for build and release process and this is what we use to deploy Sensorama for production. If you're setup with the fastlane you can do:

./build.sh fastlane

and for tests, you can do:

./build.sh test_fastlane

Usability tests

I've made some usability tests with paper prototypes for Sensorama. See them on my YouTube channel:

https://www.youtube.com/playlist?list=PLYIpNoYQkEXBjQ2BhXewddPoLsJIZ5maC

Help wanted

Projects/tickets are present in the Issues/Projects database on GitHub:

If you want to help out, I have some projects for you. I'd offer a bit of my time if you offer to contribute. Some of them:

  • do a code review
  • do a security audit
  • improve onboarding (use EAIntro extension)
  • move us to Carthage
  • improve tests for Sensorama
  • move us to ZIP compression
  • make a backend for Sensorama

Contact me before in case you want to work on something.

Known issues

Sensor switches are untested. The "logout" screen has "with subtitle" in it (should have e-mail).

Tools

Jetbrains offered me an Open Source License for the whole suite of their products, and it's great. Their website: https://www.jetbrains.com/

Author