Skip to content

NIMMSTA App

NIMMSTA App for Android

Installing the NIMMSTA App for Android

The NIMMSTA App can be downloaded from the NIMMSTA B2B portal at the following link: NIMMSTA B2B Portal
When downloading from the B2B portal, you will receive an apk file.
tipp The following descriptions refer to Android version 13. In other versions or versions from other manufacturers, texts and details may be different - but the basic steps are the same.

Allow installation from external sources

To be able to install an app with an APK file, installation from external sources must be allowed.

Open the settings by swiping from the top of the Home screen and selecting the gear icon.

Einstellungen Android

Select the input Search settings, search for unkn and select Install unknown apps from the search hits. Then select the appropriate menu.

Einstellungen Android

Make sure that the folder in which you want to save the APK file is activated.

Einstellungen Android

Transferring the APK file

After downloading the APK file from the B2B portal, connect your Android device to your computer via USB cable.

Make sure that the APK file can be transferred to the Android end device. With Android 8 for example, select the required USB transfer type by swiping from the top of the home screen and tapping on the Android system device is charging via USB display (you may then need to tap on More options). Then select the Transfer files option in the menu.

Einstellungen Android

On the computer, you can now open the Android end device in Explorer. There, select the folder Internal shared storage. On some devices, this folder is called SD Card.

Select the download folder and copy the downloaded APK file into it.

Installation of the NIMMSTA App

Open the file manager on your Android device and change to the directory Internal shared storage/Download. There, select the APK file you just transferred to install it.

Einstellungen Android

After opening the NIMMSTA App, two authorizations are requested. The request for notification is optional, but makes working easier. You should always allow location sharing. This is required because the NIMMSTA App needs to access the Bluetooth transmission.

Einstellungen Android

Press the "Go to Accessibility Preferences" button and confirm the next query.

Einstellungen Android

Then select the NIMMSTA Scan Service from the "Installed apps" menu that opens.

Einstellungen Android

Before the NIMMSTA Scan Service can be activated, the following query must still be allowed, the status should then change from "Off" to "On".

Einstellungen Android

Depending on the android version, it may not be possible to activate the NIMMSTA Scan Service directly.

Einstellungen Android

In this case, additional steps must be carried out. The procedure for this is described in the section “Allow NIMMSTA Scan Service activation”.

After successfully activating the NIMMSTA Scan Service, press the back button on your Android device several times until you are navigated back to the NIMMSTA App. The status Enabled is now displayed for the Accessibility Service. You can now connect the NIMMSTA Smart Watch HS 50 to the Android end device by scanning the Connect QR code displayed in the app.

Einstellungen Android

Allow NIMMSTA Scan Service activation

Go to the "Apps" tab under Settings and select the NIMMSTA app:

Einstellungen Android

Click on the three dots at the top right and click "Allow restricted settings":

Einstellungen Android

The NIMMSTA Scan Service can then be activated:

Einstellungen Android

Android Permissions

The NIMMSTA App requires the following permissions to function properly.

  • Memory
  • Location
  • Accessibility Service (for automatic barcode input) - Standard App only
  • Bluetooth (for device connection)
  • Internet (for log upload and cloud features)

When using Mobile Device Management (MDM), please ensure that the NIMMSTA App receives the following Android Permissions.

Android V6 up to and including Android V11

  • android.permission.BLUETOOTH_CONNECT
  • android.permission.BLUETOOTH_PRIVILEGED
  • android.permission.INTERNET
  • android.permission.FOREGROUND_SERVICE
  • android.permission.BLUETOOTH
  • android.permission.BLUETOOTH_ADMIN
  • android.permission.ACCESS_FINE_LOCATION
  • android.permission.ACCESS_COARSE_LOCATION
  • android.permission.READ_EXTERNAL_STORAGE
  • android.permission.WRITE_EXTERNAL_STORAGE

As of Android V12 (API Level 31)

  • android.permission.BLUETOOTH_SCAN"
  • android:usesPermissionFlags="neverForLocation"
  • tools:targetApi="s"
  • android.permission.BLUETOOTH_CONNECT
  • android.permission.INTERNET
  • android.permission.FOREGROUND_SERVICE
  • android.permission.READ_EXTERNAL_STORAGE
  • android.permission.WRITE_EXTERNAL_STORAGE

Android App Variants and Integrations

Depending on the use case, various app variants are available:

Standard NIMMSTA App

  • Usage: Standard app for most use cases
  • Functions: Bluetooth LE connection, Accessibility Service for automatic barcode input
  • Android-specific: Automatically detects if the cursor is in a writable field (requires Accessibility Service)
  • Webserver & Intent Integrations: Supports webserver and intent-based integrations

NIMMSTA Intent App

  • Usage: For intent integrations
  • Advantage: No complaints about disabled Accessibility Service
  • Application: When you want to use intent-based integrations

NIMMSTA Webserver App

  • Usage: For webserver integrations
  • Advantage: No complaints about disabled Accessibility Service
  • Application: When you want to use webserver-based integrations

