Official Sensorkraken documentation.

Sensor documentation on sensor-settings

Quick Start

Version 1.0

Sensorkraken is a data recording application with a broad set of configurable sensor options. It is mainly meant as data recording mechanism for building ground truth in privacy leak related research.

Sensorkraken is free software and published under the GNU GPLv3.

Install

Currently you can only install Sensorkraken from an exisiting .apk. If downloaded, navigate to the download folder and simply click on install. You may need to grant permissions to the folders application used to install from.

Usage

Sensorkraken consists of a basic bottom navigation menu.

Home

Recordings and probings can be started from here. Before starting a recording you have to enable sensors via the sensor settings menu, or import an exisiting config file via the saved settings menu.

Probing sensors does not need any settings, it will acquire every sensor once and retrieve extra information from the source.

Depending on the used settings and sensors, the application may require permissions. You will be informed which permissions are missing after clicking either probe sensors or start recording. You will be prompted to grant them, by denying the start of recording/probing.

Settings

General settings like the file format (currently not supported) and sensor settings can be changed here.

Sensor settings

Every sensors has the following settings:

Name	Function	Values	Default
Activate	Toggles whether to use this sensor in the recording.	Yes, No	No
Interval	Sets the recording interval for this sensor.	Integer in milliseconds. -1 for default interval. -2 for removing the wait lock.	-1
Searchduration	Sets the duration to wait for an event.	Integer in milliseconds. Negative values will remove the wait lock.	0
Sample Rate	Android sensor configuration of sample rate.	Integer in microseconds as defined by Android.	0
Max Latency	Analogues to Sample rate.		0
Information Level	Level of information retrieved from sensors.	all, normal, custom (currently not supported)	normal
Add Additional Source	Prompts for path to use as additional source.	Path to file as string	none
Additional sources	If enabled, uses additional sources.	Yes, No	No
Use Own File	If enabled, uses an own file for the sensors.	Yes, No	Yes
Continuous mode	If enabled, uses continuous mode.	Yes, No	No

General Settings

Saved Settings

Import/Export saved settings.

View Data

Access to saved recordings and live view of data.

View Live Data

List of available sensors. Clicking a sensor title will drop down sensor information and current sensor values.

View Saved Data

List of saved data. Contains probings and recordings. Short click drops down information of the recording. Long click enables sharing menu.

Export data

Recordings are saved in a JSON format. When sharing recordings via the saved data menu, all files of that recording will be zip compressed. Sensor data differs a lot. Here are some hints on how to read from the json files.