SMS Forwarder Neo

Eine zuverlässige Android-Anwendung zum automatischen Weiterleiten von eingehenden SMS-Nachrichten per SMS und E-Mail. Die App läuft als Vordergrund-Dienst für zuverlässige Hintergrundverarbeitung.

Open Source unter der MIT-Lizenz - vollständig transparent, keine versteckten Funktionen, keine Datensammlung.

Features

Kernfunktionen

Automatische SMS-Weiterleitung: Leitet eingehende SMS automatisch an vordefinierte Kontakte weiter
E-Mail-Weiterleitung: Sendet SMS-Inhalte zusätzlich per E-Mail
Multi-Teil SMS-Unterstützung: Rekonstruiert automatisch mehrteilige SMS-Nachrichten
Parallele Weiterleitung: Gleichzeitige Verarbeitung von SMS- und E-Mail-Weiterleitung
Zuverlässiger Vordergrund-Dienst: Nutzt Foreground Service mit WakeLock für stabile Hintergrundverarbeitung

Erweiterte Funktionen

Kontaktverwaltung: Intelligente Auswahl von Weiterleitungsempfängern aus Kontakten
SIM-Karten-Verwaltung: Unterstützung für Dual-SIM-Geräte
Loop Protection: Verhindert Endlosschleifen durch intelligente Erkennung eigener SIM-Karten
Strukturiertes Logging: XML-basierte Protokollierung mit automatischer Rotation
Log-Export: Exportiere Protokolle für Fehleranalyse und Monitoring
Verschlüsselte Einstellungen: Sichere Speicherung von Credentials und Konfiguration
SMTP-Unterstützung: Flexible E-Mail-Konfiguration mit verschiedenen Anbietern
Test-Utilities: Integrierte Tools zum Testen der SMS-Funktionalität
Heartbeat-Monitoring: Automatische Überwachung der Dienstverfügbarkeit

Technologie-Stack

Plattform & Sprache

Kotlin: 2.1.0
Target SDK: 35 (Android 15)
Min SDK: 29 (Android 10+)
Compile SDK: 36
JDK: 17

UI Framework

Jetpack Compose: Moderne deklarative UI
Compose BOM: 2024.11.00
Material Design 3: Aktuelle Design-Standards
Navigation Compose: 2.8.5

Architektur & Bibliotheken

Clean Architecture: MVVM mit Repository Pattern
ViewModels: Factory-Pattern für Dependency Injection
Coroutines & Flow: Asynchrone Programmierung und reaktive Datenverwaltung
Security Crypto: Verschlüsselte SharedPreferences (AES256-GCM)
libphonenumber: 8.13.52 - Telefonnummer-Validierung
JavaMail: 1.6.7 - E-Mail-Versand (SMTP)
Timber: 5.0.1 - Strukturiertes Logging
Coil: 2.7.0 - Bildverarbeitung

Voraussetzungen

Entwicklungsumgebung

Android Studio: Ladybug (2024.2.1) oder neuer
JDK: Version 17
Gradle: 8.7+
Android Gradle Plugin: 8.7.3
Git: Für Versionskontrolle

Android-Gerät/Emulator

Android 10 (API 29) oder höher
Telefonie-Feature: Empfohlen für volle Funktionalität
Dual-SIM: Optional, aber unterstützt

Installation

1. Repository klonen

git clone https://github.com/meuse24/forwarderA1.git
cd forwarderA1

2. Projekt öffnen

# Der main Branch ist der stabile Produktions-Branch
# Kein Branch-Wechsel erforderlich

3. Build-Umgebung vorbereiten

Kommandozeile

./gradlew assembleDebug

Android Studio

Öffne das Projekt in Android Studio
Sync Project with Gradle Files
Run 'app' oder Build > Build Bundle(s) / APK(s)

4. APK installieren

# Auf verbundenem Gerät installieren
./gradlew installDebug

# Oder manuell
adb install app/build/outputs/apk/debug/app-debug.apk

Build-Befehle

# Debug Build (Entwicklung)
./gradlew assembleDebug

# Release Build (Produktion)
./gradlew assembleRelease

# Installation auf Gerät
./gradlew installDebug

# Schneller Kompilierungscheck
./gradlew compileDebugKotlin

