Citizen Synergy Android App

 1. Introduction
      1.1. Projects
      1.2. Functions
 2. Installation
      2.1. Checksums
      2.2. Permissions
 3. Usage
      3.1. Main Page
      3.2. History Page

Updated site:

1. Introduction

Until mobile web apps have the same power and access as mobile native apps, we will need native apps (running on the OS directly) to help our web apps (running inside web browsers).

This Citizen Synergy Android App is native app designed to be used by different web apps so that they can run commands and access data not available inside web browser to the web apps.

Source Code




1.1. Projects

This app is currently used by the following projects:


1.2. Functions

  1. It collects data (including GNSS, Wifi, Bluetooth etc.)
  2. It can store collected data on the Phone
  3. It can send collected data to Private Server and optionally to Public Server

2. Installation

  1. Goto using any browser on your Android phone.
  2. The citizensynergy.apk file will be downloaded into the Download directory on your phone.
  3. Click on the file in your file manager to install.

2.1. Checksums

Confirm the checksums of the download .apk file with the checksums for that release published at

Most Android file managers will tell you md5, sha1 or sha256 checksums of a file (if you look under the properties of a file). You only need to compare one of those to make sure it is the same as the corresponding published checksum.

2.2. Permissions

Depending on the android phone you have and the version fo android running on it.
You will be asked to give the Citizen Synergy app the following permissions:

  1. Access device location - While using this app
  2. Acees photos and media - Allow

3. Usage

The Citizen Synergy Android App is a simple 2 page app and is usable immediately once install.

3.1. Main Page

The Citizen Synergy Android App has already been pre-configured with sensible defaults.

You just need to press one button to turn ON the service after installation and the default values will enable private logging of data onto your phone ONLY.

The Main Page is their to allow you to to customise its operation for your individual requirement.

  1. Click on History to see what the app is has been doing in real-time.
  2. Service Status indicates whether the logging service is currently running.
  3. On Off Button to control the running of the data logging service.
  4. Public Server address to send data to if "Send To Server" is turned on.
  5. Private Server address to send data to if "Send To Server" is turned on.
  6. Location accurcay should be set to high to use satellite signals but can be lowered to reduce battery drain.
  7. Frequency of logging should be every 300 seconds or less in offensive mode and 1800 seconds or more in defensive mode.
  8. Distance between logs should be 50 metres or less in offensive mode and 100 metres or more in defensive mode.
  9. Angle can be set to 0 if fine grain plotting of your track around corners is no needed.
  10. Offline Buffering should be on to allow logging of data even if you do not have internet conneection.
  11. Wake Lock allows the app to stay wake to log data so should be on in most cases.
  12. Log Bluetooth should be on during offensive mode to detect bluetooh devices and other COVID apps near you.
  13. Log Wifi should be on during offensive mode to better locae you position indoors.
  14. Save On Phone should be on all the time so you have a record of the environment you are in and you have been through.
  15. Send To Server if you want the data you have collected to be sent to the Fiduciary Exchange in real-time (you to create a Guest Alias in Personal Map first).
  16. Fuzzy Block can be turned on if "Send To Server" is turn on, so all data sent to the server will be fuzzified into a bigger time and distance block.
  17. Geeks Only should be turned on ONLY if you know what it means - you will be helping to process other people's data.
  18. Version number of the software you are using, since it does not check version for privacy reasons you need to check yourself.

Everything is about trading off battery consumption and data capture volume, during an outbreak bring a power bank so you can gather as much data as frequently as possible.

3.2. History Page

From the History page you can see the type of information being logged on your phone.

On some phones, even if you have turned Bluetooth logging on, Bluetooth signals are NOT logged when the screen is off (e.g. like in your pocket). You can see Bluetooth is missing in some entries in the image below.

Citizen Synergy Android App has a special NO SCREEN OFF feature. If you keep the app displayed on your screen, then your phone's automatic screen off will be disabled - allowing Bluetooth signal collection to continue on those troublesome phones that switches Bluetooth scans off when screen is off. Note this is OPTIONAL you should have enough data for contact tracing from continuous collection of other radio signals e.g. GNSS, WiFi and Cell Tower - which occur even when the screen is off.

Note when your movement is less than the distance threshold (default 50 metres) the app will still log once in a while (default frequency is 5 minutes) to collect any new signals (as can be seen above).