Code Maintainers Wanted
I no longer have a Kia or Hyundai so don’t maintain this like I used to. Others who are interested in jumping in are welcome to join the project! Even just pull requests are appreciated!
Introduction
This is a Kia UVO, Hyundai Bluelink, Genesis Connect(Canada Only) written in python. It is primary consumed by home assistant. If you are looking for a home assistant Kia / Hyundai implementation please look here: https://github.com/Hyundai-Kia-Connect/kia_uvo. Much of this base code came from reading bluelinky and contributions to the kia_uvo home assistant project.
Chat on discord::
API Usage
This package is designed to simplify the complexity of using multiple regions. It attempts to standardize the usage regardless of what brand or region the car is in. That isn’t always possible though, in particular some features differ from one to the next.
Europe Hyundai and Kia login logic is based on the bluelink-refresh-token project. Username/password login is supported directly for Kia, Hyundai, and Genesis (EU) — no browser or manual token extraction needed. The pycryptodome package (included as a dependency) is used for RSA password encryption during the EU login flow.
Python 3.12 or newer is required to use this package. Vehicle manager is the key class that is called to manage the vehicle lists. One vehicle manager should be used per login. Key data points required to instantiate vehicle manager are:
region: int brand: int, username: str password: str pin: str (required for CA, and potentially USA, otherwise pass a blank string) Optional parameters are:: geocode_api_enable: bool geocode_api_use_email: bool geocode_provider: int geocode_api_key: str language: str
Key values for the int exist in the const.py file as:
REGIONS = {1: REGION_EUROPE, 2: REGION_CANADA, 3: REGION_USA, 4: REGION_CHINA, 5: REGION_AUSTRALIA, 6: REGION_INDIA, 7: REGION_NZ, 8: REGION_BRAZIL}
BRANDS = {1: BRAND_KIA, 2: BRAND_HYUNDAI, 3: BRAND_GENESIS}
GEO_LOCATION_PROVIDERS = {1: OPENSTREETMAP, 2: GOOGLE}
Once this is done you can now make the following calls against the vehicle manager:
#login login(self) #OTP Details #Sent OTP send_otp(self, method) #Verify OTP verify_otp(self, otp_code) #Checks the token is still valid and updates it if not. Should be called before anything else if the code has been running for any length of time. check_and_refresh_token(self) Ideal refresh command. Checks if the car has been updated since the time in seconds provided. If so does a cached update. If not force calls the car. check_and_force_update_vehicles(self, force_refresh_interval) # Interval in seconds - consider API Rate Limits https://github.com/Hacksore/bluelinky/wiki/API-Rate-Limits Used to return a specific vehicle object: get_vehicle(self, vehicle_id) #Updates all cars with what is cached in the cloud: update_all_vehicles_with_cached_state(self) Updates a specific car with cached state: update_vehicle_with_cached_state(self, vehicle_id) Force refreshes all cars: force_refresh_all_vehicles_states(self) Force refreshes a single car: force_refresh_vehicles_states(self, vehicle_id)
An example call would be:
from hyundai_kia_connect_api import * vm = VehicleManager(region=2, brand=1, username="username@gmail.com", password="password", pin="1234") vm.check_and_refresh_token() vm.update_all_vehicles_with_cached_state() print(vm.vehicles)
If geolocation is required you can also allow this by running:
vm = VehicleManager(region=2, brand=1, username="username@gmail.com", password="password", pin="1234", geocode_api_enable=True, geocode_api_use_email=True)
This will populate the address of the vehicle in the vehicle instance.
The Bluelink App is reset to English for users who have set another language in the Bluelink App in Europe when using hyundai_kia_connect_api. To avoid this, you can pass the optional parameter language (default is “en”) to the constructor of VehicleManager, e.g. for Dutch:
vm = VehicleManager(region=2, brand=1, username="username@gmail.com", password="password", pin="1234", language="nl")
Note: this is only implemented for Europe currently.
For a list of language codes, see here: https://www.science.co.il/language/Codes.php. Currently in Europe the Bluelink App shows the following languages:
- "en" English - "de" German - "fr" French - "it" Italian - "es" Spanish - "sv" Swedish - "nl" Dutch - "no" Norwegian - "cs" Czech - "sk" Slovak - "hu" Hungarian - "da" Danish - "pl" Polish - "fi" Finnish - "pt" Portuguese
In Europe and some other regions also trip info can be retrieved. For a month you can ask the days with trips. And you can ask for a specific day for all the trips of that specific day.:: - First call vm.update_month_trip_info(vehicle.id, yyyymm) before getting vehicle.month_trip_info for that month - First call vm.update_day_trip_info(vehicle.id, day.yyyymmdd) before getting vehicle.day_trip_info for that day
Example of getting trip info of the current month and day (vm is VehicleManager instance):
now = datetime.now()
yyyymm = now.strftime("%Y%m")
yyyymmdd = now.strftime("%Y%m%d")
vm.update_month_trip_info(vehicle.id, yyyymm)
if vehicle.month_trip_info is not None:
for day in vehicle.month_trip_info.day_list: # ordered on day
if yyyymmdd == day.yyyymmdd: # in example only interested in current day
vm.update_day_trip_info(vehicle.id, day.yyyymmdd)
if vehicle.day_trip_info is not None:
for trip in reversed(vehicle.day_trip_info.trip_list): # show oldest first
print(f"{day.yyyymmdd},{trip.hhmmss},{trip.drive_time},{trip.idle_time},{trip.distance},{trip.avg_speed},{trip.max_speed}")
CLI Usage
A tool bluelink is provided that enable querying the vehicles and save the state to a JSON file. Example usage:
bluelink --region Canada --brand Hyundai --username FOO --password BAR --pin 1234 info --json infos.json
Environment variables BLUELINK_XXX can be used to provide a default value for the corresponding –xxx argument.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hyundai_kia_connect_api-4.27.1.tar.gz.
File metadata
- Download URL: hyundai_kia_connect_api-4.27.1.tar.gz
- Upload date:
- Size: 198.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c90ccb4bec1c95448384a1804a04d4fa4a9a5e61a399f2864c23d2aff35bcfb
|
|
| MD5 |
af95cbf646fd768e6752285490426b30
|
|
| BLAKE2b-256 |
905a555c250ac2ef08189100c30c0157a161f3ff0902083f23de9f28ac700cad
|
File details
Details for the file hyundai_kia_connect_api-4.27.1-py3-none-any.whl.
File metadata
- Download URL: hyundai_kia_connect_api-4.27.1-py3-none-any.whl
- Upload date:
- Size: 122.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4d96e51dec36c602154ab01b5c215385c92097f89c3376631fd23f9fe7a5c04
|
|
| MD5 |
8ff420f1f386ac21a7d81d4a656b8615
|
|
| BLAKE2b-256 |
f3bebe66400e521b87c50d142b68f0ef2a3f5b801733850b9e454e36076fccc2
|
