Merge pull request #193 from Semper-Viventem/master

Release 0.29.5-beta

Author: Semper-Viventem

README.md

@@ -7,6 +7,9 @@
 <a href='https://f-droid.org/en/packages/f.cking.software/'><img alt='Get it on F-Droid' src='https://github.com/Semper-Viventem/MetaRadar/assets/18288554/c03a0cf2-b39a-4344-adb8-d4cde7ce4b61' width='200'/></a>
 <a href='https://android.izzysoft.de/repo/apk/f.cking.software'><img alt='Get it on IzzyOnDroid' src='https://github.com/Semper-Viventem/MetaRadar/assets/18288554/c0c85c9f-edc8-4fc7-97b1-bda925bf0833' width='200'/></a>
 
+> [!WARNING]
+> This project is developed **solely for educational, security research, and personal investigative purposes**. **The author does not endorse or encourage any use of this software for unlawful or unethical activities**. You are **solely responsible** for ensuring your use of this tool complies with all applicable laws and regulations.
+
 This app is a tool for analyzing Bluetooth (BLE) environments. Scans the BLE ether in the background, notifying you if the device you are looking for is nearby or if some unknown device has been following you for for a long time.
 
 The app allows you to create flexible filters for the radar with logical operators. Able to distinguish manufacturers, explore Apple Airdrop packages, and match them with known contacts. Build a device movement map based on the scanned BLE ether around you. For example, you can search for devices that you have seen in a certain period of time, receive a notification if your lost headphones suddenly appear near you.

app/build.gradle.kts

