https://github.com/cbouvat/saracroche-ios
🇫🇷 Saracroche est une application iOS qui bloque les appels indésirables. 🇬🇧 Saracroche is an iOS app that blocks unwanted calls.
https://github.com/cbouvat/saracroche-ios
arcep block callkit demarchage ios phonenumber swift swiftui
Last synced: about 1 month ago
JSON representation
🇫🇷 Saracroche est une application iOS qui bloque les appels indésirables. 🇬🇧 Saracroche is an iOS app that blocks unwanted calls.
- Host: GitHub
- URL: https://github.com/cbouvat/saracroche-ios
- Owner: cbouvat
- License: other
- Created: 2025-03-23T13:32:50.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-08-22T16:03:58.000Z (about 1 month ago)
- Last Synced: 2025-08-22T18:51:01.706Z (about 1 month ago)
- Topics: arcep, block, callkit, demarchage, ios, phonenumber, swift, swiftui
- Language: Swift
- Homepage: https://cbouvat.com/saracroche/
- Size: 1010 KB
- Stars: 82
- Watchers: 2
- Forks: 4
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Saracroche iOS
> 🤖 **Also available for Android**: Check out [Saracroche Android](https://github.com/cbouvat/saracroche-android) for Android users!
## Description
Saracroche is an iOS app that protects you from unwanted calls by blocking spam phone calls. It's designed to be simple, effective, and privacy-friendly.
## Features
- 🛡️ Automatically blocks numbers
- 📱 Native iOS extension
- 🔒 Privacy-respectful: no call data is collected
- 🔄 Regular updates of the number database
## Installation
### App Store
Saracroche is available on the [App Store](https://apps.apple.com/app/saracroche/id6743679292).
### TestFlight
You can also try the latest beta version through [TestFlight](https://testflight.apple.com/join/CFCjF6d2).
### Building from Source
1. Clone the repository
2. Copy `saracroche/Config.swift.example` to `Config.swift`
3. Update the configuration with your server URL
4. Open `saracroche.xcodeproj` in Xcode
5. Build and run the project on your device
**Requirements:**
- Xcode 15.0+
- iOS 15.0+
- Swift 5.9+
## Configuration
The app requires a configuration file `Config.swift` that contains sensitive information like server URLs. This file is gitignored for security.
1. Copy the example configuration:
```bash
cp saracroche/Config.swift.example saracroche/Config.swift
```
2. Edit `Config.swift` with your actual configuration values.
## Technology Stack
- **Swift** - Primary programming language
- **SwiftUI** - Modern UI framework
- **CallKit** - iOS call blocking framework
- **MVVM Architecture** - Clean architecture pattern
## List of prefix numbers
The first list is the one containing numbers reserved for telemarketing by ARCEP : https://www.arcep.fr/la-regulation/grands-dossiers-thematiques-transverses/la-numerotation.html
And other numbers by the community.
### Information about prefixes
All prefixes are communicated by ARCEP : https://www.data.gouv.fr/fr/datasets/ressources-en-numerotation-telephonique/ and https://www.data.gouv.fr/fr/datasets/identifiants-de-communications-electroniques/
- `MAJNUM.csv` file for the list of prefixes : https://extranet.arcep.fr/uploads/MAJNUM.csv
- `identifiants_CE.csv` file for the operators of the prefixes : https://extranet.arcep.fr/uploads/identifiants_CE.csv
Tool to identify the operator by prefix : https://www.arcep.fr/mes-demarches-et-services/entreprises/fiches-pratiques/base-numerotation.html
## Contributing
Contributions are welcome! Here's how you can help:
1. Fork the repository
2. Create a new branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## Sponsorship
If you find Saracroche useful, consider sponsoring the project to help with maintenance and new features:
- [GitHub Sponsors](https://github.com/sponsors/cbouvat)
## Star the Project ⭐
If you like Saracroche, please consider giving it a star on GitHub to show your support and help others discover the project.
## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.