Skip to content

Repository files navigation

Felp

Felp Logo

Acil anlarda tek dokunuşla yardım iste.

Felp, zor anlarda güvendiğin kişilere hızlıca SMS ile ulaşmanı sağlayan basit, hafif ve gizlilik odaklı bir Android uygulamasıdır. Ana ekrana eklediğin widget sayesinde telefonunun kilidini bile açmadan, tek dokunuşla acil durum mesajı gönderebilirsin.


✨ Özellikler

🚨 Acil Durum Widget'ı

  • Ana ekrana eklenen widget'a dokunarak anında SMS gönderimi
  • İstediğin boyutta widget (1x1'den büyük boyutlara kadar)
  • Kişiselleştirilebilir widget metni, rengi ve boyutu
  • Arka plan fotoğrafı desteği

👥 Güvenilir Kişi Yönetimi

  • Birden fazla acil durum kişisi tanımlama
  • Her kişiye ayrı telefon numarası

📍 Konum Desteği

  • Mesaja otomatik Google Maps konum linki ekleme
  • Konum izni tamamen isteğe bağlı, varsayılan olarak kapalı

🎨 Kişiselleştirme

  • Widget dokunma geri bildirimi: kenarlık, emoji veya hiçbiri
  • Yazı rengi ve boyutu ayarı
  • Widget arka plan fotoğrafı

🔔 Toast Bildirimi

  • Mesaj gönderildiğinde kısa süreli ekran uyarısı
  • İzinler ekranından açılıp kapatılabilir

🔒 Gizlilik

  • Tüm veriler telefonda kalır
  • İnternet bağlantısı gerektirmez
  • Felp mesajlarını okumaz, sadece senin mesajını gönderir

📸 Ekran Görüntüleri

İzinler Kişiler & Mesaj Widget Ayarları
İzinler ekranı Kişiler ve mesaj ayarları Widget ayarları
Widget Önizleme (Emoji) Widget Önizleme (Metin) Ana Ekran Widget'i
Widget emoji geri bildirimi Widget metin önizlemesi Ana ekrandaki Felp widget'i

🛠️ Teknolojiler

Alan Teknoloji
Dil Kotlin 2.1.20
UI Jetpack Compose + Material 3
Mimari MVVM benzeri, Compose tabanlı
Veri Saklama SharedPreferences + Gson
Konum Google Play Services Location
Min SDK 26 (Android 8.0)
Target SDK 36 (Android 16)

📥 Kurulum

Hazır APK ile Kurulum

  1. Releases sayfasından en son app-debug.apk dosyasını indir.
  2. APK dosyasını Android cihazına aktar.
  3. Dosyaya dokunarak yükle.
  4. Gerekirse Bilinmeyen kaynaklar için izin ver.

Kaynak Kodundan Derleme

# Repoyu klonla
git clone https://github.com/batuhd/felp.git
cd felp

# Debug APK derle
.\gradlew.bat assembleDebug

# Cihaza yükle
adb install -r app\build\outputs\apk\debug\app-debug.apk

🔐 Gerekli İzinler

İzin Amaç
SEND_SMS Acil durum mesajlarını göndermek
ACCESS_FINE_LOCATION Mesaja konum linki eklemek (isteğe bağlı)
VIBRATE Widget'a dokunulduğunda titreşim geri bildirimi
POST_NOTIFICATIONS Android 13+ üzerinde toast mesajı göstermek (isteğe bağlı)
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS Uygulamanın arka planda çalışmasını korumak (isteğe bağlı)

🏗️ Mimari

app/
├── data/
│   └── PrefsRepository.kt      # Kullanıcı tercihleri ve widget ayarları
├── receiver/
│   └── SendAlertReceiver.kt    # Widget tıklamasıyla SMS gönderimi
├── widget/
│   └── PanicWidgetProvider.kt  # Widget görünümü ve güncellemeleri
├── helper/
│   ├── LocationHelper.kt       # Senkron konum alma
│   ├── WidgetBitmapHelper.kt   # Dinamik widget bitmapleri
│   ├── WidgetImageHelper.kt    # Widget arka plan fotoğrafı işlemleri
│   └── BatteryOptimizationHelper.kt
└── ui/
    ├── OnboardingScreen.kt
    ├── PeopleSettingsScreen.kt
    ├── WidgetSettingsScreen.kt
    ├── PermissionsScreen.kt
    └── theme/                  # Tema ve renkler

🚀 Nasıl Kullanılır

  1. Uygulamayı ilk açtığında güvenilir bir kişi ve mesaj gir.
  2. SMS izni ver.
  3. Ana ekrandan Felp widget'ını ekle.
  4. İhtiyaç anında widget'a dokun; mesaj otomatik olarak gönderilir.

🛡️ Gizlilik

Felp mesajlarını okumaz. Sadece senin yazdığın mesajı, senin belirlediğin kişilere gönderir. Tüm veriler telefonunda kalır; herhangi bir sunucuya veya buluta veri aktarılmaz.


⚠️ Sorumluluk Reddi

Bu uygulama yalnızca acil durum bilgilendirmesi amacıyla geliştirilmiştir. Uygulamanın çalışması, telefon operatörü, cihaz ayarları, pil optimizasyonu veya kullanıcı tarafından verilen izinler gibi faktörlere bağlıdır. Uygulamanın kullanımı sonucunda oluşabilecek iletişim gecikmeleri, mesajların ulaşmaması veya diğer teknik sorunlardan uygulama geliştiricisi sorumlu tutulamaz.


📄 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır.


Made with Love by B for F❤️ in Sinop

About

Acil anlarda tek dokunuşla yardım iste. Gizlilik odaklı, çevrimdışı çalışan Android panic widget SMS uygulaması.

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages