Coder Social home page Coder Social logo

devilsaintus / homebridge-pihole Goto Github PK

View Code? Open in Web Editor NEW

This project forked from arendruni/homebridge-pihole

0.0 0.0 0.0 649 KB

Pihole switch for Homebridge

Home Page: https://www.npmjs.com/package/homebridge-pihole

License: MIT License

Shell 4.67% TypeScript 95.33%

homebridge-pihole's Introduction

Homebridge Pi-hole verified-by-homebridge

npm npm Codacy Badge Build Status MIT license

Pi-hole plugin for Homebridge. This plugin publishes a virtual switch that disables Pi-hole, making it easier to temporarily turn off the ad-blocker. Supports SSL connections and can be configured with a timer to turn Pi-hole back on.

Requirements

  • Homebridge - HomeKit support for the impatient
  • Pi-hole - A black hole for Internet advertisements

Installation

  1. Install this plugin npm install -g homebridge-pihole
  2. Update your configuration file. See sample-config.json in this repository for a sample.

See the Pi-hole installation section for more details.

Configuration

There are the following options:

  • name Required. Accessory name, default is Pi-hole.

Pi-hole Configuration

  • auth Pi-hole auth token.
  • host Pi-hole host, default is localhost.
  • port Pi-hole port, default is 80.
  • ssl If the Pi-hole server should be connected to with SSL.
  • rejectUnauthorized If the HTTPS agent should check the validity of SSL cert, set it to false to allow self-signed certs to work. Default is true.
  • baseDirectory The directory where Pi-hole is found on the server, default is /admin/.
  • time How long Pi-hole will be disabled, in seconds, default is 0 that means permanently disabled.
  • reversed When set to true reverse the status of Pi-hole. When Pi-hole is off the plugin will be set to on and when Pi-hole is on the plugin will be set to off. Default is false.
  • logLevel Logging level, three different levels: 0: logging disabled, 1: logs only HTTP errors, 2: logs each HTTP response. Default is set to 1.

Device Information

  • manufacturer Custom manufacturer, default is Raspberry Pi.
  • model Custom model, default is Pi-hole.
  • serial-number Should be a 9 digit number in the string format 123-456-789.

See the sample-config.json file to see an example of how to configure the accessory. In the example the configured accessory will disable Pi-hole for a time interval of two minutes (120 seconds).

How to get a Pi-hole authentication token

  1. Login into your Pi-hole Admin Console.
  2. Navigate to the Settings page and then to the API / Web interface tab.
  3. At the bottom of the page click on the Show API Token button, a popup window will ask for confirmation, go ahead and click on Yes, show API token.
  4. A new window will open showing a QR code, copy the Raw API Token below the QR code.
  5. Paste your API token in the homebridge configuration file.

homebridge-pihole's People

Contributors

arendruni avatar ncovercash avatar barbequesauce avatar dependabot[bot] avatar donavanbecker avatar chriscn avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.