README_EN.md

NiuData Widget

[English] [中文]

A Scriptable widget to display and control NIU electric scooter data on your iPhone.

Usage

Install

• Get Scriptable in the Apple App Store.
• Download the NiuDataWidget.js file to your iCloud/Scriptable folder (or create a new widget in the scriptable app).
• Fill username, password, and sn in NiuDataWidget.js
  • Set password to md5(your password).
• Use the following shortcuts to enable remote control
  • ACC TOGGLE
  • ACC ON
  • ACC OFF
  • Fortification ON
  • Fortification OFF
  • Scooter INFO

var username = "";
var password = "";
var sn = "";

Optional/Advanced

• Get a map API key from MapQuest and add it to your NiuDataWidget.js file.
• If you do not want the map area, config the NiuDataWidget.js file as follows
  • var show_last_track_map = false
  • var show_map = false
• If you want the map area to display the location (requires medium size widget), config the NiuDataWidget.js file as follows
  • var show_last_track_map = false
  • var show_map = true
• If you want the map area to display the last track (requires medium size widget), config the NiuDataWidget.js file as follows
  • var show_last_track_map = true
  • var show_map = false
• Dark theme
  • Automatically switch to the dark theme when the device is using a dark appearance. Set is_dark_mode_working = false to always use white theme.

Features

This widget support:

• lockscreen widget（iOS16）
• charging overview (current charge and time until charge complete)
• locked/unlocked
• acc on/off
• GPS && GSM signal
• battery connect indicator, display centre control battery if battery disconnected
• time since the data was retreived from the car
• map location of the current position
• last track information
• Remote control

Special Thanks

Special thanks to DrieStone. This project used part of the code of TeslaData-Widget.