SOS is an Android application designed to provide a quick and efficient way to alert your chosen contacts when you feel unsafe. The app allows users to send an SMS with a chosen text, including their live location, to selected contacts. It also supports sending this information via Telegram using a bot. The app provides three threat levels—high, medium, and low—allowing users to communicate the severity of the situation.
The Proposal is in Proposal
The Final Report description is in Final Report Description
The implemented Report is in Final Report
The code for this project including telegram bot is available on the master branch. Please switch to that branch to see the latest updates.
View the master branch
The code for this project including authentication is available on the pishNoskhe branch. Please switch to that branch to see the latest updates.
View the pishNoskhe branch
This project uses the following libraries:
- Send Emergency SMS: Quickly send a custom message with your live location to your chosen contacts.
- Threat Levels: Choose from three threat levels (High, Medium, Low) to indicate the severity of the situation.
- Telegram Integration: Send emergency alerts through a Telegram bot in addition to SMS.
- Contact Management: Access your phone's contacts to easily select who should receive your SOS messages.
- Location Tracking: Automatically attach your live location to the alert message.
- User Authentication: Secure your app with login and sign-up functionalities, using a database for user management.
-
Login or Sign Up:
- Open the app and either log in or sign up to create an account.
-
Set Up Emergency Contacts:
- Navigate to the contacts page, select your emergency contacts, and save them.
-
Set Up Default Message:
- Customize the base text of the SOS message in the settings.
-
Trigger SOS:
- In case of an emergency, open the app, choose the threat level, and click the SOS button to send the alert.
Include screenshots of your UI to give users a visual idea of your app. You can display them like this:
| Sign Up | Log in | Home | Settings | Add Contact | Add Text | SMS | Telegram Bot |
|---|---|---|---|---|---|---|---|
 |
 |
 |
 |
 |
 |
 |
 |
| Sign Up | Log in | Home | Settings | Add Contact | Add Text | SMS | Telegram Bot |
This project is developed using Android Studio.
Step-by-step instructions on how to get the development environment running:
- Clone repository to your local system.
- Launch Android Studio.
- Click on File > Open.
- Navigate to the folder where you cloned the repository and select the project folder.
- Sync the project with Gradle Files.
- Click the Run button
to start the project.
