Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pi-hole/padd
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.
https://github.com/pi-hole/padd
bash-script padd pi-hole pihole pitft raspberry-pi raspberrypi
Last synced: 3 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/pi-hole/padd
- Owner: pi-hole
- Created: 2017-03-11T02:54:53.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-26T12:14:03.000Z (about 2 months ago)
- Last Synced: 2024-10-29T15:19:19.625Z (about 2 months ago)
- Topics: bash-script, padd, pi-hole, pihole, pitft, raspberry-pi, raspberrypi
- Language: Shell
- Homepage:
- Size: 505 KB
- Stars: 1,365
- Watchers: 43
- Forks: 122
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PADD
PADD (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.
***Note:** PADD has been adopted by the Pi-hole team, thanks to JPMCK for creating this helpful tool!
## Setup PADD
*More in-depth information about setting up PADD can be found in this repo’s [wiki](https://github.com/pi-hole/PADD/wiki/Setup).*
- Get a copy of PADD by running:
```bash
cd ~
wget -O padd.sh https://install.padd.sh
```
or
```bash
cd ~
curl -sSL https://install.padd.sh -o padd.sh
```
- Make PADD executable by running
```bash
sudo chmod +x padd.sh
```
- Set PADD to auto run by adding the following to the end of `~/.bashrc`:
```bash
# Run PADD
# If we’re on the PiTFT screen (ssh is xterm)
if [ "$TERM" == "linux" ] ; then
while :
do
./padd.sh
sleep 1
done
fi
```
One line version
```bash
cd ~ ; echo "if [ \"\$TERM\" == \"linux\" ] ; then\n while :\n do\n ./padd.sh\n sleep 1\n done\nfi" | tee ~/.bashrc -a
```
- Reboot your Pi-Hole by running `sudo reboot`. PADD should now run when your Pi-Hole has completed booting.
## Updating PADD
- Simply run
```bash
./padd.sh -u
```
- or run the same commands you used to install
```bash
cd ~
wget -O padd.sh https://install.padd.sh
```
```bash
cd ~
curl -sSL https://install.padd.sh -o padd.sh
```
## Running Pi-hole in a Docker Container
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:
```bash
docker exec -it padd [padd_options]
```