YetAnotherCallBlocker/README.md

140 lines
6.1 KiB
Markdown
Raw Permalink Normal View History

2019-09-01 16:47:15 +02:00
**Disclaimer:** This is a free and open source project, but it relies on third-party web-services for some functions to work. This project is not affiliated with any third-party entities in any other sense.
2019-03-25 12:07:08 +01:00
# Yet Another Call Blocker
A free and open source application that can block unwanted calls or warn about probable intentions of callers using a third-party crowdsourced phone number database (from some other proprietary app).
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
alt="Get it on F-Droid"
height="80">](https://f-droid.org/app/dummydomain.yetanothercallblocker)
## Key features
* Uses offline database.
* Blocks unwanted calls automatically (option).
* Displays a notification with phone number summary (rating, reviews count, category) during incoming calls (option).
* Automatic incremental/delta database updates (option).
* You can view online reviews for caller's number (provided by 3rd party service).
2019-03-25 12:07:08 +01:00
## How to use
* [Install](https://f-droid.org/app/dummydomain.yetanothercallblocker) and launch the app.
* The option to show caller info notifications is enabled by default, so the app will ask for phone-related permissions.
* At first start, the app will suggest to download main database which is required for most of the functions. Simply confirm the download.
(The DB is downloaded from [another gitlab repo](https://gitlab.com/xynngh/YetAnotherCallBlocker_data), so no privacy-related implications.)
* Check the "Auto-update database" checkbox in the menu (recommended) to automatically receive daily DB updates (these are incremental/delta updates, so they consume very little traffic).
* Check the "Block unwanted calls" checkbox to block calls with negative rating automatically.
2020-05-08 14:22:39 +02:00
* You can also check the "Use contacts" checkbox if you want your contacts not to be treated as unknown callers.
2019-09-07 16:37:41 +02:00
* After these steps everything should just work. Enjoy!
2019-03-25 12:07:08 +01:00
## [Screenshots](fastlane/metadata/android/en-US/images/phoneScreenshots/)
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" alt="The info screen" width="280"/>
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" alt="Online reviews" width="280"/>
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" alt="Incoming call notification" width="280"/>
## More on features
2019-03-25 12:07:08 +01:00
2020-05-08 14:22:39 +02:00
At this point most of the essential features (one would expect from a call blocking app) are implemented. Here's an overview:
2019-03-25 12:07:08 +01:00
2019-09-07 16:37:41 +02:00
* Showing a notification with some caller info (positive/negative rating, category, number of negative reviews and such) when the phone's ringing. *Works offline.*
2020-05-08 14:22:39 +02:00
* Loading and displaying a list of reviews for a number (accessed from the notification or the info view). *Requires internet.*
* Automatic blocking of unwanted calls (may not work on some devices; tested to work on modern Android versions (including Android 10)). *Works offline.*
2019-07-20 19:49:17 +02:00
* Automatic update of the database (for offline use). *Requires internet.*
2020-05-08 14:22:39 +02:00
* Displaying a list of recent calls with caller rating and the ability to show more info or load online reviews for the number. The list *works offline*, but loading reviews *requires internet.*
* If "use contacts" option is enabled, the numbers present in the phone book are never blocked and the contact name is displayed next to/instead of a number throughout the app.
## Privacy
Protecting the user's privacy is the first concern during development. No personal data is sent to or otherwise shared with anyone.
The only known possible data leaks are the following:
* Database update procedure leaks user's IP address to the update servers.
The request also includes current database version (base or updated).
* Online review requests leak user's IP address coupled with the phone number in question.
Shouldn't be a big deal unless you request it for numbers in your phone book.
2020-05-08 14:22:39 +02:00
If the "use contacts" feature is enabled, a confirmation dialog is shown if online reviews are requested for a number present in your phone book.
No other identifiable information is sent with the requests.
2019-03-25 12:07:08 +01:00
2019-09-01 16:47:15 +02:00
## Available data
2019-03-25 12:07:08 +01:00
The following data is available in the main offline database:
* a phone number,
* a category (telemarketers, dept collectors, scam, etc.),
* a number of negative reviews,
* a number of positive reviews,
* a number of neutral reviews.
2019-09-01 16:47:15 +02:00
The main database may receive delta updates from third-party servers.
2019-03-25 12:07:08 +01:00
The "featured" database provides "names" (company names or short descriptions) for some (presumably) subset of numbers in the main database.
The third-party servers can be queried for a list of detailed user reviews for a specific phone number.
A detailed review contains:
* A rating: positive, negative or neutral.
* A category: each review may have a different one.
* A title and a comment: the actual description the user left for the number.
## Rationale
Some may find the original application (whose DB and servers are used) hard to trust because of its proprietary nature (and also the use of firebase analytics and the like).
But since the database behind that application is crowdsourced, some may find it acceptable (in a moral sense) to use that database in a separate open source application.
Also, this project is meant to be non-commercial. So, there's that.
## License
[AGPLv3](https://www.gnu.org/licenses/agpl-3.0.en.html).
## Contributing
Any contributions are very welcome.
## Building
Clone the project repo:
```
2019-07-20 19:49:17 +02:00
git clone https://gitlab.com/xynngh/YetAnotherCallBlocker.git
2019-03-25 12:07:08 +01:00
```
Clone the assets repo (optional step: allows to avoid the initial DB downloading after installation):
2019-03-25 12:07:08 +01:00
```
2019-07-20 19:49:17 +02:00
git clone https://gitlab.com/xynngh/YetAnotherCallBlocker_data.git
2019-03-25 12:07:08 +01:00
```
Sym-link the assets:
Linux
2019-03-25 12:07:08 +01:00
```
cd YetAnotherCallBlocker/app/src/main/assets/
ln -s ../../../../../YetAnotherCallBlocker_data/assets/sia .
```
Windows
```
cd YetAnotherCallBlocker\app\src\main\assets
mklink /d sia ..\..\..\..\..\YetAnotherCallBlocker_data\assets\sia
```
2019-03-25 12:07:08 +01:00
**or** copy the whole directory `YetAnotherCallBlocker_data/assets/sia` into `YetAnotherCallBlocker/app/src/main/assets/`.
Then you can build the app using Android Studio or using Gradle:
```
./gradlew assemble
```