https://github.com/skodaconnect/myskoda
Python library for interacting with MySkoda APIs.
https://github.com/skodaconnect/myskoda
mqtt myskoda python3 rest
Last synced: 20 days ago
JSON representation
Python library for interacting with MySkoda APIs.
- Host: GitHub
- URL: https://github.com/skodaconnect/myskoda
- Owner: skodaconnect
- License: mit
- Created: 2024-09-12T19:28:39.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-04-10T19:12:20.000Z (24 days ago)
- Last Synced: 2025-04-10T20:39:14.503Z (24 days ago)
- Topics: mqtt, myskoda, python3, rest
- Language: Python
- Homepage:
- Size: 1.44 MB
- Stars: 23
- Watchers: 2
- Forks: 33
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/skodaconnect/myskoda/releases)
[](https://pypi.org/project/myskoda/)
[](https://pypi.org/project/myskoda/)
[](https://myskoda.readthedocs.io/en/latest/)
[](https://discord.gg/t7az2hSJXq)
[](https://coveralls.io/github/skodaconnect/myskoda)
# MySkoda
MySkoda is an async Python library to interact with the Skoda API.
MySkoda is primarily developed to be used by the https://github.com/skodaconnect/homeassistant-myskoda project, a Home Assistant integration for Skoda vehicles.
Before updating please review the [release notes](https://github.com/skodaconnect/myskoda/releases).
- [MySkoda](#myskoda)
- [Get In Touch](#get-in-touch)
- [Quick Start](#quick-start)
- [Basic example](#basic-example)
- [Documentation](#documentation)
- [As Library](#as-library)
- [As CLI](#as-cli)
- [Contribute your Fixtures](#contribute-your-fixtures)
- [Disclaimer](#disclaimer)
## Get In Touch
We have an active community in our discord. [Feel free to join](https://discord.gg/t7az2hSJXq).
If you have any issues, please report them in our issue tracker.
## Quick Start
The MySkoda package is published to Pypi and can be found [here](https://pypi.org/project/myskoda/).
It can be installed the usual way:
```sh
pip install myskoda
```
### Basic example
```python
import asyncio
from aiohttp import ClientSession
from myskoda import MySkoda
USERNAME = "[email protected]"
PASSWORD = "my_password"
async def main():
async with ClientSession() as session:
myskoda = MySkoda(session)
await myskoda.connect(USERNAME, PASSWORD)
for vin in await myskoda.list_vehicle_vins():
print(vin)
myskoda.disconnect()
asyncio.run(main())
```
## Documentation
Detailed documentation [is available at read the docs](https://myskoda.readthedocs.io/en/latest/):
* [Fetching Data](https://myskoda.readthedocs.io/en/latest/fetching_data/)
* [Subscribing to Events](https://myskoda.readthedocs.io/en/latest/events/)
* [Primer](https://myskoda.readthedocs.io/en/latest/primer/)
## As Library
MySkoda relies on [aiohttp](https://pypi.org/project/aiohttp/) which must be installed.
A `ClientSession` must be opened and passed to `MySkoda` upon initialization.
After connecting, operations can be performed, events can be subscribed to and data can be loaded from the API.
Don't forget to close the session and disconnect MySkoda after you're done.
## As CLI
The MySkoda package features a CLI.
You will have to install it with extras `cli`:
```sh
pip install "myskoda[cli]"
```
Afterwards, the CLI is available in your current environment by invoking `myskoda`.
Username and password must be provided to the CLI for every request as options, before selecting a sub command:
```sh
myskoda --user "[email protected]" --password "super secret" list-vehicles
```
Help can be accessed the usual way:
```sh
myskoda --help
```
## Contribute your Fixtures
Please contribute fixtures for our tests by running this command:
```sh
# Export all endpoints for all vehicles.
myskoda \
--user user \
--password password \
gen-fixtures \
--name my_cars \
--description "My cars in no specific state."
--vehicle all \
get all
```
It is also possible to just contribute a single vehicle:
```sh
# Export all endpoints for a specific vehicle.
myskoda \
--user user \
--password password \
gen-fixtures \
--name my_favorite_car \
--description "My favorite car in no specific state."
--vehicle TMOCKAA0AA000000 \
get all
```
Or even narrow down to an inidividual endpoint for an individual vehicle:
```sh
# Export a specific endpoint for a specific vehicle.
myskoda \
--user user \
--password password \
gen-fixtures \
--name my_favorite_car_info \
--description "Info for my favorite car in no specific state."
--vehicle TMOCKAA0AA000000 \
get info
```
This will call all the selected get-routes and load all data from your vehicles (no actions will be performed).
The data will be anonymized (vin and personal data are replaced) and serves as unit tests.
Please create a pull request with the resulting data to help us cover more vehicles.
## Disclaimer
This project is an unofficial API client for the Skoda API and is not affiliated with, endorsed by, or associated with Skoda Auto or any of its subsidiaries.
Use this project at your own risk. Skoda Auto may update or modify its API without notice, which could render this client inoperative or non-compliant. The maintainers of this project are not responsible for any misuse, legal implications, or damages arising from its use.
Ensure compliance with Skoda Auto's terms of service and any applicable laws when using this software.