GaragePi Custom

Overengineer your garage door with your Raspberry Pi!

Use a Raspberry Pi to open or close your garage door and to sense whether it's currently open. You can do this from the comfort of your couch or anywhere in the world (with an appropriate VPN connection). Your spouse may think you're crazy, but it's so cool!

I started with this guide by Chris Driscoll at Driscosity. Chris has an awesome guide with step-by-step instructions, pictures, and even a video of the system in operation. I use this same hardware setup for GaragePi.

What he has is great for a simple opener and status display, but the second time I used it my relay got stuck closed because of a connection issue (it's javascript based). I also wanted more features and more control over what was going on.

So I wrote a Flask app (Python) with some JSON/jQuery for keeping the status updated. I also used Bootstrap for the front end. All these are new to me so forgive / correct any noob mistakes.

Jan 2024 Updates - Responseless

• Updated dependencies
• Merged in Telegram and Crack Open functions (not fully working)

May 2023 Update - Responseless

• Update dependencies with security issues
• changed pip version install
• Retested uninstall / setup

Jan 2022 Update - Responseless

• Fixed Issue with old manual toggles
• Added TEST temperature for bme280 module (in works)

December 2021 Update - Responseless

• Added check toggle to bypass modal warning and directly trigger
• Updated trigger times to use float instead of integer. This was due to adding a button for quick re-open for gates which auto-close after opening.

May 2021 Update - Responseless

• Added Configuration to hide timed buttons, set time for each button before re-triggering. This can be used to stop a gate opening, or auto-close etc.
• Upgraded some dependencies for security and other reasons as they were outdated and would not clean install automatically anymore (fixed).
• Added favicons

Dec 2019 Update - Responseless

• Added buttons to auto-close (or auto-open) the door after specified seconds 15/30.
• Hid the Status of the door as I don't have a sensor connected to check this.
• Added external GET API point for other applications to hit to open/close the door without auth.

Feb 2016 Update - IFTTT Maker Support!

GaragePi now supports IFTTT alerts through the new Maker Channel. It will generate events when an open or close is detected and even at a designated time.

See below for alert details and how to set them up.

I also pulled the app into two parts, one for the webserver and one that's always running and talking to the RPi. This makes it so the webserver doesn't have to run with root privileges. More importantly, this also enables a whole lot of other features that require running all the time instead of just within a web request.

Current Features

• Open / Close the garage/gate with the press of a button. With or without a secondary prompt.
• See if garage/gate is currently open.
• See history of when the door was opened or closed even when it wasn't opened/closed using the app.
• Garage/gate activity generates IFTTT events.
• Responsive UI for both desktop and mobile use.
• Show the RPI's internal temps because, well, I can.
• Added Extra buttons to Auto close door after 15 and 30 seconds.
• Added API for remote calls without using web interface.

Other Features

See https://github.com/nathanpjones/GaragePi for any new features I may merge in this fork.

Installation

Online Installation

1. Follow all the instructions at Driscosity up until the point where he has you installing WebIOPi. Basically, just do the hardware bit and the RPi environment setup.

2. Run the fully automated installer by running this command logged into your Raspberry Pi.

   curl -s "https://raw.githubusercontent.com/Responseless/GaragePi/master/setup/online_install.sh" | bash

   (If you want to know what's going on, here are the full contents of online_install.sh and then setup.sh that is called next.)

It will take a while for the setup scripts to run, but at the end you should be able to access your site at your Raspberry Pi's IP address.

The online install will put everything in ~/garage_pi. Look to the instance subfolder for the app logs and the database.

Offline Install

If you want to pull down the repo manually (recommended if you want to choose where to install), all you have to do is navigate to the project root folder and run the following command.

source setup/setup.sh

Configuration

The app configuration file is found in instance/app.cfg.

1. Navigate to the project root. If you used the online installer, run cd ~/garage_site.
2. Run nano instance/app.cfg to open the config file.
3. Locate the PASSWORD field and change it from the default to something unique for you. You may also change the login USERNAME if you like.
4. Set the RELAY_PIN and REED_PIN if your hardware configuration differs from the Driscosity setup.
5. Have a look through the other settings such as the IFTTT settings to see if any other changes are appropriate.
6. Press CTRL+X. Answer Y when prompted to save and then press Enter to overwrite the existing file.

Uninstall

I've included an uninstall script. You can run it with the following command.

source setup/uninstall.sh

This isn't a complete uninstall because I don't keep track of everything you had installed when you started. It does remove the GaragePi related services and lets you know what else you might want to remove.

Once you've run the uninstall script, it's safe to simply delete the project root folder.

rm -rf ~/garage_pi

IFTTT Events

GaragePi supports generating IFTTT events using the Maker Channel.

Available Events

• garage_door_opened - Fired when door is opened
• garage_door_closed - Fired when door is closed
• garage_door_changed - Fired when door is opened or closed. Value1 is set to either opened or closed.
• garage_door_warning - Fired when door is open at a given time of day. Value1 is set to open.

Configuring Events

To enable IFTTT events, you must first obtain your maker key. You should see listed on the front page of the Maker Channel.

1. Open up instance/app.cfg
2. Locate the line that starts with IFTTT_MAKER_KEY and input your maker key between the single quotes. It should look something like, IFTTT_MAKER_KEY = 'c-jfLKBJEfijas3r28VBL'
3. If you want to use the door warning, change DOOR_OPEN_WARNING_TIME to the desired time. Make sure to use 24-hour format with just hours and seconds, for example, DOOR_OPEN_WARNING_TIME = "18:30"