Enable services required for mobile device management (MDM)

If the NIMMSTA App is played out via an MDM, the following commands can be used to ensure that no authorizations have to be approved manually by the user.

Grant All Required Permissions

# Bluetooth and Location Permissions
adb shell pm grant com.nimmsta android.permission.ACCESS_FINE_LOCATION
adb shell pm grant com.nimmsta android.permission.ACCESS_COARSE_LOCATION
adb shell pm grant com.nimmsta android.permission.BLUETOOTH
adb shell pm grant com.nimmsta android.permission.BLUETOOTH_ADMIN
adb shell pm grant com.nimmsta android.permission.BLUETOOTH_CONNECT
adb shell pm grant com.nimmsta android.permission.BLUETOOTH_SCAN

# Storage Permissions
adb shell pm grant com.nimmsta android.permission.READ_EXTERNAL_STORAGE
adb shell pm grant com.nimmsta android.permission.WRITE_EXTERNAL_STORAGE

# Service Permissions
adb shell pm grant com.nimmsta android.permission.FOREGROUND_SERVICE
adb shell pm grant com.nimmsta android.permission.INTERNET

Activate Accessibility Service

# Enable the NIMMSTA Accessibility Service
adb shell settings put secure enabled_accessibility_services com.nimmsta/com.nimmsta.core.android.accessibilityservice.NimmstaAccessibilityService

# Verify the service is enabled
adb shell settings get secure enabled_accessibility_services

Complete Setup Script

For automated deployment, you can use this complete script:

#!/bin/bash
# NIMMSTA App MDM Setup Script

echo "Granting NIMMSTA App permissions..."

# Grant all required permissions
adb shell pm grant com.nimmsta android.permission.ACCESS_FINE_LOCATION
adb shell pm grant com.nimmsta android.permission.ACCESS_COARSE_LOCATION
adb shell pm grant com.nimmsta android.permission.BLUETOOTH
adb shell pm grant com.nimmsta android.permission.BLUETOOTH_ADMIN
adb shell pm grant com.nimmsta android.permission.BLUETOOTH_CONNECT
adb shell pm grant com.nimmsta android.permission.BLUETOOTH_SCAN
adb shell pm grant com.nimmsta android.permission.READ_EXTERNAL_STORAGE
adb shell pm grant com.nimmsta android.permission.WRITE_EXTERNAL_STORAGE
adb shell pm grant com.nimmsta android.permission.FOREGROUND_SERVICE
adb shell pm grant com.nimmsta android.permission.INTERNET

echo "Activating Accessibility Service..."

# Enable Accessibility Service
adb shell settings put secure enabled_accessibility_services com.nimmsta/com.nimmsta.core.android.accessibilityservice.NimmstaAccessibilityService

echo "Verifying setup..."

# Verify permissions
adb shell dumpsys package com.nimmsta | grep permission

# Verify accessibility service
adb shell settings get secure enabled_accessibility_services

echo "NIMMSTA App setup complete!"

Troubleshooting ADB Commands

If you encounter issues, use these commands to troubleshoot:

# Check if NIMMSTA app is installed
adb shell pm list packages | grep nimmsta

# Check current permissions
adb shell dumpsys package com.nimmsta | grep permission

# Check accessibility services status
adb shell settings get secure enabled_accessibility_services

# Reset accessibility services (if needed)
adb shell settings put secure enabled_accessibility_services ""

# Re-enable accessibility service
adb shell settings put secure enabled_accessibility_services com.nimmsta/com.nimmsta.core.android.accessibilityservice.NimmstaAccessibilityService
tipp Make sure USB debugging is enabled on the Android device before running ADB commands.
warning IMPORTANT: These commands require the device to be in developer mode with USB debugging enabled.

NIMMSTA App for Windows

System requirements

  • Windows 10 or higher
  • BLE 4.2 compatible Bluetooth-Module with Windows 10 Fall Creators Update or later (Build 1709, Released 17.10.2017)
  • 2-Core CPU
  • 4 GB RAM
  • 2 GB HDD
  • At least Java Version 8+

If Java is not installed correctly or an outdated version is installed, the following error message may appear:

Error no Java installed

In this case, the correct version must be installed.

Installation Java

Java can be downloaded from the following link: Java JDK / JRE For java, you can either install JDK, or JRE (JRE is recommended).
Java JDK 17+
Java JRE

Java Installation

To setup the Java properly, you have to add Java to the system environment variable path, for doing it you can follow the instruction:

Java Installation

In the "Advanced" tab, select the "Environment variable" button:

Java Installation

Select the "Path" variable and then click the "Edit" button:

Java Installation

The variables marked in red in the following illustration must be present. If necessary, add them by clicking the "New" button.

Java Installation

Use the command prompt (cmd) or PowerShell to make sure that Java is installed and working properly. The following display should then appear:

Java Installation

Download NIMMSTA App

