stromer-api 2.0.4

Stromer API

This Python package contains the interfaces for interacting with the Stromer web API that is normally used by the Stromer mobile app. Using this API you can retrieve data of your bike. This is the most complete and simple to use package to connect to your Stromer Bike without the need to use the mobile app. On top of that it offers features that the app does not provide (including downloading of data).

Installation:

pip install -r requirements.txt
pip install stromer_api

Usage:

from stromer_api import StromerBike
mybike = StromerBike(<your username>, <your password>, <stromer client id>)

# access available data easily
print(mybike.state.trip_distance)
print(mybike.position.latitude)

# modify bike sensors
mybike.sensors.user_torque_sensitivity = 10

# Export data to excel
mybike.week_stats(2022,1,52).excel_dump("exported_data")

The client_id you should intercept using a proxy (eg. mitm proxy) or maybe it can be obtained from decompiling the android apk of the Stromer OMNI app. Many discussions can be found on the internet how to get hold of it.

The following properties can be accessed.

StromerBike class - getters:

• mybike.bikeid (int)
• mybike.nickname (str)
• mybike.bikemodel (str)
• mybike.biketype (str)
• mybike.color (str)
• mybike.size (str)
• mybike.hardware (str)
• mybike.connectivity (str)
• mybike.has_crash_detection (bool)

StromerBike class - setters:

• mybike.reset_trip_data()
• mybike.lock()
• mybike.unlock()
• mybike.light("on" | "off" | "flash" )

BikeMaintenance class:

• mybike.maintenance_feature (BikeMaintenance)
• mybike.maintenance_feature.display_maintenance_event
• mybike.maintenance_feature.next_maintenance_km
• mybike.maintenance_feature.next_maintenance_date
• mybike.maintenance_feature.next_maintenance_interval
• mybike.maintenance_feature.customer_enabled_maintenance
• mybike.maintenance_feature.last_maintenance_reset_km
• mybike.maintenance_feature.last_maintenance_reset_date

BikeState class:

• mybike.state (BikeState)
• mybike.state.trip_distance (float)
• mybike.state.suiversion (str)
• mybike.state.average_speed_trip (float)
• mybike.state.power_on_cycles (int)
• mybike.state.tntversion (str)
• mybike.state.atmospheric_pressure (int)
• mybike.state.battery_SOC (int)
• mybike.state.assistance_level (int)
• mybike.state.bike_speed (float)
• mybike.state.trip_time (int)
• mybike.state.trip_time_str (str)
• mybike.state.battery_health (int)
• mybike.state.theft_flag (bool)
• mybike.state.motor_temp (float)
• mybike.state.battery_temp (float)
• mybike.state.rcvts (int)
• mybike.state.rcvts_str (str)
• mybike.state.average_energy_consumption (int)
• mybike.state.total_time (int)
• mybike.state.total_time (str)
• mybike.state.total_distance (float)
• mybike.state.light_on (int)
• mybike.state.total_energy_consumption (int)
• mybike.state.lock_flag (bool)

BikePosition class:

• mybike.position (BikePosition)
• mybike.position.latitude (float)
• mybike.position.longitude (float)
• mybike.position.altitude (int)
• mybike.position.speed (float)
• mybike.position.timets (int)
• mybike.position.timets_str (str)
• mybike.position.rcvts (int)
• mybike.position.rcvts_str (str)

BikeStatistics class:

• mybike.statistics (BikeStatistics)
• mybike.statistics.total_km (float)
• mybike.statistics.average_km (float)
• mybike.statistics.total_sec (int)
• mybike.statistics.total_time_str (str)
• mybike.statistics.average_sec (float)
• mybike.statistics.average_time_str (str)
• mybike.statistics.total_wh (int)
• mybike.statistics.average_wh (float)
• mybike.statistics.kmh (float)
• mybike.statistics.average_kmh (float)
• mybike.statistics.active_days (int)
• mybike.statistics.average_days (float)

BikeSensors class - getters:

• mybike.sensors (BikeSensors)
• mybike.sensors.user_torque_sensitivity (int)
• mybike.sensors.recup_level_user_offset (int)

BikeSensors class - setters:

• mybike.sensors.user_torque_sensitivity = <torque (int)>
• mybike.sensors.recup_level_user_offset = <recup (int)>
• mybike.sensors.set(<torque (int)>, <recup (int)>)

BikeMotorTuning class - getters:

• mybike.motor_tuning (BikeMotroTuning)
• mybike.motor_tuning.tuning_speed (int)
• mybike.motor_tuning.tuning_torque (int)
• mybike.motor_tuning.tuning_agility (int)
• mybike.motor_tuning.tuning_speed = <speed (int)>
• mybike.motor_tuning.tuning_torque = <torque (int)>
• mybike.motor_tuning.tuning_agility = <agility (int)>
• mybike.motor_tuning.set(<speed (int)>, <torque (int)>, <agility (int)>)

BikeSettings class - getters:

• mybike.settings (BikeSettings)
• mybike.settings.auto_lock_mode (bool)
• mybike.settings.auto_power_off_time (int)
• mybike.settings.clock_format (str)
• mybike.settings.date_format (str)
• mybike.settings.distance_unit (str)
• mybike.settings.language (str)
• mybike.settings.speed_unit (str)

BikeSettings class - setters:

