Skip to content

aharonamir/freeme

Repository files navigation

FreeMe

FreeMe is a personal safety application for Android that allows users to quickly send a pre-configured SMS alert to their trusted contacts.

Features

  • One-Tap Alerts: Send an SMS alert to your pre-configured contacts with a single tap on the "Send FreeMe" icon.
  • Contact Management: Easily add and manage the contacts who will receive your alerts.
  • Customizable Message: (Future feature) Customize the alert message to suit your needs.
  • Location Sharing: (Future feature) Optionally include your current location in the alert message.

How to Use

  1. Setup: After installing the app, open the main "FreeMe" app to configure your settings and add the contacts you want to alert.
  2. Trigger Alert: To send an alert, simply tap the "Send FreeMe" icon on your home screen. The app will send the SMS in the background without opening the app.

Permissions

The app requires the following permissions to function correctly:

  • SEND_SMS: To send the SMS alert.
  • READ_CONTACTS: To select contacts from your phone.
  • WRITE_CONTACTS: To add new contacts from within the app.
  • ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION: (For future location sharing feature)

Building the Project

  1. Clone this repository.
  2. Open the project in Android Studio.
  3. Build and run the app on an Android device or emulator.

About

Android app to help people in distress or uncomfortable situation

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages