Release v2.0.0 – Kotlin rewrite, MVVM, dark theme & more

.github/workflows/android_build.yml

@@ -3,78 +3,57 @@ name: Android Build
 on:
   push:
     branches:
-      - master  # Change this to your main branch name (e.g., master)
-      - development
+      - '**'  # Trigger on push to any branch
+
 jobs:
   build-debug:
-    name: Build debug
+    # Build debug APK for all feature branches and not master
+    if: github.ref_name != 'master'
     runs-on: ubuntu-latest
-    if: github.ref =='refs/heads/development'
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v2
 
-      - name: Setup JDK
-        uses: actions/setup-java@v3
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
         with:
           distribution: temurin
           java-version: '17'
-
-      - name: Setup Gradle
-        uses: gradle/actions/setup-gradle@v3
-        with:
-          gradle-version: 7.4.2
-
-      - name: Setup Android NDK
-        uses: nttld/setup-ndk@v1.2.0
-        with:
-          ndk-version: r25c
-
-      - name: Grant execute permission for gradlew
-        run: chmod +x ./gradlew
+      - uses: gradle/actions/setup-gradle@v4
+        with: { gradle-version: 7.4.2 }
+      - uses: nttld/setup-ndk@v1.2.0
+        with: { ndk-version: r25c }
+      - run: chmod +x ./gradlew
 
       - name: Build debug APK
         run: ./gradlew assembleDebug
 
-      - name: Upload APK artifact
+      - name: Upload debug APK
         uses: actions/upload-artifact@v4
         with:
