Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
PiotrMachowski committed Jan 24, 2022
1 parent 4c8c14c commit c0b28d2
Show file tree
Hide file tree
Showing 4 changed files with 42 additions and 8 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
43 changes: 37 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,26 @@
# MPK Rzeszó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-Rzeszow/releases/latest
[releases_shield]: https://img.shields.io/github/release/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow.svg?style=popout

[releases]: https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/releases
[downloads_total_shield]: https://img.shields.io/github/downloads/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/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

# MPK Rzeszów sensor

This sensor use unofficial API provided by MPK Rzeszów.

Expand Down Expand Up @@ -38,12 +57,23 @@ sensor:

## Installation

Download [*sensor.py*](https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/raw/master/custom_components/mpk_rzeszow/sensor.py) and [*manifest.json*](https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/raw/master/custom_components/mpk_rzeszow/manifest.json) to `config/custom_components/mpk_rzeszow` 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-Rzeszow`
* 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_rzeszow.zip*](https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/releases/latest/download/mpk_rzeszow.zip) extract its contents to `config/custom_components/mpk_rzeszow` directory:
```bash
mkdir -p custom_components/mpk_rzeszow
cd custom_components/mpk_rzeszow
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/raw/master/custom_components/mpk_rzeszow/sensor.py
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/raw/master/custom_components/mpk_rzeszow/manifest.json
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/releases/latest/download/mpk_rzeszow.zip
unzip mpk_rzeszow.zip
rm mpk_rzeszow.zip
```

## Hints
Expand Down Expand Up @@ -74,3 +104,4 @@ wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzes
```

<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_rzeszow/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""MPK Rzeszów"""
4 changes: 3 additions & 1 deletion custom_components/mpk_rzeszow/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,10 @@
"domain": "mpk_rzeszow",
"name": "MPK Rzeszów",
"documentation": "https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow",
"issue_tracker": "https://github.com/PiotrMachowski/Home-Assistant-custom-components-MPK-Rzeszow/issues",
"dependencies": [],
"codeowners": ["@PiotrMachowski"],
"requirements": ["requests"],
"version": "v1.0.1"
"version": "v1.0.2",
"iot_class": "cloud_polling"
}

0 comments on commit c0b28d2

Please sign in to comment.