• mybike.settings.auto_lock_mode = <mode (bool)>
• mybike.settings.auto_power_off_time = <time (int)>
• mybike.settings.clock_format = <format (str)>
• mybike.settings.date_format = <format (str)>
• mybike.settings.distance_unit = <unit (str)>
• mybike.settings.language = <language(str)>
• mybike.settings.speed_unit = <unit (str)>
• mybike.settings.set(<auto_lock_mode (bool)>, <auto_power_off_time (int)>, <clock_format (str)>, <date_format (str)>, <distance_unit (str)>, <language (str)>, <speed_unit (str)>)

BikeUser class:

• mybike.user (BikeUser)
• mybike.user.first_name (str)
• mybike.user.last_name (str)
• mybike.user.street_name (str)
• mybike.user.house_number (str)
• mybike.user.postal_code (str)
• mybike.user.city (str)
• mybike.user.country (str)
• mybike.user.phone (str)
• mybike.user.mobile (str)
• mybike.user.email (str)
• mybike.user.gender (str)
• mybike.user.size (float)
• mybike.user.weight (float)
• mybike.user.accepted_gdpr_version (str)
• mybike.user.may_receive_mails (bool)

BikeShop class:

• mybike.user.shop (BikeShop)
• mybike.user.shop.name (str)
• mybike.user.shop.street (str)
• mybike.user.shop.postal_code (str)
• mybike.user.shop.city (str)
• mybike.user.shop.country_code (str)
• mybike.user.shop.country_name (str)
• mybike.user.shop.phone (str)
• mybike.user.shop.latitude (float)
• mybike.user.shop.longitude (float)
• mybike.user.shop.debitor (float)

ServiceInfo class:

• mybike.service_info (ServiceInfo)
• mybike.service_info.shop (BikeShop)
• mybike.service_info.vin (str)
• mybike.service_info.serial (str)
• mybike.service_info.service_logs ([ServiceLog)]
• mybike.service_info.bike_parts ([BikePart)]

ServiceLog class:

• mybike.service_info.service_logs[] (ServiceLog)
• mybike.service_info.service_logs[].note (str)
• mybike.service_info.service_logs[].created_on (int)

BikePart class:

• mybike.service_info.bike_parts[] (BikePart)
• mybike.service_info.bike_parts[].serial (str)
• mybike.service_info.bike_parts[].name (str)
• mybike.service_info.bike_parts[].category (str)

BikeShopList class:

• mybike.shops.lookup(<part of shopname (str)>) (BikeShop)
• mybike.shops[i] (BikeShop)

YearStats class:

• mybike.year_stats(year (int), num_years (int)) (YearStats)
• mybike.year_stats(year (int), num_years (int)).start_date (str)
• mybike.year_stats(year (int), num_years (int)).end_date (str)
• mybike.year_stats(year (int), num_years (int)).total_years (int)
• mybike.year_stats(year (int), num_years (int)).km_avg_years_since_beginning (float)
• mybike.year_stats(year (int), num_years (int)).year_record (float)
• mybike.year_stats(year (int), num_years (int)).csv_dump()
• mybike.year_stats(year (int), num_years (int)).excel_dump()
• mybike.year_stats(year (int), num_years (int))[year (str)] (PeriodicInfo)

MonthStats class:

• mybike.month_stats(year (int), month (int), num_months (int)) (MonthStats)
• mybike.month_stats(year (int), month (int), num_months (int)).start_date (str)
• mybike.month_stats(year (int), month (int), num_months (int)).end_date (str)
• mybike.month_stats(year (int), month (int), num_months (int)).total_months (int)
• mybike.month_stats(year (int), month (int), num_months (int)).km_avg_12_months (float)
• mybike.month_stats(year (int), month (int), num_months (int)).month_record (float)
• mybike.monthg_stats(year (int), month (int), num_months (int)).csv_dump()
• mybike.monthg_stats(year (int), month (int), num_months (int)).excel_dump()
• mybike.monthg_stats(year (int), month (int), num_months (int))[month (str)] (PeriodicInfo)

WeekStats class:

• mybike.week_stats(year (int), week (int), num_weeks (int)) (WeekStats)
• mybike.week_stats(year (int), week (int), num_weeks (int)).start_date (str)
• mybike.week_stats(year (int), week (int), num_weeks (int)).end_date (str)
• mybike.week_stats(year (int), week (int), num_weeks (int)).total_weeks (int)
• mybike.week_stats(year (int), week (int), num_weeks (int)).km_avg_12_weeks (float)
• mybike.week_stats(year (int), week (int), num_weeks (int)).week_record (float)
• mybike.week_stats(year (int), week (int), num_weeks (int)).csv_dump()
• mybike.week_stats(year (int), week (int), num_weeks (int)).excel_dump()
• mybike.week_stats(year (int), week (int), num_weeks (int)).[week (str)] (PeriodicInfo)

DayStats class:

• mybike.day_stats(year (int), month (int), day (int), num_days (int)) (DayStats)
• mybike.day_stats(year (int), month (int), day (int), num_days (int)).start_date (str)
• mybike.day_stats(year (int), month (int), day (int), num_days (int)).end_date (str)
• mybike.day_stats(year (int), month (int), day (int), num_days (int)).total_days (int)
• mybike.day_stats(year (int), month (int), day (int), num_days (int)).km_avg_30_days (float)
• mybike.day_stats(year (int), month (int), day (int), num_days (int)).day_record (float)
• mybike.day_stats(year (int), month (int), day (int), num_days (int)).csv_dump()
• mybike.day_stats(year (int), month (int), day (int), num_days (int)).excel_dump()
• mybike.day_stats(year (int), month (int), day (int), num_days (int))[day (str)] (PeriodicInfo)

Any suggestions for additions are of course also very welcome!