Android App Which Shows Details about CWA Exposures (Requires Root)
© 2020 Michael Huebler and other contributors. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
There are 3 options:
- Download from https://play.google.com/store/apps/details?id=org.tosl.warnappcompanion
- Write a short review
- Download the latest released APK from the Assets at https://github.com/mh-/corona-warn-companion-android/releases
- Install via
adbtool and USB cable:adb install corona-warn-companion-github-release.apk
git clone https://github.com/mh-/corona-warn-companion-android.git- In Android Studio, select a 'flavor':
githubis the normal version, called "Corona-Warn-Companion".playstoreis a version that was renamed to "Warn-App-Companion" because of the Play Store requirements for COVID-19 apps; this is not a category 1 or 2 app and must therefore not use COVID-19 related terms in its Play Store listing. - Build the
debugbuild variant, and install it on your device. Thereleasebuild variant will probably build out-of-the box only on macOS because of the way how the keystore for app signing is accessed.
After a lot of user feedback and many iterations, the app meanwhile has several modes. The best user experience is available if the device is rooted and the app gets root permissions: With root permissions, the app can directly access the database from a framework where the recorded Rolling Proximity IDs (RPIs) are stored.
However, since many users cannot or do not wish to root their device, two other options (RaMBLE and CCTG) are also available, where another app can export their recorded RPIs, so that this app can read them without root rights, and work with them.
The currently available modes are:
This app reads RPIs from the Google Exposure Notifications service / framework. Works together with the official Corona-Warn-App.
This app reads RPIs from the microG ENF framework. Works if you have installed microG and an app that activates microG ENF RPI recording, and give root access to this app.
This app reads RPIs from the Corona Contact Tracing Germany app (which brings its own microG framework that stores the RPIs in its own location). Works if you have installed CCTG, and give root access to this app.
You need to record with the RaMBLE app (to record, tap the "▶" button), and then on the next day, export the database (tap the "⋮" button in the top right corner, select "Export Database"). Then set this app to RaMBLE Mode (tap the "⋮" menu button in the top right corner, select "RaMBLE Mode"). This app will then read from the "Downloads" directory, where RaMBLE has stored its exported database.
Note that the next time you want to use this app, you need to follow the same steps again (export from RaMBLE).
This requires the installation of the Corona Contact Tracing Germany app. On the next day, export the tracing information from CCTG and share with this app as described in the CCTG FAQ. If you tap "export" on the microG ENF screen, and select to share with this app (tap on the Friendly Dog icon), this app is called and automatically reads the data, and also automatically selects "microG mode" in the process.
Note that the next time you want to use this app, you need to follow the same steps again (export and share from CCTG / microG ENF).
(BTW, if you wonder why this explanation is not part of the Play Store text: This is because of the Play Store requirements for COVID-19 apps; this is not a category 1 or 2 app and must therefore not use COVID-19 related terms in its Play Store listing.)
This app helps you to better understand warnings of the official Corona-Warn-App (or its CCTG fork).
ATTENTION: To access the same recorded encounters as the official Corona-Warn-App, this app requires ROOT permissions. Without root permissions, the app can only be used together with the RaMBLE app, or with the CCTG app / microG. Please read the "How to use the app" section above.
- The app reads the Rolling Proximity IDs recorded by your device from the Exposure Notifications database
(this is only possible with root permissions, which is why official Exposure Notifications apps, such as Corona-Warn-App,
cannot display these details).
Alternatively, without root permissions, the app can also read a database exported from the RaMBLE - Bluetooth LE Mapper app, or from the CCTG Corona Contact Tracing Germany app / microG. - The app downloads the Diagnosis Keys from the official German Corona-Warn-Server and other countries' servers, as selected by you.
For Germany, it downloads the keys published daily for the last few days, and the keys published every hour for today.
Only keys for the days found in step 1 are shown and counted.
- The app compares both in order to find matches (risk encounters).
If risk encounters are found, it shows the details: At which times and with which radio attenuation (roughly corresponds to the distance) did the encounters take place, and what level of transmission risk did the encounters have. For encounters that were recorded by RaMBLE, it can also display the location.
Note that 1 means a low and 8 means a high transmission risk.
- The app does not process any personal data.
- The app only accesses the internet for the purpose 2 (see above), i.e. it only downloads data from the official warning servers and does not send any data to other servers (unless you ask it to show the location of an encounter, in which case it will contact OpenStreetMap servers).
- The app does not show any advertising.
The source code of the app is published at https://github.com/mh-/corona-warn-companion-android, so you can check the source code, build the app yourself, and you are also welcome to contribute to improvements.
This mode requires the installation of the RamBLE - Bluetooth LE Mapper app.
In RaMBLE mode, the app will not read the Exposure Notification database, but instead read the most recent RaMBLE database export stored in the Download folder.
Note that the Exposure Notifications database contains calibrated_rssi (see here).
RaMBLE however stores only raw_rssi, which means that the colors shown on the details screen are probably different from the case when the app reads the Exposure Notifications database.
Download from the German server:
- Germany, Denmark, Ireland, Italy, Croatia, Latvia, Netherlands, Poland, Spain, Cyprus
Download from the respective country's server:
- Austria
- Belgium
- Canada
- Czechia
- Netherlands
- Poland
- Switzerland
- England and Wales
In the top right hand corner of the app is a menu button, please use this to select the countries from which you want to download Diagnosis Keys.
Please note that we mainly follow changes that happen in the German CWA setup; if you experience problems with another country, please let us know via a GitHub issue.
- The app is used for private purposes only, it is not used for any business purposes.
- The app is not a "hacking tool". It only reads data from the memory of your own device, which is stored there without additional encryption.
