nymea/README.md

84 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# nymea - open source IoT edge server
--------------------------------------------
<p align="center">
<a src='https://nymea.io'>
<img src="https://nymea.io/app/default/assets/addons/default/guh/default-theme/resources/img/nymea-logo.svg" width=300 />
</a>
</p>
nymea (/[n'aiːmea:]/ - is an open source IoT edge server. The plug-in based architecture allows to integrate protocols, APIs and . With the build-in rule engine you are able to interconnect devices or services available in the system and create individual scenes and behaviours for your environment.
## Quick Install on Ubuntu
<img src="https://nymea.io/app/default/assets/addons/default/guh/default-theme/resources/img/nymea-ubuntu.svg" width=300 >
In order to install nymea on Ubuntu, you simply need to download this bash script:
```
wget https://downloads.nymea.io/install-nymea.sh
```
Extract into your Home folder and just run
```
chmod +x install-nymea.sh
sudo ./install-nymea.sh
```
Once the success message has printed on your screen, simply run: *sudo nymead -n* to start nymea!
## Quick Install on a Raspberry Pi
<img src="https://nymea.io/app/default/assets/addons/default/guh/default-theme/resources/img/nymea-pi.svg" width=300 >
We have created an image for your Raspberry Pi (2/3) that comes with an array of plugins for different smart devices!
[Download .zip](https://downloads.nymea.io/images/rpi3/nymea-debian-stretch-9-armhf-raspberry-pi-3.zip)
## Get the nymea mobile app here:
<p align="center">
<img src="https://nymea.io/app/default/assets/addons/default/guh/default-theme/resources/img/community/app-shots/ios-app.png" width=300 />
</p>
<table width:100%>
<tr>
<td> <a href="https://itunes.apple.com/us/app/nymea-app/id1400810250?mt=8">nymea for iOS </a>
<td> <a href="https://play.google.com/store/apps/details?id=io.guh.nymeaapp&hl=en&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1">nymea for Android</a>
</tr>
</table>
## Get the nymea desktop app here:
<p align="center">
<img src="https://nymea.io/app/default/assets/addons/default/guh/default-theme/resources/img/community/app-shots/desktop-app.png" width=100% />
</p>
<table width:100%>
<tr>
<td> <a href="https://downloads.nymea.io/nymea-app/nymea-app-osx-bundle.dmg">nymea for macOS </a>
<td> <a href="https://snapcraft.io/nymea-app">nymea for Linux</td>
<td> <a href="https://downloads.nymea.io/nymea-app/nymea-app-win-installer.exe">nymea for Windows</td>
</tr>
</table>
## Getting help
If you want to present your project or want to share your newest developments you can share it in
[Our Forum](https://forum.nymea.io)
If you are facing any troubles, don't hesitate to reach out for us or the community members, we will be pleased to help you:
Chat with us on [Telegram](http://t.me/nymeacommunity)
## Wiki and Documentation
* A detailed description how to install and getting started with the *nymea* can be found in the
[nymea | github wiki](https://wiki.nymea.io).
* A detailed documentation of the source code can be found in the
[nymea | developer documentation](https://doc.nymea.io).
## License
--------------------------------------------
> nymea is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2 of the License.