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.


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.


Sensorkraken consists of a basic bottom navigation menu.


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.


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

| Name | Function | Values | Default —|—|—|— Default Interval | Sets the default interval. | Integer in milliseconds. | 10000 File Format (currently not supported) | Sets the file format. | JSON

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.

| Sensor | Available tags | Values —|—|—