@@ -26,8 +26,8 @@ android {
         minSdk = 29
         targetSdk = 35
 
-        versionCode = 1708536374
-        versionName = "0.29.4-beta"
+        versionCode = 1708536375
+        versionName = "0.29.5-beta"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
 

app/src/main/java/f/cking/software/data/repo/SettingsRepository.kt

@@ -112,6 +112,14 @@ class SettingsRepository(
         return sharedPreferences.getBoolean(KEY_ENABLE_DEEP_ANALYSIS, false)
     }
 
+    fun setDisclaimerWasAccepted(value: Boolean) {
+        sharedPreferences.edit { putBoolean(KEY_DISCLAIMER_WAS_ACCEPTED, value) }
+    }
+
+    fun getDisclaimerWasAccepted(): Boolean {
+        return sharedPreferences.getBoolean(KEY_DISCLAIMER_WAS_ACCEPTED, false)
+    }
+
     companion object {
         private const val KEY_GARBAGING_TIME = "key_garbaging_time"
         private const val KEY_USE_GPS_ONLY = "key_use_gps_location_only"
@@ -124,6 +132,7 @@ class SettingsRepository(
         private const val KEY_CURRENT_BATCH_SORTING_STRATEGY_ID = "key_current_batch_sorting_strategy_id"
         private const val KEY_HIDE_BACKGROUND_LOCATION_WARNING = "key_hide_background_location_warning"
         private const val KEY_ENABLE_DEEP_ANALYSIS = "key_enable_deep_analysis"
+        private const val KEY_DISCLAIMER_WAS_ACCEPTED = "key_disclaimer_was_accepted"
 
         const val NO_APP_LAUNCH_TIME = -1L
         const val NO_ENJOY_THE_APP_STARTING_POINT = -1L

app/src/main/java/f/cking/software/domain/interactor/filterchecker/FilterCheckerImpl.kt

@@ -18,8 +18,6 @@ class FilterCheckerImpl(
     private val checkUserLocationHistoryInteractor: CheckUserLocationHistoryInteractor,
 ) : FilterChecker<RadarProfile.Filter>(powerModeHelper) {
 
-    data class StatData(val name: String, val total: Long, val count: Int, val avg: Long)
-
     private val internalFilters: MutableList<FilterChecker<*>> = mutableListOf()
 
     private val lastDetectionInterval = filterChecker<RadarProfile.Filter.LastDetectionInterval> { device, filter ->

app/src/main/java/f/cking/software/ui/main/MainScreen.kt

@@ -6,7 +6,17 @@ import android.widget.Toast
 import androidx.compose.foundation.Image
 import androidx.compose.foundation.background
 import androidx.compose.foundation.clickable
-import androidx.compose.foundation.layout.*
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.layout.width
 import androidx.compose.foundation.lazy.LazyColumn
 import androidx.compose.foundation.shape.RoundedCornerShape
 import androidx.compose.material.icons.Icons
@@ -52,6 +62,7 @@ import f.cking.software.utils.graphic.DropEffectState
 import f.cking.software.utils.graphic.GlassBottomNavBar
 import f.cking.software.utils.graphic.SystemNavbarSpacer
 import f.cking.software.utils.graphic.ThemedDialog
+import f.cking.software.utils.graphic.infoDialog
 import f.cking.software.utils.graphic.rememberDropEffectState
 import f.cking.software.utils.graphic.withDropEffect
 import org.koin.androidx.compose.koinViewModel
@@ -195,10 +206,35 @@ object MainScreen {
         }
 
         val context = LocalContext.current
+
+        var checkAndStartService: (() -> Boolean)? = null
+
+        val disclaimerDialog = infoDialog(
+            title = stringResource(R.string.disclaimer),
+            content = stringResource(R.string.unlowful_usage_disclaimer),
+            buttons = { state ->
+                {
+                    negativeButton(
+                        stringResource(R.string.decline),
+                        textStyle = TextStyle(color = MaterialTheme.colorScheme.onSurface)
+                    ) { state.hide() }
+
+                    positiveButton(
+                        stringResource(R.string.accept),
+                        textStyle = TextStyle(color = MaterialTheme.colorScheme.onSurface)
+                    ) {
+                        viewModel.disclaimerWasAccepted()
+                        state.hide()
+                        checkAndStartService?.invoke()
+                    }
+                }
+            }
+        )
+
         val permissionsIntro = permissionsIntroDialog(
             onPassed = {
                 viewModel.userHasPassedPermissionsIntro()
-                viewModel.runBackgroundScanning()
+                checkAndStartService?.invoke()
             },
             onDeclined = {
                 Toast.makeText(context, "The scanner cannot work without these permissions", Toast.LENGTH_SHORT).show()
@@ -207,6 +243,23 @@ object MainScreen {
         val haptic = LocalHapticFeedback.current
         var observeEvent = remember { true }
 
+        checkAndStartService = {
+            when {
+                viewModel.needToShowDisclaimer() -> {
+                    disclaimerDialog.show()
+                    false
+                }
+                viewModel.needToShowPermissionsIntro() -> {
+                    permissionsIntro.show()
+                    false
+                }
+                else -> {
+                    viewModel.runBackgroundScanning()
+                    true
+                }
+            }
+        }
+
         ExtendedFloatingActionButton(
             containerColor = MaterialTheme.colorScheme.primaryContainer,
             modifier = Modifier
@@ -225,13 +278,12 @@ object MainScreen {
                         }
 
                         observeEvent && event.action == MotionEvent.ACTION_UP -> {
-                            if (viewModel.needToShowPermissionsIntro()) {
-                                permissionsIntro.show()
-                                dropEffectState.drop(type = DropEffectState.DropEvent.Type.RELEASE_SOFT, touchX, touchY)
-                            } else {
-                                viewModel.runBackgroundScanning()
+                            val started = checkAndStartService.invoke()
+                            if (started) {
                                 dropEffectState.drop(type = DropEffectState.DropEvent.Type.RELEASE_HARD, touchX, touchY)
                                 haptic.performHapticFeedback(HapticFeedbackType.LongPress)
+                            } else {
+                                dropEffectState.drop(type = DropEffectState.DropEvent.Type.RELEASE_SOFT, touchX, touchY)
                             }
                             true
                         }

app/src/main/java/f/cking/software/ui/main/MainViewModel.kt

@@ -113,6 +113,14 @@ class MainViewModel(
         settingsRepository.setPermissionsIntroWasShown(true)
     }
 
+    fun needToShowDisclaimer(): Boolean {
+        return !settingsRepository.getDisclaimerWasAccepted()
+    }
+
+    fun disclaimerWasAccepted() {
+        settingsRepository.setDisclaimerWasAccepted(true)
+    }
+
     private fun observeScanInProgress() {
         viewModelScope.launch {
             BgScanService.state

app/src/main/java/f/cking/software/utils/graphic/ComposeFunctions.kt

@@ -191,11 +191,12 @@ fun rememberProgressDialog(
 fun infoDialog(
     title: String,
     content: String?,
+    buttons: ((state: MaterialDialogState) -> (@Composable MaterialDialogButtons.() -> Unit))? = null,
 ): MaterialDialogState {
     val dialogState = rememberMaterialDialogState()
     ThemedDialog(
         dialogState = dialogState,
-        buttons = {
+        buttons = buttons?.invoke(dialogState) ?: {
             positiveButton(
                 stringResource(R.string.ok),
                 textStyle = TextStyle(color = MaterialTheme.colorScheme.onSurface)

app/src/main/res/values/strings.xml

@@ -16,6 +16,7 @@
     <string name="ok">OK</string>
     <string name="turn_on">Turn on</string>
     <string name="report">Report</string>
+    <string name="accept">Accept</string>
     <string name="shaders_test" translatable="false">Shaders test</string>
     <string name="preparing_database">Optimizing database, it might take a minute…</string>
 
@@ -356,4 +357,6 @@
 
     <string name="bluetooth_status_paired">paired</string>
     <string name="bluetooth_status_paired_description">Device is paired</string>
+    
+    <string name="unlowful_usage_disclaimer">This project is developed solely for educational, security research, and personal investigative purposes. The author does not endorse or encourage any use of this software for unlawful or unethical activities. You are solely responsible for ensuring your use of this tool complies with all applicable laws and regulations.</string>
 </resources>

metadata/en-US/full_description.txt

@@ -1,5 +1,8 @@
 Bluetooth Radar in the background scans and analyzes Bluetooth Low Energy devices around you (eg smartwatches, headphones, speakers) and allows you to set complex rules to search for devices by specified filters. For example, by device name, address, location and time of discovery, manufacturer, and if an unknown device has been chasing you for a long time. Can be used to find your missing devices, or notify you if the device that you are looking for is nearby.
 
+DISCLAIMER
+This project is developed solely for educational, security research, and personal investigative purposes. The author does not endorse or encourage any use of this software for unlawful or unethical activities. You are solely responsible for ensuring your use of this tool complies with all applicable laws and regulations.
+
 In general, the app is capable:
 * Scan, analyze and track Bluetooth devices around;
 * Create flexible filters for the radar;