The NIMMSTA App can be downloaded from the NIMMSTA B2B portal. When downloading from the B2B portal, you will receive an EXE file. The EXE file can be downloaded from the NIMMSTA B2B portal at the following link:
NIMMSTA B2B Portal
tipp Note: If you are using the Edge browser, you may see a warning message after the download. To save the download, select the three dots and then select Keep. In the window that opens, select Keep anyway.

Install NIMMSTA App

The following descriptions refer to Windows 10 with Java already installed.

  • Start the installation
  • During the installation, the program for installing the required drivers is also called. Please install them as well.
Windows App
  • After the installation is complete, you can choose whether the NIMMSTA app should be started directly. Please do not start the NIMMSTA app immediately after installation.
Windows App
  • To ensure correct operation of the app, restart the operating system and then the NIMMSTA app.

Use NIMMSTA App

  • The following step is only necessary if your terminal does not have a BLE 4.2 compatible Bluetooth module:
    Connect the NIMMSTA Bluetooth dongle to the Windows computer.
Windows App
  • The NIMMSTA app can be opened using the Start menu entry or the desktop icon.
  • As soon as the NIMMSTA application is started, the Connect screen is displayed.
Windows App

FAQ Windows App

No desktop icon is created

This may occur if a separate administrator account is used for the installation. In this case, the desktop shortcut can be created manually. To do this, create a shortcut to the following file:
C:\Program Files\NIMMSTA Windows Client\NIMMSTA Windows Client.exe
Or rather
<Zielverzeichnis>\NIMMSTA Windows Client.exe

Perform firmware update

Download the firmware upgrade in the NIMMSTA B2B Portal.

Transfer the file to the Android or Windows device.

Open the NIMMSTA App, connect the Smart Watch HS 50 that is to be upgraded and select the Smart Watch HS 50 icon. Note: From NIMMSTA App V6 on you will find the menu item in the right menu 'More'.

Android App

Select Software Upgrade

Android App

Use NIMMSTA App V6 or newer, select the NIMMSTA HS50 to be updated

Android App

Select the update file and then start the upgrade process

Android App

A preselection of the upgrade artifacts to be transferred is made by the app. You can adjust this if necessary. The app guides you through the correct update sequence when updating from firmware bundle V4 to V5!

Android App

After confirming the upgrade artifacts with Next, you will get an overview below and can start the upgrade process.

Android App

While the update is being transferred, the NIMMSTA App can be minimized and work with the Smart Watch HS 50 can continue as usual. When the transfer is complete, the connection to the Smart Watch HS 50 must be interrupted for the upgrade to be installed. A corresponding button is displayed in the NIMMSTA App after successful transfer.

Android App

Using Multi Device Connection

From the NIMMSTA App version V6 (Android & Windows) you have the possibility to connect up to six Smart Watches HS 50 at the same time with one end device. This is called Multi Device Connection.

Enable/disable Multi Device Connection

Select More -> Device Settings -> Multi Device Connection to turn the option on or off.

Android App

Reserved Devices

If you have connected a NIMMSTA HS50 with Multi Device Connection enabled, a connection slot is reserved for this device. This restores the connection in case of a connection loss. If you want to clear the list of reserved device, select Devices -> View All -> Clear Reserved

Android App

Ping devices

To be able to identify a device, you can ping it. To do this, select the NIMMSTA HS50 to be pinged from the list of devices under Devices -> View All -> Ping devices.

Android App

Log-File creation and upload

You can create log files and send them directly to NIMMSTA support.

Log-File upload

To send log files directly from the app to NIMMSTA support:

  1. Open the NIMMSTA App
  2. Navigate to More -> Logs
  3. Press the "Upload" button
  4. The file is automatically transferred to NIMMSTA via https://backend.cloud.nimmsta.com/
tipp Log files are only stored as long as they are needed for troubleshooting (GDPR compliant).

Log-File creation

NIMMSTA App for Android

To create a log file, select More -> File Logs. The log file will then be created. Now you can either copy the generated file into the download directory (Download button), share the file (Share button) or copy the path to the generated file (Copy path button).

Android App

NIMMSTA App for Windows

To create a log file, select More -> File Logs. You can either copy the log file to the download directory (Download button) or copy the path to the generated file (Copy path button).

Win App Log

Log-File Storage Locations

If you don't want to upload the log file directly from the app, you can also create it manually and send it to NIMMSTA support.

Android

  • Standard storage location: /Android/data/com.nimmsta/files/logs/
  • Download folder: /Download/ (after export)

Windows

  • Standard storage location: %TEMP%\nimmsta-jvm\
  • Download folder: %USERPROFILE%\Downloads\ (after export)

Windows Service (advanced information)

For Windows Services, the %TEMP% path varies depending on the user context:

Service Context %TEMP% Path
Standard User C:\Users\<USERNAME>\AppData\Local\Temp
LocalSystem C:\Windows\Temp
NetworkService C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp
LocalService C:\Windows\ServiceProfiles\LocalService\AppData\Local\Temp
Custom Follows the user profile

Checking the current TEMP path: - Command prompt: echo %TEMP% - PowerShell: [System.IO.Path]::GetTempPath()