Skip to content

Commit a1301aa

Browse files
committed
update README
1 parent 27431ee commit a1301aa

1 file changed

Lines changed: 17 additions & 9 deletions

File tree

README.md

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ TrackerControl is an Android app that allows users to monitor and control the wi
1010
ongoing, hidden data collection in mobile apps about user behaviour ('tracking').
1111

1212
To detect tracking, TrackerControl combines the power of the *Disconnect blocklist*,
13-
used by Firefox, and of our in-house blocklist, created *from analysing ~2 000 000 apps*!
13+
used by Firefox, and of our in-house blocklist, created *from analysing ~2 000 000 apps*! **To protect your privacy from your ISP, you can also optionally encrypt your DNS traffic using DNS-over-HTTPS (DoH).**
1414
Additionally, TrackerControl supports custom blocklists and uses the signatures from [ClassyShark3xodus](https://f-droid.org/en/packages/com.oF2pks.classyshark3xodus/)/[Exodus Privacy](https://exodus-privacy.eu.org/) for the analysis of tracker libraries within app code.
1515

1616
This approach
@@ -24,7 +24,7 @@ Under the hood, TrackerControl uses Android's VPN functionality,
2424
to analyse apps' network communications *locally on the Android device*.
2525
This is accomplished through a local VPN server, to enable network traffic analysis by TrackerControl.
2626

27-
No root is required, other VPNs or Private DNS are not supported.
27+
No root is required. Other VPNs or Android's "Private DNS" feature are not supported (due to Android limitations), but TrackerControl provides its own **Secure DNS (DNS-over-HTTPS / DoH)** feature to protect your DNS traffic.
2828
No external VPN server is used, to keep your data safe! TrackerControl even protects you
2929
against *DNS cloaking*, a popular technique to hide trackers in websites and apps.
3030

@@ -61,7 +61,14 @@ TrackerControl will always be free and open source, being a research project.
6161
alt="Get it on Google Play"
6262
height="80">](https://play.google.com/store/apps/details?id=net.kollnig.missioncontrol.play)
6363

64-
There are multiple versions of TrackerControl.
64+
There are multiple versions of TrackerControl:
65+
66+
| Feature | Play Store (Slim) | F-Droid / GitHub (Full) |
67+
| :--- |:----------------------:| :---: |
68+
| **Tracker Analysis** |||
69+
| **Traffic Log** |||
70+
| **Tracker & Ad Blocking** | ❌ (Google Restriction) ||
71+
| **Secure DNS (DoH)** |||
6572

6673
If you're interested in *blocking* tracking, then best download TrackerControl from [here](https://github.com/TrackerControl/tracker-control-android/releases/latest/download/TrackerControl-githubRelease-latest.apk), from [F-Droid](https://f-droid.org/packages/net.kollnig.missioncontrol.fdroid), or from the [IzzyOnDroid](https://apt.izzysoft.de/fdroid/index/apk/net.kollnig.missioncontrol) F-Droid Repository.
6774

@@ -83,9 +90,9 @@ You can export the results of your analysis from the app menu TrackerControl to
8390

8491
It is further possible to enable the direct logging of contacted domains to the console. This is helpful for research studies that instrument apps using an additional computer and can be enabled through Settings -> Advanced options -> Log transmissions to ADB. Note that this disables any blocking.
8592

86-
By default, the analysis of system apps is disabled. This is because the analysis of the network traffic of system apps can lead to unexpected behaviour and should only be used by experienced users. You can enable the analysis of system apps through Settings -> Advanced Options -> Manage system apps. The analysis of system apps might be helpful if you want to analyse the data sharing of sytem apps, such as Google Maps, YouTube or the Google Play Service, all of which might be used by other apps to do tracking for them. In other words, without looking at system apps, some tracking might be missed; the challenge here, however, is that it's difficult to differentiate different apps that use other Google apps for tracking. This means that for a robust analysis, it's prudent to uninstall and deactivate as many apps on the user's phone as possible.
93+
By default, the analysis of system apps is disabled. This is because the analysis of the network traffic of system apps can lead to unexpected behaviour and should only be used by experienced users. You can enable the analysis of system apps through Settings -> Advanced Options -> Manage system apps. The analysis of system apps might be helpful if you want to analyse the data sharing of system apps, such as Google Maps, YouTube or the Google Play Service, all of which might be used by other apps to do tracking for them. In other words, without looking at system apps, some tracking might be missed; the challenge here, however, is that it's difficult to differentiate different apps that use other Google apps for tracking. This means that for a robust analysis, it's prudent to uninstall and deactivate as many apps on the user's phone as possible.
8794

88-
TrackerControl also has a traffic log functionality that can be accssed from the menu bar. If enabled, contacted tracking domains will be highlighted in **bold**. Note, however, that the traffic log currently lacks a display of whether there's ambiguity in the contacted domains (as opposed to the per-app screens that show when certain domains are *uncertain*). Displayed domains can be inaccurate.
95+
TrackerControl also has a traffic log functionality that can be accessed from the menu bar. If enabled, contacted tracking domains will be highlighted in **bold**. Note, however, that the traffic log currently lacks a display of whether there's ambiguity in the contacted domains (as opposed to the per-app screens that show when certain domains are *uncertain*). Displayed domains can be inaccurate.
8996

9097
### Tracker library analysis
9198

@@ -99,7 +106,7 @@ TrackerControl is a community-driven project and welcomes contributions of all k
99106

100107
If you need support in using the app, join one of the [online communities](https://github.com/TrackerControl/tracker-control-android#communities).
101108

102-
If you find any errors or bugs or have suggestions for improvements, you can use the [issue tracker](https://github.com/TrackerControl/tracker-control-android/issues). The issue tracker provides two different templates, one one for bugs and the other for improvements.
109+
If you find any errors or bugs or have suggestions for improvements, you can use the [issue tracker](https://github.com/TrackerControl/tracker-control-android/issues). The issue tracker provides two different templates, one for bugs and the other for improvements.
103110

104111
If you want to contribute directly to code of TrackerControl, feel free to file a pull request or, alternatively, use the [issue tracker](https://github.com/TrackerControl/tracker-control-android/issues).
105112

@@ -132,8 +139,9 @@ TrackerControl provides
132139
- *real-time monitoring* of app tracking, including destination companies and countries,
133140
- *granular blocking* of app tracking,
134141
- *one-click data requests* as granted under EU Data Protection Legislation,
135-
- *ad-blocking* using widely available host files, and
136-
- *tracker library analysis* of apps' code.
142+
- *ad-blocking* using widely available host files,
143+
- *tracker library analysis* of apps' code, and
144+
- *secure DNS* using DNS-over-HTTPS (DoH) (optional).
137145

138146
<p align="center">
139147
<img alt="Screenshot of app overview" src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" style="margin: 0 auto;" height="100%" width="25%" >
@@ -181,7 +189,7 @@ necessary for network communications (e.g. IP address).
181189

182190
TrackerControl uses the ACRA plugin. This is considered to be a 'good' tracker.
183191
It's open-source, and could be used to collect crash reports automatically
184-
to a server–TrackerControl DOES NOT do this. Instead, the user must app report crashes
192+
to a server–TrackerControl DOES NOT do this. Instead, the user must manually report crashes
185193
manually, via e-mail. ACRA shows a dialog to do this in TrackerControl.
186194

187195
TrackerControl itself never sends any personal data off your device.

0 commit comments

Comments
 (0)