Merge pull request #110 from xLexip/develop

v1.2.0

Author: xLexip

.github/resources/feature-graphic.png

@@ -1,56 +1,62 @@
-[![Feature Graphic with App Screenshot](https://i.ibb.co/bjHmz8Sh/feature-graphic-gh.png)](https://play.google.com/store/apps/details?id=dev.lexip.hecate&referrer=utm_source%3Dgithub%26utm_medium%3Dreadme_banner)
+[![Feature Graphic / Screenshot](.github/resources/feature-graphic.png)](https://play.google.com/store/apps/details?id=dev.lexip.hecate&referrer=utm_source%3Dgithub%26utm_medium%3Dreadme_banner)
 
 # Adaptive Theme: Auto Dark Mode by Ambient Light
 
-Adaptive Theme automatically switches between light and **dark mode**
+Adaptive Theme automatically switches between light and dark mode
 using the **ambient light sensor** — not a fixed schedule.
 
 It adapts to real lighting conditions to optimize **readability**, **eye comfort**, and **battery
 life**.
 
 <a href="https://play.google.com/store/apps/details?id=dev.lexip.hecate&referrer=utm_source%3Dgithub%26utm_medium%3Dreadme_button">
-    <img src=".github/resources/get-it-on-google-play.svg" alt="Get Adaptive Theme on Google Play" width="200"/>
+    <img src=".github/resources/get-it-on-google-play.svg" alt="Get it on Google Play" width="200"/>
 </a>
 ‎ ‎ ‎
 <a href="https://github.com/xLexip/Adaptive-Theme/releases/latest">
-    <img src=".github/resources/github-releases.png" alt="GitHub" width="200"/>
+    <img src=".github/resources/github-releases.png" alt="GitHub Releases" width="200"/>
+</a> 
+‎ ‎ ‎
+<a href="https://play.google.com/store/apps/details?id=moe.shizuku.privileged.api&referrer=utm_source%3Dgithub%26utm_medium%3Dxlexip">
+    <img src=".github/resources/works-with-shizuku.png" alt="Shizuku (PlayStore)" width="200"/>
 </a> 
 
-## 🚀 Quick Start (2 minutes)
+### YouTube: [HowToMen – Top 15 Best Android Apps - February 2026](https://www.youtube.com/watch?v=iY3FBMTA15A&t=98s&ref=GitHub_xLexip)
+
+## Quick Start (2 minutes)
 
 1. **Install** Adaptive Theme.
-2. **Grant the permission** with the [web-tool](https://lexip.dev/setup), Shizuku, or other methods
-   below.
-3. **Pick your lux threshold** and you’re done. ✅
+2. **Grant the permission** with the [web-tool](https://lexip.dev/setup), Shizuku, or other methods.
+3. **Pick your lux threshold** and you’re done.
 
-## 📋 Table of Contents
+## Table of Contents
 
-- [✨ Features & Highlights](#-features--highlights)
-- [🛠️ One-Time Setup](#%EF%B8%8F-one-time-setup)
-- [✅ Safety](#-safety)
-- [⚙️ How it Works](#%EF%B8%8F-how-it-works)
-- [❓ FAQ](#-faq)
-- [❤️ Support the Project](#%EF%B8%8F-support-the-project)
-- [🏗️ Architecture & Tech Stack](#%EF%B8%8F-architecture--tech-stack)
+- [Features & Highlights](#features--highlights)
+- [One-Time Setup](#one-time-setup)
+- [Safety](#safety)
+- [How it works](#how-it-works)
+- [FAQ](#faq)
+- [Support the Project](#support-the-project)
+- [Architecture & Tech Stack](#architecture--tech-stack)
+- [Credits](#credits)
 
-## ✨ Features & Highlights
+## Features & Highlights
 
-* 🌤️ **Smart Detection:** Uses your devices physical light sensor to switch the system
+* **Smart Detection:** Uses your devices physical light sensor to switch the system
   theme.
-* ⚙️ **Custom brightness threshold:** Choose exactly when the theme should flip or use a preset (
+* **Custom brightness threshold:** Choose exactly when the theme should flip or use a preset (
   indoor, outdoor, sunlight, etc.).
-* 🔋 **Battery Friendly:** The app is passive. Its event-driven architecture only checks the sensor
+* **Battery Friendly:** The app is passive. Its event-driven architecture only checks the sensor
   when you turn on the screen — zero battery drain in the background.
-* 🗝️ **No Root Required:** Root access is not required (but supported as an alternative setup
+* **No Root Required:** Root access is not required (but supported as an alternative setup
   method).
-* 🐱 **Shizuku Support:** One of multiple setup options is
+* **Shizuku Support:** One of multiple setup options is
   using [Shizuku](https://github.com/RikkaApps/Shizuku).
-* 🚀 **Modern & Native:** Built with best-practices using Kotlin, Jetpack Compose and Material You
+* **Modern & Native:** Built with best-practices using Kotlin, Jetpack Compose and Material You
   for a smooth and solid experience.
-* 🌍 **50+ Languages:** Applied globalization at its best.
-* 🔒 **Transparent:** Free, open-source, no-ads.
+* **50+ Languages:** Applied globalization at its best.
+* **Transparent:** Free, open-source, no-ads.
 
-## 🛠️ One-Time Setup
+## One-Time Setup
 
 Android restricts apps from changing system themes by default. To unlock this feature, the
 permission (`WRITE_SECURE_SETTINGS`) has to be granted.
@@ -64,7 +70,7 @@ methods to do so:
   installation required (WebADB).
   👉 **[lexip.dev/setup](https://lexip.dev/setup)**
 
-* **Shizuku** – If you have **[Shizuku](https://github.com/RikkaApps/Shizuku)** installed and
+* **Shizuku** – If you have [Shizuku](https://github.com/RikkaApps/Shizuku) installed and
   configured, you can
   grant the permission directly within Adaptive Theme.
 
@@ -75,14 +81,14 @@ methods to do so:
   manually:
   ```adb shell pm grant dev.lexip.hecate android.permission.WRITE_SECURE_SETTINGS```
 
-## ✅ Safety
+## Safety
 
 The required permission only allows the app to change system settings such as the dark mode. This is
 absolutely safe and
 completely reversible by uninstalling the app. It does **not** grant root access or read any user
 data.
 
-## ⚙️ How it Works
+## How it works
 
 **Wondering why the theme didn't change immediately?**
 
@@ -91,11 +97,11 @@ To avoid screen flicker and unnecessary background work, Adaptive Theme follows
 - **Event-driven:** It checks the light sensor only right after the screen turns on. Combined with
   hysteresis, this prevents flicker, avoids interruptions while you’re using the phone, and saves
   battery.
-- **Validity check:** It verifies that the sensor is not obstructed (e.g., by a hand or pocket).
+- **Validity check:** It verifies that the sensor is not obstructed (e.g. by a hand or pocket).
 - **Seamless switch:** It switches the theme instantly, ensuring the UI is ready before you start
   interacting with it.
 
-## ❓ FAQ
+## FAQ
 
 **Does this require root?**
 
@@ -121,7 +127,7 @@ To avoid screen flicker and unnecessary background work, Adaptive Theme follows
 If Adaptive Theme doesn’t work for you — or if you have any questions or ideas — please [open an
 issue](https://github.com/xLexip/Adaptive-Theme/issues/new) here or send feedback via the app.
 
-## ❤️ Support the Project
+## Support the Project
 
 Adaptive Theme is **completely free**, **ad-free**, **open source**, and developed in my free time.
 
@@ -138,7 +144,7 @@ also [buy me a coffee](https://buymeacoffee.com/lexip).
 
 📣 **Spread the Word:** Share the app to help the project grow.
 
-## 🏗️ Architecture & Tech Stack
+## Architecture & Tech Stack
 
 [![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white)](https://developer.android.com/)
 [![Kotlin](https://img.shields.io/badge/Kotlin-B125EA?style=for-the-badge&logo=kotlin&logoColor=white)](https://kotlinlang.org/)
@@ -162,12 +168,15 @@ including haptic feedback.
 **Background Work:** Sensor operations run event-driven – only upon screen-on
 broadcasts – ensuring zero unnecessary battery drain in the background.
 
-### **Made with 🥨 in Germany.**
+## Credits
+
+* Thanks to Facundo Holzmeister (HowToMen)
+  for featuring Adaptive Theme in
+  a [YouTube video](https://youtu.be/iY3FBMTA15A?si=N8aCNyHj7vzRpiiC&t=98).
+* Thanks to Abdul
+  for featuring Adaptive Theme in
+  a [YouTube video](https://youtu.be/CH_4E1LzGcU?si=BHWwIAIMiiWp6iWf&t=459).
+* Thanks to [AlbertCaro](https://github.com/xLexip/Adaptive-Theme/pull/107) for spanish translation
+  strings.
 
-> ~~> Keywords: theme switcher · android automation · night mode · dark sense · automatic android
-dark
-mode ·
-brightness-based ·
-light-based · based on lux · google pixel · auto dark theme · shizuku apps · android 14 · android
-15 · android 16 ·
-android 17 <~~
+### **Made with 🥨 in Germany.**

.github/resources/works-with-shizuku.png

@@ -16,8 +16,8 @@ android {
 		applicationId = "dev.lexip.hecate"
 		minSdk = 34
 		targetSdk = 35
-		versionCode = 103
-		versionName = "1.1.0"
+		versionCode = 106
+		versionName = "1.2.0"
 		testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
 	}
 

README.md

@@ -168,6 +168,7 @@ fun MainScreen(
 					ThreeDotMenu(
 						isAdaptiveThemeEnabled = uiState.adaptiveThemeEnabled,
 						packageName = packageName,
+						isInstalledFromPlayStore = uiState.isInstalledFromPlayStore,
 						onShowCustomThresholdDialog = { showCustomDialog.value = true }
 					)
 				},

app/build.gradle.kts

@@ -25,6 +25,7 @@ import dev.lexip.hecate.data.UserPreferencesRepository
 import dev.lexip.hecate.logging.Logger
 import dev.lexip.hecate.services.BroadcastReceiverService
 import dev.lexip.hecate.util.DarkThemeHandler
+import dev.lexip.hecate.util.InstallSourceChecker
 import dev.lexip.hecate.util.LightSensorManager
 import dev.lexip.hecate.util.ProximitySensorManager
 import kotlinx.coroutines.CoroutineDispatcher
@@ -51,7 +52,8 @@ data class MainUiState(
 	val customAdaptiveThemeThresholdLux: Float? = null,
 	val hasSetupCompleted: Boolean = false,
 	val isDeviceCovered: Boolean = false,
-	val isShizukuInstalled: Boolean = false
+	val isShizukuInstalled: Boolean = false,
+	val isInstalledFromPlayStore: Boolean = false
 )
 
 class MainViewModel(
@@ -143,6 +145,11 @@ class MainViewModel(
 	private var customThresholdTemp: Float? = null
 
 	init {
+		viewModelScope.launch(ioDispatcher) {
+			val fromPlayStore = InstallSourceChecker.fromPlayStore(application)
+			_uiState.value = _uiState.value.copy(isInstalledFromPlayStore = fromPlayStore)
+		}
+
 		viewModelScope.launch {
 			userPreferencesRepository.userPreferencesFlow.collect { userPreferences ->
 				_uiState.value = _uiState.value.copy(

app/src/main/kotlin/dev/lexip/hecate/ui/MainScreen.kt

@@ -29,7 +29,6 @@ import dev.lexip.hecate.BuildConfig
 import dev.lexip.hecate.R
 import dev.lexip.hecate.logging.Logger
 import dev.lexip.hecate.util.InAppReviewHandler
-import dev.lexip.hecate.util.InstallSourceChecker
 import java.net.URLEncoder
 import java.nio.charset.StandardCharsets
 
@@ -39,6 +38,7 @@ const val FEEDBACK_SUBJECT = "Adaptive Theme Feedback (v${BuildConfig.VERSION_NA
 fun ThreeDotMenu(
 	isAdaptiveThemeEnabled: Boolean,
 	packageName: String,
+	isInstalledFromPlayStore: Boolean,
 	onShowCustomThresholdDialog: () -> Unit
 ) {
 	val context = LocalContext.current
@@ -123,7 +123,7 @@ fun ThreeDotMenu(
 
 				// 4) Beta Feedback (only on beta builds from Play Store)
 				if (BuildConfig.VERSION_NAME.contains("-beta")
-					&& InstallSourceChecker.fromPlayStore(context)
+					&& isInstalledFromPlayStore
 				) {
 					DropdownMenuItem(
 						text = { Text(text = "Beta Feedback") },
@@ -156,7 +156,7 @@ fun ThreeDotMenu(
 						}
 
 						val supportUri =
-							"https://github.com/xLexip/Adaptive-Theme?tab=readme-ov-file#%EF%B8%8F-support-the-project".toUri()
+							"https://lexip.dev/hecate/support-the-project".toUri()
 						val supportIntent = Intent(Intent.ACTION_VIEW, supportUri)
 						try {
 							context.startActivity(supportIntent)

app/src/main/kotlin/dev/lexip/hecate/ui/MainViewModel.kt

@@ -0,0 +1,95 @@
+<resources>
+    <string name="action_back">Atrás</string>
+    <string name="action_cancel">Cancelar</string>
+    <string name="action_close">Cerrar</string>
+    <string name="action_continue">Continuar</string>
+    <string name="action_disable_notification">Ocultar notificación</string>
+    <string name="action_finish">Finalizar</string>
+    <string name="action_set">Establecer</string>
+    <string name="action_share_url">Compartir enlace</string>
+    <string name="action_skip">Omitir</string>
+    <string name="action_use_adaptive_theme">Usar %1$s</string>
+
+    <string name="description_service_purpose">
+       Alterna entre el modo claro y oscuro según la luz ambiental, optimizando el confort visual y la batería.
+    </string>
+
+    <string name="description_switching_conditions">
+       Los cambios solo ocurren inmediatamente después de encender la pantalla, siempre que el sensor no esté cubierto.
+    </string>
+
+    <string name="description_notification_service_running">
+       Ajustando el tema del sistema según el brillo ambiental.
+    </string>
+
+    <string name="device_covered_title">Sensor cubierto</string>
+    <string name="device_covered_message">Los cambios de tema están pausados porque el sensor de luz está cubierto.</string>
+
+    <string name="error_invalid_lux_value">Valor de brillo no válido.</string>
+    <string name="error_negative_lux_value">El valor no puede ser negativo.</string>
+    <string name="error_lux_value_too_large">El valor no puede exceder 100,000.</string>
+
+    <string name="title_about_github">Acerca de / GitHub</string>
+    <string name="title_brightness_threshold">Umbral de brillo</string>
+    <string name="title_live_measurement">Valor en vivo</string>
+    <string name="title_change_language">Cambiar idioma</string>
+    <string name="title_current_brightness">Brillo actual</string>
+    <string name="title_custom_threshold">Umbral personalizado</string>
+    <string name="title_more">Más</string>
+    <string name="title_notification_channel_service">Servicio de cambio de tema</string>
+    <string name="title_send_feedback">Enviar comentarios</string>
+    <string name="title_support_project">Apoyar el proyecto</string>
+
+    <string name="adaptive_threshold_bright">Brillante</string>
+    <string name="adaptive_threshold_custom">Personalizado</string>
+    <string name="adaptive_threshold_dark">Oscuro</string>
+    <string name="adaptive_threshold_daylight">Luz de día</string>
+    <string name="adaptive_threshold_dim">Tenue</string>
+    <string name="adaptive_threshold_soft">Suave</string>
+    <string name="adaptive_threshold_sunlight">Luz solar</string>
+
+    <string name="hint_custom_threshold_value">Valor en Lux</string>
+
+    <string name="setup_action_open_developer_settings">Abrir opciones para desarrolladores</string>
+    <string name="setup_action_open_settings">Abrir configuración</string>
+    <string name="setup_connect_title">Paso 2: Conectar a otro dispositivo</string>
+    <string name="setup_connect_body">Para conceder el permiso, necesitas un <b>dispositivo secundario</b> (computadora, tableta o teléfono). Conecta este dispositivo a él mediante USB.</string>
+    <string name="setup_developer_mode_title">Paso 1: Habilitar modo desarrollador</string>
+    <string name="setup_developer_mode_body">Habilita la depuración por USB en las opciones para desarrolladores.</string>
+    <string name="setup_developer_options_unlock">Desbloquear opciones para desarrolladores</string>
+    <string name="setup_developer_options_enabled">Opciones para desarrolladores habilitadas</string>
+    <string name="setup_dev_options_toast_one">Busca el número de compilación y tócalo 7 veces para habilitar las opciones para desarrolladores.</string>
+    <string name="setup_dev_options_toast_two">Usa la función de búsqueda si no puedes encontrarlo.</string>
+    <string name="setup_alternative_methods">Métodos alternativos</string>
+    <string name="setup_grant_title">Paso 3: Conceder el permiso con el otro dispositivo</string>
+    <string name="setup_grant_body">Abre el siguiente enlace en tu otro dispositivo y sigue las instrucciones:</string>
+    <string name="setup_alternatives">Alternativamente, puedes ejecutar un comando ADB tú mismo o usar root para conceder el permiso. Shizuku también es compatible.</string>
+    <string name="setup_permission_granted">Permiso concedido.</string>
+    <string name="setup_permission_not_granted">Permiso aún no concedido. Por favor completa la configuración con el otro dispositivo.</string>
+    <string name="setup_usb_debugging_disabled">Habilitar depuración por USB</string>
+    <string name="setup_usb_debugging_enabled">Depuración por USB habilitada</string>
+    <string name="setup_usb_debugging_toast">Habilitar depuración por USB</string>
+    <string name="setup_usb_not_connected">Esperando conexión USB…</string>
+    <string name="setup_usb_connected">USB conectado</string>
+    <string name="setup_why_other_device_title">¿Por qué se requiere otro dispositivo?</string>
+    <string name="setup_why_other_device">Android impide que las aplicaciones se concedan el permiso requerido a sí mismas. Requiere otro dispositivo con un navegador web o ADB instalado. </string>
+    <string name="setup_is_this_safe_title">¿Es esto seguro?</string>
+    <string name="setup_is_this_safe_body">Sí. Solo permite a la aplicación modificar configuraciones como el modo oscuro. Esto es absolutamente seguro y completamente reversible. Además, el código fuente está disponible públicamente en GitHub.</string>
+    <string name="setup_shizuku_title">Alternativa: Shizuku</string>
+    <string name="setup_shizuku_body">Si ya usas Shizuku, no necesitarás un segundo dispositivo ni ADB.</string>
+    <string name="setup_shizuku_action">Usar Shizuku en su lugar</string>
+    <string name="setup_action_use_root">Usar Root</string>
+    <string name="setup_root_request">Solicitando acceso root…</string>
+    <string name="setup_root_grant_failed">Falló la concesión de root.</string>
+    <string name="setup_root_question">¿Está el dispositivo rooteado?</string>
+
+    <string name="setup_required_title">Configuración requerida</string>
+    <string name="setup_required_message">%1$s requiere una configuración única para funcionar.</string>
+    <string name="action_start_setup">Iniciar configuración</string>
+
+    <string name="shizuku_not_ready">Inicia Shizuku e inténtalo de nuevo.</string>
+    <string name="shizuku_denied">Acceso denegado. Permite esta aplicación en Shizuku.</string>
+    <string name="shizuku_request_permission">Solicitando permiso…</string>
+    <string name="shizuku_grant_shell_failed">Shizuku no pudo ejecutar el comando.</string>
+    <string name="shizuku_grant_unexpected">Error inesperado al usar Shizuku.</string>
+</resources>

app/src/main/kotlin/dev/lexip/hecate/ui/components/ThreeDotMenu.kt

@@ -11,7 +11,7 @@ plugins {
 sonar {
 	properties {
 		property("sonar.projectKey", "xLexip_Hecate")
-		property("sonar.projectVersion", "1.1.0")
+		property("sonar.projectVersion", "1.2.0")
 		property("sonar.organization", "xlexip")
 		property("sonar.host.url", "https://sonarcloud.io")
 		property("sonar.androidLint.reportPaths", "app/build/reports/lint-results-debug.html")