Repository files navigation

Igatha is an open-source SOS signaling and recovery app designed for war zones and disaster areas, enabling offline emergency communication when traditional networks fail.

• iOS:v1.0
• Android:v1.0

1. Install the app using the links above.
2. Open the app and grant the necessary permissions.

1. Open Igatha.
2. Ensure bluetooth is enabled.
3. Tap "Send SOS".

1. Open Igatha.
2. Tap the gear icon (top right).
3. Enable "Disaster Detection".

With disaster detection, Igatha will now run in the background, monitoring your device's sensors.When a potential disaster is detected, you'll receive an "Are you okay?" notification:

• If you respond with "Need help" or don't respond in 2 minutes, it will automatically broadcast an SOS.
• If you respond with "I'm okay", it will ignore the event.

If you're safe and want to help others:

1. Open Igatha.
2. Ensure bluetooth is enabled (on Android 11 or lower, also enable Location).
3. Check "People seeking help".
4. Move towards locations where displayed distances decrease.
5. Listen carefully for audible sirens.

Igatha uses Bluetooth Low Energy (BLE) to:

1. Broadcast SOS signals.
2. Scan for nearby SOS broadcasts.
3. Estimate approximate distance to the signal source based on signal strength.

No internet or GPS is required, preventing signal jamming or manipulation.

The SOS signal combines:

1. BLE advertisement: broadcasts a pseudonymized identifier.
2. Audible siren: generated via device speakers to help responders locate you.

Responders can toggle additional signals, like flashlight or vibration, remotely. (planned feature)

Igatha detects disasters using device sensors:

1. Accelerometer: measures sudden motion changes.
2. Gyroscope: detect orientation and rotation shifts.
3. Barometer (if available): detects atmospheric pressure changes, reducing false positives.

Disaster detection triggers when multiple sensors simultaneously detect abrupt changes.

Location permissions are required for "Disaster Detection".

Igatha minimizes battery use by leveraging BLE and optimized sensor monitoring.

The app can continuously broadcast for extended periods during emergencies.

• This is a Minimum Viable Product (MVP) with significant room for improvement
• Testing has been limited to controlled environments
• While not guaranteed to work in all scenarios, it provides a potential lifeline where no alternatives exist

• BLE range: typically 10-30 meters indoors, further outdoors, limited by rubble and building materials.
• Optional extensions: Third-party BLE receivers can extend range significantly.

Igatha is open-sourced for:

1. Transparency: In crisis situations, people need to trust the tools they use. Open source allows anyone to verify the app's security and privacy measures.

2. Accessibility: Making the code freely available ensures the technology can be used, studied, and adapted by anyone who needs it.

3. Community Impact: War and disaster response tools should be community resources, not commercial products. Open sourcing enables collaborative improvement and adaptation for different crisis scenarios.

Contributions are vital for improving Igatha:

• Testing and bug reports
• Documentation
• Translations
• Feature enhancements
• Code optimization
• Security reviews
• Distribution

To contribute, open an issue or submit a pull request.

• Completely offline; no data collection or internet connectivity.
• Uses pseudonymized identifiers for privacy.

For questions, suggestions, or feedback, please open an issue in the repository.