# Tests ausführen
./gradlew test

# Clean Build
./gradlew clean

Verwendung

Erste Schritte

Berechtigungen erteilen
- SMS empfangen/senden
- Kontakte lesen
- Telefonstatus
- Batterie-Optimierung ignorieren
- Benachrichtigungen
E-Mail-Konfiguration (optional)
- Navigiere zu "Mail" Tab
- SMTP-Server konfigurieren
- Absender- und Empfänger-Adressen eingeben
- SMTP-Credentials (Passwort wird verschlüsselt gespeichert)
Kontakte auswählen
- Wähle Kontakte für SMS-Weiterleitung
- Aktiviere/deaktiviere einzelne Kontakte nach Bedarf
Dienst starten
- Der Vordergrund-Dienst startet automatisch
- Status wird in der Benachrichtigungsleiste angezeigt
- Heartbeat-Monitoring läuft im Hintergrund
Logs überwachen
- Navigiere zu "Logs" Tab
- Filtere nach Zeitraum oder Ereignistyp
- Exportiere Logs für Analyse

Wichtige Hinweise

Multi-Teil SMS: Werden automatisch gruppiert und rekonstruiert
Parallele Verarbeitung: SMS und E-Mail werden gleichzeitig gesendet
WakeLock: Verhindert Sleep während der Nachrichtenverarbeitung
Service-Neustart: Nutzt START_STICKY für automatischen Neustart

Architektur

Package-Struktur

info.meuse24.smsforwarderneoA1/
├── data/                          # Data Layer
│   ├── local/                     # Lokale Datenhaltung
│   │   ├── Logger.kt             # XML-Logging mit Rotation
│   │   └── SharedPreferencesManager.kt  # Verschlüsselte Settings
│   └── repository/                # Repositories
│       └── ContactsRepositoryImpl.kt    # Kontaktverwaltung
├── domain/                        # Domain Layer
│   └── model/                     # Domain Models
│       ├── Contact.kt            # Kontakt-Entität
│       └── LogEntry.kt           # Log-Eintrag
├── presentation/                  # Presentation Layer
│   ├── ui/
│   │   ├── screens/              # Screen Composables
│   │   │   ├── home/            # Hauptbildschirm
│   │   │   ├── mail/            # E-Mail-Konfiguration
│   │   │   ├── settings/        # Einstellungen
│   │   │   ├── logs/            # Log-Anzeige
│   │   │   └── info/            # App-Informationen
│   │   └── components/           # Wiederverwendbare Komponenten
│   │       ├── dialogs/         # Dialog-Komponenten
│   │       └── navigation/      # Navigation-Komponenten
│   ├── viewmodel/                # ViewModels
│   │   ├── ContactsViewModel.kt
│   │   ├── LogViewModel.kt
│   │   ├── EmailViewModel.kt
│   │   ├── SimManagementViewModel.kt
│   │   ├── TestUtilsViewModel.kt
│   │   └── NavigationViewModel.kt
│   └── state/                    # UI State Models
├── service/                       # Service Layer
│   ├── SmsReceiver.kt            # BroadcastReceiver für SMS
│   └── SmsForegroundService.kt   # Foreground Service
└── util/                          # Utilities
    ├── email/                     # E-Mail-Utilities
    ├── permission/                # Permission-Handling
    ├── phone/                     # Telefon-Utilities
    └── sms/                       # SMS-Utilities

Schlüsselkomponenten

MainActivity.kt (819 Zeilen)

Activity-Kern mit Permission-Handling
Navigation zwischen Screens
ViewModel-Initialisierung
Lifecycle-Management

ContactsViewModel.kt (1.278 Zeilen)

Kontaktauswahl und -verwaltung
Weiterleitungslogik
State-Management für UI

PhoneSmsUtils.kt (1.380 Zeilen)

SMS-Sende- und Empfangsfunktionen
Telefonnummer-Validierung
USSD-Code-Ausführung
SIM-Karten-Management

SmsForegroundService.kt

Multi-Teil SMS-Rekonstruktion
Parallele SMS/E-Mail-Weiterleitung
WakeLock-Management
Heartbeat-Monitoring
Service-Lifecycle

SmsReceiver.kt

