Begone: Blocking List 🇫🇷

This repository contains blocking lists of unwanted numbers for France, to be used with the Begone application on iOS.

Prerequisites

Before you begin, ensure you have installed the Begone application on your iPhone. Once the application is installed, launch it and follow the instructions to activate it as a call blocking application on iOS.

Installation

Open this page on your iPhone and follow the instructions below:

1. Long press on the link of the desired list below and select Download Linked File.

   • Spam Numbers (recommended)
   • VOIP Numbers
     • OnOff Numbers
     • Ubicentrex Numbers
     • BJT Partners Numbers
     • Kavkom Numbers
   • Prepaid Numbers
     • Lyca Numbers
   • Complete List

2. Open the Begone application and select Import New Numbers.

3. Select Files.

4. Import the file you just downloaded.

Contribution

Setting Up the Development Environment

1. Create a new Python virtual environment and install the necessary dependencies.

   uv venv
   uv sync
   # or run 'make init'

2. Activate the virtual environment.

   source .venv/bin/activate

Adding New Numbers to the Blocking List

1. Update the data/numbers.yaml file with the new numbers you wish to block.

2. Run make to generate the new lists in the dist folder.

Release a new version

Whenever you update the files in the dist/ directory, increment the begone.version file as follows:

1. Version: Increment the number on the first line for structural changes or modifications to the operator data source.
2. Build Number: Always increment the number on the second line with every update.