{"id":16753043,"url":"https://github.com/bsutton/irrigationforpi","last_synced_at":"2026-04-07T15:34:10.742Z","repository":{"id":27893481,"uuid":"115487368","full_name":"bsutton/IrrigationForPi","owner":"bsutton","description":"An irrigation and lighting controller for home automation based on the Raspberry Pi.","archived":false,"fork":false,"pushed_at":"2025-01-12T02:25:17.000Z","size":66072,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T13:51:18.290Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bsutton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-27T06:03:34.000Z","updated_at":"2025-03-20T05:21:03.000Z","dependencies_parsed_at":"2025-01-18T22:45:19.698Z","dependency_job_id":null,"html_url":"https://github.com/bsutton/IrrigationForPi","commit_stats":{"total_commits":159,"total_committers":2,"mean_commits":79.5,"dds":0.03144654088050314,"last_synced_commit":"f6627d2fbb9bacab908378cfa44ec75a02d39391"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsutton%2FIrrigationForPi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsutton%2FIrrigationForPi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsutton%2FIrrigationForPi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bsutton%2FIrrigationForPi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bsutton","download_url":"https://codeload.github.com/bsutton/IrrigationForPi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248250743,"owners_count":21072682,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T02:49:00.012Z","updated_at":"2026-04-07T15:34:10.702Z","avatar_url":"https://github.com/bsutton.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"Pi-gation\n============\nAn irrigation and out door lighting controller for the Raspbery PI.\n\nTo use Pi-gation you need a Raspberry PI, one or more relay boards wired up to digital IO pins and some solenoid valves or lights that you want to control.\n\n\nWARNING WARNING\n===============\n\nWater can be surprisingly destructive. Even a small leak can do a lot of damage.\n\nPi-gation is a work in progress, so there are REAL risks that it may do something wrong that could end up with a serious water flow for extended periods!!!\n\nHaving said that I've been using it for three years without issue.\n\nIf you should choose to use Pi-gation you MUST only do so at your OWN RISK.\n\nI make no warranties that Pi-gation is fit for purpose and I guarantee you that it has LOTS OF BUGS.\n\nSo use it carefully and monitor its operation carefully until you are comfortable it is operating correctly in your environment.\n\nDuring early operation you should be turning the master tap OFF when you are not physically monitoring your watering system.\n\n\n\nOverview\n========\n\nPi-gation is a web app designed to allow you to control external lighting and irrigation systems from a mobile device.\n\nThe app allows you to configure Pins on the Pi to control various devices such as Lights and Valves for an irrigation system.\n\nIn theory the app can be used to control any device attached to a Pi but it has specific interfaces that are fashioned around \nconfiguring irrigation and lighting systems.\n\nIt only takes a few minutes to get this web app up and running so give it a try :)\n\nContributes to this project are strongly encouraged so post your patches.\n\nYou can read the Pi-gation [user manual here](https://github.com/bsutton/IrrigationForPi/wiki)\n\nBuild\n=======\nOn your local desktop\n\nThis process could be done on the PI but it would take a very long time.\n\n\nConfigure the build environment\n\n```\nsudo apt install openjdk-11-jdk-headless maven git dart\n\n# log out and back in before continuing.\n\npub global activate dcli\npub global activate pigation\n\ngit clone git@github.com:bsutton/IrrigationForPi.git\n\ncd IrrigationForPi/dart_tools\npig_build\n```\n\nThe pig_build command outputs a zip file which you need to copy to the raspberry pi.\n\n```\nscp install_pigation.zip \u003cip address\u003e:\n```\n\nOnce the file has copied go to the section on installing.\n\n\nInstallation\n==========\n\nOn the raspbery pi \n\nThe install process needs at least 2 GB of ram or swap so make certain you have\nallocated sufficient swap before you start the install.\n\nIf you don't have sufficient swap then the `pub global activate` command are likely to hang.\n\n\n```\nsudo apt install dart unzip\n\n## logout of the pi and log back in before continuing.\n\npub global activate dcli\npub global activate pigation\n\nsudo apt install docker \n\npig_install\n\n```\n\nNote: I've had trouble with the raspberry pi running out of memory during this phase so shutdown any process that aren't needed.\nOn my 1GB pi I had to [extend my swap file](https://bogdancornianu.com/change-swap-size-in-ubuntu/) to 4GB to get the step to complete:\n\n\n\nPi-gation is now running and waiting for you to configure your garden beds and lighting.\n\nOpen a web browser on you PC or Phone and access the ip address of fqdn of you raspberry pi.\n\n \nTechnology\n==========\n\nIrrigationForPi uses the following technology (if you care about such things). You don't need to know this to use or install the app.\n\n* Java 8\n* Tomcat 8\n* EclipseLink (JPA)\n* Derby (database).\n* Vaadin 8 framework.\n* Docker\n* Dart\n* DCli\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsutton%2Firrigationforpi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbsutton%2Firrigationforpi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbsutton%2Firrigationforpi/lists"}