-          name: SENDA-debug  # Change this to your desired artifact name
-          path: ./app/build/outputs/apk/debug/*.apk
+          name: SENDA-debug
+          path: app/build/outputs/apk/debug/*.apk
 
-  build-master:
-    name: Build master
+  build-release:
+    # Build release APK ONLY for master branch
+    if: github.ref_name == 'master'
     runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/master'
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v2
 
-      - name: Setup JDK
-        uses: actions/setup-java@v3
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
         with:
           distribution: temurin
-          java-version: '17'  # Change this to the required Java version for your Android project
-
-      - name: Setup Gradle
-      uses: gradle/actions/setup-gradle@v3
-        with:
-          gradle-version: 7.4.2
-
-      - name: Setup Android NDK
-        uses: nttld/setup-ndk@v1.2.0
-        with:
-          ndk-version: r25c
-
-      - name: Grant execute permission for gradlew
-        run: chmod +x ./gradlew
+          java-version: '17'
+      - uses: gradle/actions/setup-gradle@v4
+        with: { gradle-version: 7.4.2 }
+      - uses: nttld/setup-ndk@v1.2.0
+        with: { ndk-version: r25c }
+      - run: chmod +x ./gradlew
 
       - name: Build release APK
         run: ./gradlew assembleRelease
 
       - name: Sign app APK
         uses: r0adkll/sign-android-release@v1
-        # ID used to access action output
         id: sign_app
         with:
           releaseDirectory: app/build/outputs/apk/release
@@ -83,12 +62,10 @@ jobs:
           keyStorePassword: ${{ secrets.KEY_STORE_PASSWORD }}
           keyPassword: ${{ secrets.KEY_PASSWORD }}
         env:
-          # override default build-tools version (33.0.0) -- optional
           BUILD_TOOLS_VERSION: "34.0.0"
 
-      - name: Upload APK artifact
+      - name: Upload release APK
         uses: actions/upload-artifact@v4
         with:
-          name: SENDA-release  # Change this to your desired artifact name
-          path: ${{steps.sign_app.outputs.signedReleaseFile}}  # Change the path to the location of your APK file
-
+          name: SENDA-release
+          path: ${{ steps.sign_app.outputs.signedReleaseFile }}

CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to SENDA are documented in this file.
+
+## [v2.0.0] – 2026-05-22
+
+This is a major release representing a complete overhaul of the SENDA codebase
+and a significant expansion of features since v1.3.0.
+
+### Breaking changes
+- The app has been **fully rewritten in Kotlin** (previously Java). The minimum
+  supported Android version remains Android 11.
+- The internal package structure was reorganised for improved modularity.
+
+### New features
+- **Dark theme** support (follows system setting).
+- **In-app tutorial** with multiple pages guiding new users through setup.
+- **About dialog** accessible from the action bar.
+- **Movella DOT** sensor support: connects once on discovery to resolve the
+  human-readable name, then reconnects for measurement.
+
+### Improvements & refactoring
+- Migrated to **MVVM architecture** with ViewModel and Repository pattern.
+- Foreground service and wakelock handling refactored for `targetSdk 34+`.
+- Permissions handling streamlined; new transient *starting* / *stopping*
+  UI states provide clearer feedback.
+- **16 KB ELF page-size compatibility**: native code compiled with the required
+  alignment flags (Google Play requirement since November 2025). Note that the
+  bundled Movella SDK library is not yet compatible.
+- Main layout simplified to `LinearLayout`; old landscape / splash layouts and
+  unused preference XMLs removed.
+- `compileSdk` / `targetSdk` raised to **35**; NDK updated to **r28**.
+- Gradle plugin updated to **8.1.2 / 8.10**; `setup-gradle` action bumped; CI
+  workflow split into separate debug and release APK jobs.
+- LSL service start/stop made concurrency-safe.
+- LocationBridge crash on startup fixed.
+- MainActivity crash fixed by lazy-initialising the ViewModel.
+- Sensor outlet race condition fixed (sensor stream now starts only after the
+  LSL outlet is initialised).
+- Unit test added for `MainViewModel`.
+- App correctly stops the foreground service when swiped away from recents.
+
+### UI / UX
+- Stream availability status text updated.
+- Layout margins adjusted in `activity_main.xml`.
+- Settings/gear menu icon removed (no configurable settings at this time).
+- Tutorial layout constraints and text corrected.
+
+### Build & CI
+- APK signed correctly via GitHub Actions using repository secrets.
+- Separate CI jobs for debug builds (feature branches) and signed release APKs
+  (master branch).
+- Signing configuration now checks for keystore existence before applying
+  settings, preventing local-build failures.
+
+---
+
+## [v1.3.0] – see [NeuropsyOL/SENDA](https://github.com/NeuropsyOL/SENDA/releases/tag/v1.3.0)
+
+Previous releases are tagged in the public repository at
+https://github.com/NeuropsyOL/SENDA/releases.
+

README.md

@@ -2,11 +2,12 @@
 ---
 # SENDA Android Application to stream out sensor data directly from the Phone
 
-SENDA(Sensor Data Streamer) is an android application to stream real time sensor reading using LSL (Lab Streaming Layer). Along with the sensors it streams real time audio as well. This is a fork from the original author's Git [Ali Ayub Khan's SENDA](https://github.com/AliAyub007/SENDA), which contains additional features and support for Samsung phones.
+SENDA (Sensor Data Streamer) is an android application to stream real-time sensor reading using LSL (Lab Streaming Layer). Along with the sensors it streams real-time audio as well. This is a fork from the original author's Git [Ali Ayub Khan's SENDA](https://github.com/AliAyub007/SENDA), which contains additional features and support for Samsung phones.
 
 ## Features 
 The following sensors are included: 
 - Accelerometer
+- Gyroscope
 - Light
 - Proximity
 - Gravity
@@ -16,6 +17,10 @@ The following sensors are included:
 - Location
 - Movella DOT (via Bluetooth)
 
+Additional capabilities:
+- Dark theme (follows system setting)
+- In-app setup tutorial
+
 ## Data formats
 
 ### Location
@@ -35,10 +40,10 @@ For details about the data format and the orientation of the axes, see the Movel
 
 ## Getting Started
 
-#### Installation 
-Download the [latest release](https://github.com/NeuropsyOL/SENDA/releases/latest) and install the apk on your smartphone or tablet running Android 11 or higher.
+### Installation 
+Download the [latest release](https://github.com/NeuropsyOL/SENDA/releases/latest) and install the APK on your smartphone or tablet running Android 11 or higher.
 
-#### Usage: 
+### Usage 
 Upon launching the app, the user is presented with a main screen displaying a list of available device sensors. Each sensor can be individually selected using check buttons, allowing the user to choose which data to stream. The list of sensors can be refreshed with a swipe-down gesture.
 
 Some sensors—such as audio classification and recording, GPS, and Movella sensors—require special permissions to function properly. When necessary, a permission request dialog is shown when a sensor is selected. GPS requires access to precise location at all times in order to operate correctly. If a permission is repeatedly denied, Android may block further requests. In such cases, the app opens the system settings screen, allowing the user to grant the required permission manually.
@@ -47,25 +52,25 @@ To start streaming, the user must press the **START LSL** button. To stop stream
 
 The LSL streams transmitted by SENDA can be recorded using any LSL-compatible application, such as the [LabRecorder](https://github.com/labstreaminglayer/App-LabRecorder) on PC or [RECORDA](https://github.com/NeuropsyOL/RECORDA) on Android.
 
-On newer versions of Android, it may be necessary to prevent the system from limiting the app's processing time to conserve battery. This can be done by navigating to **Settings → Battery optimization ** and disabling battery optimization for SENDA.
+On newer versions of Android, it may be necessary to prevent the system from limiting the app's processing time to conserve battery. This can be done by navigating to **Settings → Battery optimization** and disabling battery optimization for SENDA.
 
 ## Development
 
-#### Prerequisites:
-- Android Studio Giraffe | 2022.3.1 Patch 2
-- Android API 34 SDK platform
-- Android NDK 25.2.9519653
+### Prerequisites
+- Android Studio Meerkat | 2024.3.1 (or newer)
+- Android API 35 SDK platform
+- Android NDK r28 (28.0.12433566)
 - CMake 3.22.1
 
-Other version may work, the above listed versions are the ones used for development and testing.
+Other versions may work, the above listed versions are the ones used for development and testing.
 
-#### Development:
+### Development
 
 In order to start with development you need to follow these steps: 
 
-- Clone this repository
-- Open project with Android Studio
-- Import the project
+- - Clone the repository
+- - Open the project with Android Studio
+- - Import the project
 
 ## Contributing
 Please feel free to contribute to this project by creating an issue first and then sending a pull request respectively. 
@@ -76,12 +81,12 @@ Please feel free to contribute to this project by creating an issue first and th
 * **Paul Maanen** - [pmaanen](https://github.com/pmaanen)
 
 ## License
-This project is licensed under GNU General Public License License - see the [LICENSE.md](LICENSE.md) file for details
+This project is licensed under GNU General Public License - see the [LICENSE.md](LICENSE.md) file for details
 
 ## Known Issues
-- Sometimes the app complains about mission bluetooth permissions but does the scan for Movella sensors anyway.
-- On a new installation multiple restarts of the app might be necessary until it asks for and notices newly granted permissions
-- Some phones don't respect the foreground service and wakelock. A possible workaround is to set the app to unlimited background power usage in the app settings.
+- Sometimes the app reports missing Bluetooth permissions but does the scan for Movella sensors anyway.
+- After a fresh installation, multiple restarts may be required before the app detects newly granted permissions.
+- Some devices may not properly honor foreground service or wakelock settings. A potential workaround is to allow unlimited background power usage for the app in the system settings.
 
 
 ## Acknowledgments
@@ -90,4 +95,4 @@ This project is licensed under GNU General Public License License - see the [LIC
 [Google Mediapipe](https://developers.google.com/mediapipe), Apache v2.0 license.
 
 ## Cite As:
-
+- Blum S, Hölle D, Bleichner MG, Debener S. Pocketable Labs for Everyone: Synchronized Multi-Sensor Data Streaming and Recording on Smartphones with the Lab Streaming Layer. Sensors. 2021; 21(23):8135. https://doi.org/10.3390/s21238135