{"id":13587939,"url":"https://github.com/pi-hole/PADD","last_synced_at":"2025-04-08T02:34:26.195Z","repository":{"id":38032113,"uuid":"84619095","full_name":"pi-hole/PADD","owner":"pi-hole","description":"PADD (formerly Chronometer2) is a more expansive version of the original chronometer.sh that is included with Pi-Hole. PADD provides in-depth information about your Pi-hole.","archived":false,"fork":false,"pushed_at":"2024-10-26T12:14:03.000Z","size":517,"stargazers_count":1365,"open_issues_count":5,"forks_count":122,"subscribers_count":43,"default_branch":"master","last_synced_at":"2024-10-29T15:19:19.625Z","etag":null,"topics":["bash-script","padd","pi-hole","pihole","pitft","raspberry-pi","raspberrypi"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pi-hole.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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},"funding":{"github":"pi-hole","custom":["https://pi-hole.net/donate"],"patreon":"pihole"}},"created_at":"2017-03-11T02:54:53.000Z","updated_at":"2024-10-22T13:17:36.000Z","dependencies_parsed_at":"2023-09-24T08:28:19.574Z","dependency_job_id":"bd83c4e9-97b7-4a0e-ba8f-274966db0783","html_url":"https://github.com/pi-hole/PADD","commit_stats":{"total_commits":302,"total_committers":34,"mean_commits":8.882352941176471,"dds":0.5728476821192052,"last_synced_commit":"fb92108f0dc2394e66f7baf454daa04fe2223787"},"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pi-hole%2FPADD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pi-hole%2FPADD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pi-hole%2FPADD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pi-hole%2FPADD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pi-hole","download_url":"https://codeload.github.com/pi-hole/PADD/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223052412,"owners_count":17080082,"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":["bash-script","padd","pi-hole","pihole","pitft","raspberry-pi","raspberrypi"],"created_at":"2024-08-01T15:06:26.012Z","updated_at":"2025-04-08T02:34:26.186Z","avatar_url":"https://github.com/pi-hole.png","language":"Shell","funding_links":["https://github.com/sponsors/pi-hole","https://pi-hole.net/donate","https://patreon.com/pihole"],"categories":["Shell","raspberry-pi"],"sub_categories":[],"readme":"# PADD\n\nPADD (formerly Chronometer2) is a more expansive version of the original chronometer.sh that is included with [Pi-Hole](https://pi-hole.net). PADD provides in-depth information about your Pi-hole.\n\n![PADD Screenshot](https://pi-hole.github.io/graphics/Screenshots/padd.png)\n\n***Note:** PADD has been adopted by the Pi-hole team, thanks to JPMCK for creating this helpful tool!\n\n## Setup PADD\n\n- Get a copy of PADD by running:\n\n  ```bash\n  cd ~\n  wget -O padd.sh https://install.padd.sh\n  ```\n\n  or\n\n  ```bash\n  cd ~\n  curl -sSL https://install.padd.sh -o padd.sh\n  ```\n\n- Make PADD executable by running\n\n  ```bash\n  sudo chmod +x padd.sh\n  ```\n\n## Using PADD\n\n### PADD on Pi-hole machine\n\n- Just run\n\n  ```bash\n  ./padd.sh\n  ```\n\n### PADD from other machine\n\nWith PADD v4.0.0 and Pi-hole v6 it is also possible to run PADD from a machine that is not running Pi-hole\n\n  ```bash\n  ./padd.sh --server \u003cDOMAIN|IP\u003e\n  ```\n\n### Authentication\n\nPi-hole v6 uses a completely new API with a new authentication mechanism\n\nIf you run PADD on the same machine as Pi-hole, it's possible to bypass authentication when your local user is member of the `pihole` group (specifically, if you can access `/etc/pihole/cli_pw).\nFor details see [https://github.com/pi-hole/FTL/pull/1999](https://github.com/pi-hole/FTL/pull/1999)\n\nIf this is not the case, PADD will ask you for your password and (if configured) your two factor authentication token. You can also pass those as arguments\n\n- password only\n\n  ```bash\n  ./padd.sh --secret \u003cpassword\u003e\n  ```\n\n- with 2FA enabled\n\n  ```bash\n  ./padd.sh --secret \u003cpassword\u003e --2fa \u003c2fa\u003e\n  ```\n\n### PADD with Pi-hole in a Docker Container\n\n- If you're running Pi-hole in the official Docker Container, `padd.sh` is pre-installed and named `padd`. It can be used with the following command:\n\n  ```bash\n  docker exec -it \u003ccontainer_name\u003e padd [padd_options]\n  ```\n\n### PADD on PiTFT screen\n\n_Instructions for how to setup PiTFT screen can be found [here](https://learn.adafruit.com/adafruit-pitft-3-dot-5-touch-screen-for-raspberry-pi/easy-install-2)_\n\n- Set PADD to auto run on the PiTFT screen by adding the following to the end of `~/.bashrc`:\n\n  ```bash\n  # Run PADD\n  # If we’re on the PiTFT screen (ssh is xterm)\n  if [ \"$TERM\" == \"linux\" ] ; then\n    while :\n    do\n      ./padd.sh\n      sleep 1\n    done\n  fi\n  ```\n\n  One line version\n\n  ```bash\n  cd ~ ; echo \"if [ \\\"\\$TERM\\\" == \\\"linux\\\" ] ; then\\n  while :\\n  do\\n    ./padd.sh\\n    sleep 1\\n  done\\nfi\" | tee ~/.bashrc -a\n  ```\n\n- Reboot your Pi-Hole by running `sudo reboot`. PADD should now run on PiTFT Screen when your Pi-Hole has completed booting.\n\n#### (Optional) Put the PiTFT Display to Sleep at Night\n\n_If you don't want your PiTFT on all night when you are asleep, you can put it to sleep! (Note: **these instructions only apply to a PiTFT**.)_\n\n- To do so, edit cron as root (`sudo crontab -e`) and add the following:\n\n  ```bash\n  # PiTFT+ SLEEPY TIME\n  # Turn off the PiTFT+ at midnight\n  00 00 * * * sh -c 'echo \"0\" \u003e /sys/class/backlight/soc\\:backlight/brightness'\n  # Turn on the PiTFT+ at 8:00 am\n  00 08 * * * sh -c 'echo \"1\" \u003e /sys/class/backlight/soc\\:backlight/brightness'\n  ```\n\n## Updating PADD\n\n- Simply run\n\n  ```bash\n  ./padd.sh -u\n  ```\n\n- or run the same commands you used to install\n\n  ```bash\n  cd ~\n  wget -O padd.sh https://install.padd.sh\n  ```\n\n  or\n\n  ```bash\n  cd ~\n  curl -sSL https://install.padd.sh -o padd.sh\n  ```\n\n## Sizes\n\nPADD will display on screens that anywhere from 20x10 characters to over 80x26 characters.\n\nAs your screen gets smaller, you’ll be presented with less information… however, you’ll always get the most important details:\n\n- The status of your Pi-hole (is it online, in need of an update?),\n- How many ads have been blocked,\n- Your hostname and IP, and\n- Your CPU’s current load.\n\nIt will also run in the following modes (shown further below):\n\n- Pico: 20x10 characters\n- Nano: 24x12 characters\n- Micro: 30x16 characters\n- Mini: 40x18 characters\n- Tiny: 53x20 characters\n- Slim: 60x21 characters\n- Regular: 60x22 characters (takes up the entire screen on a 3.5\" Adafruit PiTFT using the Terminal font at 8x14.)\n- Mega: 80x26 characters\n\n### Sizing Your PADD\n\nHow PADD will display on your screen depends on the size of the screen in _characters_, not _pixels_! PADD doesn’t care if it is running on a 5k Retina display on your $5,000 iMac Pro or on a $5 display you bought on eBay.\n\nIf you want to change how PADD displays on a small display attached to your Raspberry Pi, use\n\n```bash\nsudo dpkg-reconfigure console-setup\n```\n\nto configure your font settings to an ideal size for you.\n\nIf you want to change how PADD displays through a terminal emulator (PuTTY, Terminal.app, iTerm2, etc.), resize your window or play with font sizes in your app of choice.\n\n### The Sizes\n\n![PADD Sizes GIF](https://github.com/pi-hole/graphics/blob/master/PADD/PADDsizes.gif)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpi-hole%2FPADD","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpi-hole%2FPADD","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpi-hole%2FPADD/lists"}