Skip to content

Commit 4495112

Browse files
committed
README.md: Update README.md to enhance app description and features, including multi-language support and data sources for call blocking
1 parent b71f125 commit 4495112

File tree

1 file changed

+22
-2
lines changed

1 file changed

+22
-2
lines changed

README.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Call Blocker App
22

3-
Call Blocker App is a Kotlin-based application designed to help you manage and block unwanted incoming calls while maintaining a whitelist of approved contacts. It uses web scraping to enhance the call-blocking experience by integrating real-time data from popular spam-detection Spanish websites.
3+
Call Blocker App is a Kotlin-based application designed to help you manage and block unwanted incoming calls while maintaining a whitelist of approved contacts. It integrates multiple spam detection sources, including real-time web scraping and an external API with multi-country support.
44

55
## Screenshots
66

@@ -15,16 +15,27 @@ Here are some screenshots of the Call Blocker App in action:
1515

1616
## Features
1717

18+
- **Multi-Language Number Lookup via UnknownPhone API**: Lookup phone numbers internationally using the UnknownPhone API, supporting the following country numbers:
19+
```
20+
United States, UK, Spain, France, Germany, Italy,
21+
Russia, Sweden, Poland, Portugal, Netherlands,
22+
Norway, Czech Republic, Indonesia, China, Japan,
23+
Israel, Turkey, Hungary, Finland, Denmark,
24+
Thailand, Greece, Slovakia, Romania
25+
```
1826
- **Block and Unblock Numbers**: Easily block or unblock specific phone numbers.
1927
- **Whitelist Management**: Maintain a whitelist of phone numbers that are always allowed to reach you.
2028
- **Web-Based Number Lookup**: Automatically look up phone numbers using two trusted Spanish websites:
2129
- [www.listaspam.com](https://www.listaspam.com)
2230
- [www.responderono.es](https://www.responderono.es)
31+
- [www.cleverdialer.es](https://www.cleverdialer.es)
2332
- **Real-Time Web Scraping**: Leverage web scraping techniques to gather real-time information on whether a number should be blocked.
33+
- **Automatic App Updates**: The app checks for updates upon launch and prompts the user to install them if available.
2434

2535
## Settings
2636

2737
- **General Blocking**: Toggle to enable or disable call blocking.
38+
- **Filter by UnknownPhone API**: Use UnknownPhone API to check numbers based on selected language.
2839
- **Filter by ListaSpam**: Enable filtering based on data from www.listaspam.com.
2940
- **Filter by Responderono**: Enable filtering based on data from www.responderono.es.
3041
- **Block Unknown Numbers**: Option to block all numbers not saved in your contacts.
@@ -36,7 +47,16 @@ Here are some screenshots of the Call Blocker App in action:
3647

3748
## How It Works
3849

39-
The app uses the JSoup library for web scraping, which allows it to retrieve and parse HTML data from www.listaspam.com and www.responderono.es. This data is then processed to determine whether an incoming call should be blocked or not.
50+
The app combines multiple data sources to determine if an incoming call should be blocked:
51+
52+
- UnknownPhone API Integration
53+
Sends a POST request with the phone number and selected language to the UnknownPhone API, returning a rating indicating whether the number is likely spam. Numbers with an average rating below 3 (bad or dangerous) are blocked automatically.
54+
55+
- Web Scraping with JSoup
56+
Scrapes listas spam and responderono websites in real time to gather fresh data on suspicious numbers.
57+
58+
- User Preferences
59+
Uses your configured settings (whitelist, block unknown, hidden, or international numbers) to customize blocking behavior.
4060

4161
## Data Management
4262

0 commit comments

Comments
 (0)