Skip to content

BullyHelp is a student-focused anti-bullying and safety Android app featuring emergency SOS alerts, real-time location sharing, anonymous reporting, and ML-powered educational tools to promote safer school environments.

Notifications You must be signed in to change notification settings

mewHacks/bully-help

Repository files navigation

📱 BullyHelp — Anti-Bullying & Safety Companion App

BullyHelp is a mobile safety and anti-bullying application designed for secondary school students in Malaysia.
It empowers students to respond effectively to bullying incidents through emergency SOS alerts, anonymous reporting, and AI-assisted learning tools — promoting a safer and more supportive school environment.


🌟 Key Features

🆘 1. Emergency Trigger System (SOS)

  • Primary Trigger: Manual red “SOS” button (long press to prevent accidental triggers).
  • Secondary Trigger (Discreet): Shake phone 3× or use voice command (“Help me!”).
  • Response Action:
    • Faint vibration confirmation
    • 15-second audio capture (deleted if canceled)
    • Sends location and alert to parent/guardian via email
  • False Alarm Cancellation: Draw a specific on-screen pattern (default: 012 horizontal).

📍 2. Location Tracking

  • Real-time latitude, longitude, and timestamp via HMS Location Kit (with Google Maps fallback).
  • Encrypted transmission using HTTPS (TLS 1.2+).
  • Fallback: last known location if GPS unavailable.

📡 3. Guardian Communication System

  • Sends student’s name, live map link, and coordinates to parent/guardian.
  • Integrates with Google Maps or Huawei Map Kit (depending on user device).

🧑‍🎓 4. Onboarding & Profile Setup

  • Simple student registration (name, school, class, parent email).
  • Parent approval step for emergency contact setup.
  • Permission management for location and microphone access.

⚙️ 5. Configuration Dashboard

  • Edit profile details, header theme, and emergency contact info.
  • Adjust motion detection sensitivity.
  • Toggle voice command and audio recording features.

🧾 6. Incident History

  • View all past SOS triggers with timestamp and location.
  • Local data storage using Room Database.

👀 7. Anonymous Reporting

  • Report bullying incidents anonymously.
  • Option to attach a photo or video.
  • Reports are encrypted and sent without storing sender identity.

🧠 8. Educational & Gamified Learning

  • Flip-card quiz and memory games to teach empathy and awareness.
  • Integrated BullyBuster AI using Google ML Kit to detect bullying-related words.
  • Encourages responsible social interaction through rewards and learning.

☁️ 9. Backend & Data Handling

  • Local storage via Room.
  • Data packets (SOS, location, audio) securely transmitted over HTTPS.
  • No third-party analytics — only essential data collected for safety.

🧩 Technical Stack

Category Technology
Language Java
Database Room (SQLite)
ML Google ML Kit
Maps / Location HMS Location Kit + Google Maps fallback
UI Framework Android Jetpack
Minimum SDK 26 (Android 8.0 Oreo)
Target SDK 34 (Android 14)

🛡️ Privacy & Safety

  • App complies with Malaysia’s PDPA and COPPA (for minors).
  • No personal data shared with third parties.
  • Students remain anonymous during reporting.
  • Parents control permissions and emergency contact setup.

Privacy Policy: https://mewhacks.github.io/bullyhelp-privacy/


🏫 Target Audience

  • Secondary school students (ages 13–17)
  • Teachers and parents for school safety support
  • Educational institutions promoting digital well-being

🧠 AI Component (For Huawei AppGallery Declaration)

  • Uses Google ML Kit Text Analysis for detecting bullying language patterns.
  • Integrated into the BullyBuster Game feature to encourage responsible communication.
  • AI does not store or transmit user data externally.

🧩 Future Improvements

  • Cloud dashboard for school administrators
  • Chatbot-based counseling assistant
  • Integration with Ministry of Education safety channels
  • Real-time location sharing via SMS fallback

👥 Meet the Team

Name GitHub
Hana @mewHacks
dawnKa @dawnKa06
Bryan @bryanongyx-svg

📥 Download BullyHelp

Huawei AppGallery: 👉 https://appgallery.huawei.com/app/C115616353


🚀 How to Build

  1. Clone this repository:
    git clone https://github.com/mewHacks/bully-help.git

About

BullyHelp is a student-focused anti-bullying and safety Android app featuring emergency SOS alerts, real-time location sharing, anonymous reporting, and ML-powered educational tools to promote safer school environments.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages