Skip to content

Commit 5c20110

Browse files
committed
Update README and add MIT LICENSE
1 parent 40a9cff commit 5c20110

File tree

2 files changed

+62
-9
lines changed

2 files changed

+62
-9
lines changed

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2024
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 41 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,56 @@
1-
# ListaSpam App
1+
# Call Blocker App
22

3-
ListaSpam 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 uses web scraping to enhance the call-blocking experience by integrating real-time data from popular spam-detection Spanish websites.
44

55
## Features
66

77
- **Block and Unblock Numbers**: Easily block or unblock specific phone numbers.
88
- **Whitelist Management**: Maintain a whitelist of phone numbers that are always allowed to reach you.
9-
- **Web-Based Number Lookup**: Automatically look up phone numbers using two trusted spanish websites:
10-
- [listaspam.com](https://www.listaspam.com)
11-
- [Responderono.es](https://www.responderono.es)
9+
- **Web-Based Number Lookup**: Automatically look up phone numbers using two trusted Spanish websites:
10+
- [www.listaspam.com](https://www.listaspam.com)
11+
- [www.responderono.es](https://www.responderono.es)
1212
- **Real-Time Web Scraping**: Leverage web scraping techniques to gather real-time information on whether a number should be blocked.
1313

14-
### Settings
14+
## Settings
1515

1616
- **General Blocking**: Toggle to enable or disable call blocking.
17-
- **Filter by listaspam**: Enable filtering based on data from listaspam.com.
18-
- **Filter by Responderono**: Enable filtering based on data from ResponderONo.es.
17+
- **Filter by ListaSpam**: Enable filtering based on data from www.listaspam.com.
18+
- **Filter by Responderono**: Enable filtering based on data from www.responderono.es.
1919
- **Block Unknown Numbers**: Option to block all numbers not saved in your contacts.
20+
- **Block Hidden Numbers**: Option to block calls from numbers with hidden caller IDs.
21+
- **Block International Calls**: Option to block all incoming international calls.
2022
- **Notifications**: Receive a notification whenever a call is blocked.
23+
- **Export Preferences**: Export all app settings and blocked/whitelisted numbers.
24+
- **Import Preferences**: Import previously exported settings and number lists.
2125

2226
## How It Works
2327

24-
The app uses the JSoup library for web scraping, which allows it to retrieve and parse HTML data from listaspam.com and responderono.es. This data is then processed to determine whether an incoming call should be blocked or not.
28+
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.
29+
30+
## Data Management
31+
32+
- **Export**: Users can export all their preferences, including settings and black/white lists of numbers, to a file for backup or transfer to another device.
33+
- **Import**: Previously exported data can be imported, allowing users to quickly set up the app on a new device or restore settings after a reset.
34+
35+
## Privacy and Security
36+
37+
This app is designed with user privacy in mind. All data is stored locally on the device, and the app only accesses the internet to perform web scraping for number lookup. No personal data is shared with external servers.
38+
39+
## Requirements
40+
41+
- Android 9.0 (Pie) or higher
42+
- Internet connection for web scraping features
43+
44+
## Installation
45+
46+
1. Download the APK from the releases page or compile it by yourself.
47+
2. Enable installation from unknown sources in your device settings.
48+
3. Install the app and grant necessary permissions for call management and internet access.
49+
50+
## Contributing
51+
52+
We welcome contributions to this app! Please, feel free to upload your pull requests, report bugs, or suggest new features.
53+
54+
## License
55+
56+
This app is released under the MIT License. See the LICENSE file for more details.

0 commit comments

Comments
 (0)