Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
PiotrMachowski committed Jan 23, 2022
1 parent b4de663 commit 6024b91
Show file tree
Hide file tree
Showing 4 changed files with 43 additions and 9 deletions.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2020 Piotr Machowski
Copyright (c) 2022 Piotr Machowski

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
45 changes: 38 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,28 @@
# MPK Kraków sensor
[![HACS Custom][hacs_shield]][hacs]
[![GitHub Latest Release][releases_shield]][latest_release]
[![GitHub All Releases][downloads_total_shield]][releases]
[![Buy me a coffee][buy_me_a_coffee_shield]][buy_me_a_coffee]
[![PayPal.Me][paypal_me_shield]][paypal_me]


[hacs_shield]: https://img.shields.io/static/v1.svg?label=HACS&message=Custom&style=popout&color=orange&labelColor=41bdf5&logo=HomeAssistantCommunityStore&logoColor=white
[hacs]: https://hacs.xyz/docs/faq/custom_repositories

[latest_release]: https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/releases/latest
[releases_shield]: https://img.shields.io/github/release/PiotrMachowski/Home-Assistant-custom-components-MPK-KR.svg?style=popout

[releases]: https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/releases
[downloads_total_shield]: https://img.shields.io/github/downloads/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/total

[buy_me_a_coffee_shield]: https://img.shields.io/static/v1.svg?label=%20&message=Buy%20me%20a%20coffee&color=6f4e37&logo=buy%20me%20a%20coffee&logoColor=white
[buy_me_a_coffee]: https://www.buymeacoffee.com/PiotrMachowski

[![buymeacoffee_badge](https://img.shields.io/badge/Donate-Buy%20Me%20a%20Coffee-ff813f?style=flat)](https://www.buymeacoffee.com/PiotrMachowski)
[![paypalme_badge](https://img.shields.io/badge/Donate-PayPal-0070ba?style=flat)](https://paypal.me/PiMachowski)
[paypal_me_shield]: https://img.shields.io/static/v1.svg?label=%20&message=PayPal.Me&logo=paypal
[paypal_me]: https://paypal.me/PiMachowski

This sensor use official API provided by MPK Kraków.
# MPK Kraków sensor

This sensor uses official API provided by MPK Kraków.

## Configuration options

Expand Down Expand Up @@ -42,12 +61,23 @@ sensor:

## Installation

Download [*sensor.py*](https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/raw/master/custom_components/mpk_kr/sensor.py) and [*manifest.json*](https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/raw/master/custom_components/mpk_kr/manifest.json) to `config/custom_components/mpk_kr` directory:
### Using [HACS](https://hacs.xyz/) (recommended)

This integration can be added to HACS as a [custom repository](https://hacs.xyz/docs/faq/custom_repositories):
* URL: `https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR`
* Category: `Integration`

After adding a custom repository you can use HACS to install this integration using user interface.

### Manual

To install this integration manually you have to download [*mpk_kr.zip*](https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/releases/latest/download/mpk_kr.zip) extract its contents to `config/custom_components/mpk_kr` directory:
```bash
mkdir -p custom_components/mpk_kr
cd custom_components/mpk_kr
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/raw/master/custom_components/mpk_kr/sensor.py
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/raw/master/custom_components/mpk_kr/manifest.json
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/releases/latest/download/mpk_kr.zip
unzip mpk_kr.zip
rm mpk_kr.zip
```

## Hints
Expand Down Expand Up @@ -78,3 +108,4 @@ wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/r
```

<a href="https://www.buymeacoffee.com/PiotrMachowski" target="_blank"><img src="https://bmc-cdn.nyc3.digitaloceanspaces.com/BMC-button-images/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: auto !important;width: auto !important;" ></a>
<a href="https://paypal.me/PiMachowski" target="_blank"><img src="https://www.paypalobjects.com/webstatic/mktg/logo/pp_cc_mark_37x23.jpg" border="0" alt="PayPal Logo" style="height: auto !important;width: auto !important;"></a>
1 change: 1 addition & 0 deletions custom_components/mpk_kr/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""MPK Kraków"""
4 changes: 3 additions & 1 deletion custom_components/mpk_kr/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,10 @@
"domain": "mpk_kr",
"name": "MPK KR",
"documentation": "https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR",
"issue_tracker": "https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-KR/issues",
"dependencies": [],
"codeowners": ["@PiotrMachowski"],
"requirements": ["requests"],
"version": "v1.0.1"
"version": "v1.0.2",
"iot_class": "cloud_polling"
}

0 comments on commit 6024b91

Please sign in to comment.