Empfängt SMS_RECEIVED_ACTION
Leitet Nachrichten an Service weiter
Broadcast-Handling

Berechtigungen

Kritische Berechtigungen

<!-- SMS-Funktionalität -->
<uses-permission android:name="android.permission.RECEIVE_SMS"/>
<uses-permission android:name="android.permission.SEND_SMS"/>

<!-- Kontaktzugriff -->
<uses-permission android:name="android.permission.READ_CONTACTS"/>

<!-- Telefonfunktionen -->
<uses-permission android:name="android.permission.CALL_PHONE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />

<!-- Hintergrunddienst -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL" />

<!-- Batterie-Optimierung -->
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

<!-- Benachrichtigungen -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<!-- Internet (für E-Mail) -->
<uses-permission android:name="android.permission.INTERNET" />

Sicherheit

Datenverschlüsselung

Alle Einstellungen werden mit androidx.security.crypto verschlüsselt
SMTP-Passwörter werden niemals im Klartext gespeichert
Verschlüsselte SharedPreferences mit AES256-GCM

Datenschutz

Telefonnummern werden nur lokal verarbeitet
Logs können exportiert und gelöscht werden
Keine Cloud-Synchronisation oder Datenübertragung an Dritte
App ist für privaten Gebrauch konzipiert

Best Practices

Sichere Intent-Filter
FileProvider für URI-Zugriff
Runtime-Permissions
Foreground Service Notification

Entwicklung

Code-Stil

Kotlin Coding Conventions: Offizielle Kotlin-Standards
Clean Architecture: Strikte Layer-Trennung
SOLID-Prinzipien: Single Responsibility, Open/Closed, etc.
Dependency Injection: Factory-Pattern für ViewModels

Neue Präferenz hinzufügen

// 1. SharedPreferencesManager
fun getMyPreference(): Boolean =
    encryptedPrefs.getBoolean("my_preference", false)

fun setMyPreference(value: Boolean) =
    encryptedPrefs.edit().putBoolean("my_preference", value).apply()

// 2. ViewModel
private val _myPreference = MutableStateFlow(false)
val myPreference: StateFlow<Boolean> = _myPreference.asStateFlow()

// 3. UI Component
val myPref by viewModel.myPreference.collectAsState()
Switch(checked = myPref, onCheckedChange = { viewModel.updatePreference(it) })

SMS-Verarbeitung modifizieren

// SmsForegroundService.kt
private fun processMessageGroup(messages: List<SmsMessage>) {
    // 1. Multi-Teil SMS rekonstruieren
    val fullMessage = messages.joinToString("") { it.messageBody }

    // 2. Logging
    LoggingManager.log("SMS empfangen: $fullMessage")

    // 3. Weiterleitung (parallel)
    coroutineScope.launch { forwardViaSms(fullMessage) }
    coroutineScope.launch { forwardViaEmail(fullMessage) }
}

Neuen Screen hinzufügen

// 1. Erstelle Screen in presentation/ui/screens/myscreen/
@Composable
fun MyScreen(viewModel: MyViewModel) { /* ... */ }

// 2. Route in MainActivity.kt
when (currentRoute) {
    "myscreen" -> MyScreen(myViewModel)
    // ...
}

// 3. Navigation in BottomNavigationBar
NavigationBarItem(
    icon = { Icon(Icons.Default.MyIcon, "My Screen") },
    selected = currentRoute == "myscreen",
    onClick = { navViewModel.navigate("myscreen") }
)

Neues ViewModel erstellen

// 1. ViewModel mit Factory
class MyViewModel(
    private val prefsManager: SharedPreferencesManager
) : ViewModel() {

    // State
    private val _myState = MutableStateFlow<MyState>(MyState.Initial)
    val myState: StateFlow<MyState> = _myState.asStateFlow()

    // Factory
    class Factory(
        private val prefsManager: SharedPreferencesManager
    ) : ViewModelProvider.Factory {
        override fun <T : ViewModel> create(modelClass: Class<T>): T {
            return MyViewModel(prefsManager) as T
        }
    }
}

// 2. In MainActivity instanziieren
val myViewModel: MyViewModel by viewModels {
    MyViewModel.Factory(prefsManager)
}

Testing

# Unit Tests
./gradlew test

