Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/freedomotic/freedomotic
Open IoT Framework
https://github.com/freedomotic/freedomotic
arduino domotica domotics framework hacktoberfest home-automation internet-of-things iot iot-platform java mqtt open-source opensource raspberrypi ubuntu
Last synced: 4 days ago
JSON representation
Open IoT Framework
- Host: GitHub
- URL: https://github.com/freedomotic/freedomotic
- Owner: freedomotic
- License: other
- Created: 2013-10-06T14:53:16.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2023-07-07T21:24:20.000Z (over 1 year ago)
- Last Synced: 2024-10-14T08:06:47.356Z (22 days ago)
- Topics: arduino, domotica, domotics, framework, hacktoberfest, home-automation, internet-of-things, iot, iot-platform, java, mqtt, open-source, opensource, raspberrypi, ubuntu
- Language: Java
- Homepage: https://www.freedomotic-platform.com
- Size: 140 MB
- Stars: 419
- Watchers: 51
- Forks: 486
- Open Issues: 86
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.GPL
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome_iot - Freedomotic ★ 208 ⧗ 4 - is an open source, flexible, secure Internet of Things (IoT) application framework, useful to build and manage modern smart spaces. (Framework)
- awesome-smarthome - Freedomotic
- awesome-iot - Freedomotic ★ 208 ⧗ 4 - is an open source, flexible, secure Internet of Things (IoT) application framework, useful to build and manage modern smart spaces. (Framework)
- awesome-home-automation - Freedomotic
README
Freedomotic Open IoT Framework
=================================
Official website is https://www.freedomotic-platform.com
Freedomotic is an open source, flexible, secure Internet of Things (IoT) application framework, useful to build and manage modern smart spaces. It is targeted to private individuals (home automation) as well as business users (smart retail environments, ambient aware marketing, monitoring and analytics, ...)
Freedomotic can run also on **Raspberry Pi** and can easily interact with DIY **Arduino** projects.
Starting from 2 Feb 2014, this is the Freedomotic mainstream repository. Previous repository was hosted on googlecode http://code.google.com/p/freedomotic
Requirements:
- **Java Open JDK** version 11+ or another **JDK** _(to install on Ubuntu: sudo apt-get install openjdk-11-jdk)_
- **Maven** version 2 or 3 _(to install on Ubuntu: sudo apt-get install maven)_
- **Any OS** with Java support _(Linux, Windows, Mac, Solaris ...)_
Development status:
- **Current released version**: 5.6.0 'Commander RC4' (released on 16 Aug 2017)
- **Version in development (HEAD of this repository)**: 5.6.0 'Commander'
Quick Start
======================
Follow these instructions if you want to compile Freedomotic from source (eg: to develop your own plugins). If you just want to try it, just download the precompiled binaries you can find at the official download page https://sourceforge.net/projects/freedomotic/
**1) Fork Freedomotic on GitHub**
* Create an account on https://github.com if you don't have one.
* **Fork Freedomotic** [_(What does it mean?)_](https://help.github.com/articles/fork-a-repo) following this link: .
* Create the local clone of your online fork with this command:
```
git clone https://github.com/YOUR-GITHUB-USERNAME/freedomotic.git
```
Now the repository is ready to work with.
**2) Enter the new local folder**
cd freedomotic
**3) Install the jar loader on local Maven repository**
In order to compile the code you need to add the agent with a custom classloader (for loading jars at runtime in Java 9+). This file called **freedomotic-jar-loader-0.0.1.jar** is included inside _third-party-libs_ folder.
So enter this folder
cd third-party-libs
and execute
mvn install:install-file -Dfile=freedomotic-jar-loader-0.0.1.jar -DgroupId=com.freedomotic -DartifactId=freedomotic-jar-loader -Dversion=0.0.1 -Dpackaging=jar
**4) Compile Freedomotic with Maven**
mvn clean install
**5) IMPORTANT!!!! THIS IS REQUIRED: Copy the example-data folder into freedomotic-core/data.** If you miss this step Freedomotic won't start
cp -r data-example/ framework/freedomotic-core/data
**6) Run Freedomotic**
java -javaagent:third-party-libs/freedomotic-jar-loader-0.0.1.jar -jar framework/freedomotic-core/target/freedomotic-core/freedomotic.jar
As an alternative you can start **freedomotic-core** project from your favourite IDE.
Getting help
============
Having trouble with Freedomotic? We’d like to help!
- Check out the [user manual](http://freedomotic-user-manual.readthedocs.io) for reference documentation.
- Write on the [mailing list](https://groups.google.com/forum/#!forum/freedom-domotics)
- Send an email to [email protected]
- Open an issue on https://github.com/freedomotic/freedomotic/issues
Contributing
============
Want to help us? It's very simple and funny. [Here](https://github.com/freedomotic/freedomotic/blob/master/CONTRIBUTING.md) how to do.
License
=============
Freedomotic is an Open Source software released under the [GNU GPLv2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html) license.
Partners
========
This project is supported by:
