hfreire / my-flic-hub

My own flic hub :tm: for the :earth_africa: world's smartest :red_circle: button

My own flic hub ™️ for the 🌍 world's smartest 🔴 button

Use a Raspberry Pi to control all your home flic buttons without the flic app or a flic hub.

How to use

Use it in your terminal

Using it in your terminal requires Docker installed in your system.

Run the Docker image in a container

Detach from the container and use the host's network stack.

docker run -d --cap-add NET_ADMIN --net=host hfreire/my-flic-hub

Available REST API endpoints

Swagger documentation available at http://localhost:3000/docs.

Available usage environment variables

Variable	Description	Required	Default value
PORT	The port to be used by the HTTP server.	false	3000
API_KEYS	The secret keys that should be used when securing endpoints.	false	undefined
SO_TIMEOUT	TCP socket connection timeout.	false	120000
BASE_PATH	Base path to be prefixed to all available endpoint paths.	false	/
PING_PATH	Endpoint path for pinging app.	false	/ping
HEALTHCHECK_PATH	Endpoint for checking app health.	false	/healthcheck
LOG_LEVEL	The log level verbosity.	false	info
ENVIRONMENT	The environment the app is running on.	false	undefined
ROLLBAR_API_KEY	The server API key used to talk with Rollbar.	false	undefined

How to build

Clone the GitHub repo

git clone https://github.com/hfreire/my-flic-hub.git

Change current directory

cd my-flic-hub

Run the NPM script that will build the Docker image

npm run build

How to contribute

You can contribute either with code (e.g., new features, bug fixes and documentation) or by donating 5 EUR. You can read the contributing guidelines for instructions on how to contribute with code.

All donation proceedings will go to the Sverige för UNHCR, a swedish partner of the UNHCR - The UN Refugee Agency, a global organisation dedicated to saving lives, protecting rights and building a better future for refugees, forcibly displaced communities and stateless people.

License

Read the license for permissions and limitations.

my-flic-hub's Issues

Action required: Greenkeeper could not be activated 🚨

🚨 You need to enable Continuous Integration on all branches of this repository. 🚨

To enable Greenkeeper, you need to make sure that a commit status is reported on all branches. This is required by Greenkeeper because it uses your CI build statuses to figure out when to notify you about breaking changes.

Since we didn’t receive a CI status on the greenkeeper/initial branch, it’s possible that you don’t have CI set up yet. We recommend using Travis CI, but Greenkeeper will work with every other CI service as well.

If you have already set up a CI for this repository, you might need to check how it’s configured. Make sure it is set to run on all new branches. If you don’t want it to run on absolutely every branch, you can whitelist branches starting with greenkeeper/.

Once you have installed and configured CI on this repository correctly, you’ll need to re-trigger Greenkeeper’s initial pull request. To do this, please delete the greenkeeper/initial branch in this repository, and then remove and re-add this repository to the Greenkeeper App’s white list on Github. You'll find this list on your repo or organization’s settings page, under Installed GitHub Apps.