# Instrumented Tests
./gradlew connectedAndroidTest

# Test-Coverage
./gradlew jacocoTestReport

Git-Workflow

Branches

main: Stabiler Produktions-Branch (empfohlen)

Commits

# Änderungen commiten
git add .
git commit -m "feat: Neue Feature-Beschreibung"

# Push mit PAT
source .env
git push https://meuse24:$GITHUB_TOKEN@github.com/meuse24/forwarderA1.git main

Commit-Konventionen

feat: - Neue Features
fix: - Bugfixes
refactor: - Code-Umstrukturierung
docs: - Dokumentation
test: - Tests
chore: - Build/Tooling

Projekt-Status

Abgeschlossene Phasen (Clean Architecture Refactoring)

✅ Phase 1-5 komplett:

Package-Struktur etabliert
Domain Models extrahiert
Data Layer separiert (Logger, SharedPrefs, Repository)
MainActivity: 3.870 → 819 Zeilen (-79%)
ContactsViewModel: 2.341 → 1.278 Zeilen (-45%)
Alle kritischen Fehler behoben (Permissions, Null-Safety, Lifecycle, Coroutines)

Die App ist stabil und produktionsbereit.

Bekannte Limitierungen

Keine Datenbank-Persistierung (nur SharedPreferences)
Keine Cloud-Synchronisation
E-Mail-Versand erfordert SMTP-Konfiguration
Logs werden lokal in XML gespeichert

Roadmap

Fehlerbehebung

Build-Probleme

# Problem: "Permission denied" beim gradlew
chmod +x gradlew

# Problem: Gradle Daemon startet nicht
./gradlew --stop
./gradlew assembleDebug --no-daemon

App-Probleme

# Service startet nicht
- Prüfe Batterie-Optimierung (deaktivieren)
- Prüfe Berechtigungen in Android-Einstellungen
- Logs in App überprüfen

# SMS werden nicht weitergeleitet
- Prüfe SMS-Berechtigungen
- Prüfe ausgewählte Kontakte
- Prüfe Service-Status
- Logs exportieren und analysieren

# E-Mail-Versand fehlschlägt
- SMTP-Credentials prüfen
- Internet-Verbindung prüfen
- Firewall/VPN-Einstellungen
- SMTP-Server-Logs prüfen

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

MIT License

Copyright (c) 2026 Günther Meusburger

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Kontakt

Repository: https://github.com/meuse24/forwarderA1
Issues: https://github.com/meuse24/forwarderA1/issues

Danksagungen

Jetpack Compose: Für das moderne UI-Framework
libphonenumber: Für robuste Telefonnummer-Validierung
JavaMail: Für SMTP-Funktionalität
AndroidX Security: Für Verschlüsselung

Version: Barracuda Build: Debug/Release Letzte Aktualisierung: 2026-01-23

Neueste Änderungen (2026-01-23)

✅ Open Source: Vollständige MIT-Lizenz Dokumentation
✅ Info Screen: Open Source Card mit GitHub-Links und Lizenzhinweis
✅ Hilfe Screen: Technische Details zu Loop-Schutz, Multi-SIM und Datensicherheit
✅ Datenschutzerklärung: Loop Protection Section hinzugefügt
✅ System Info: Erweitert mit Kotlin 2.1, Compose BOM, JDK 17
✅ Android 15/16: Unterstützung in Version-Erkennung hinzugefügt
✅ Lint: abortOnError aktiviert mit Baseline
✅ Baseline Profile: Für verbesserte App-Startzeit

Frühere Änderungen

✅ Loop Protection: Kritischer Schutzmechanismus gegen SMS-Endlosschleifen (Sender- und Own-SIM-Check)
✅ Timber Logging: Strukturiertes Logging mit JSON Lines Format
✅ Dialog Consolidation: Vereinheitlichtes Dialog-System
✅ Manual SIM Number Editing: Manuelle SIM-Nummern-Bearbeitung

Name		Name	Last commit message	Last commit date
Latest commit History 71 Commits
Anleitung		Anleitung
app		app
docs		docs
gradle		gradle
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
index.html		index.html
settings.gradle.kts		settings.gradle.kts

License

meuse24/forwarderA1

Folders and files

Latest commit

History

Repository files navigation