# pihole5-list-tool
[](https://badge.fury.io/py/pihole5-list-tool)
[](https://pypi.org/project/pihole5-list-tool/)
This tool provides bulk operations to manage your [Pi-hole 5](https://pi-hole.net/) **Allow lists** and **Block/Ad lists**.
## Features:
- **Allow lists** can be [added](#allowlists) from [anudeepND's allowlist](https://github.com/anudeepND/whitelist), files, or manual entry
- **Block/Ad lists** can be [added](#adblocklists) from [firebog.net](https://firebog.net/), files, or manual entry
- **Removes** lists it adds (or all of them)
- **Reset** lists to Pi-hole defaults
- **Stats** provides some quick sums and groupings
- **Docker** if you're running the [pihole docker image](https://hub.docker.com/r/pihole/pihole/) (or one named `pihole`), it should be detected
and offered as a default option
## requirements
- working [pi-hole 5+](https://pi-hole.net) installation
- [python 3.7+](https://python.org/) (available by default on Raspbian 10, probably available on your system)
## installation
```bash
$ sudo pip3 install pihole5-list-tool --upgrade
```
_Note:_
- If the `pip3` command doesn't work, try using `pip` instead. Here are additional [options /workarounds](https://stackoverflow.com/questions/40832533/pip-or-pip3-to-install-packages-for-python-3) (and glimpses into Python peculiarities)
- You **must** use `sudo`
## usage / running
Simply run:
```bash
$ sudo pihole5-list-tool
```
This is what installing and running it basically looks like (many features have been added since this):
[](https://asciinema.org/a/331296)
## supported sources
_TL; DR_ - some maintained online lists, anything you can paste, or a file
### allowlists
Currently the only source for maintained whitelists is [anudeepND's allowlist](https://github.com/anudeepND/whitelist). They are presented as:
- **Allowlist Only** - Domains that are safe to allow i.e does not contain any tracking or
advertising sites. This fixes many problems like YouTube watch history,
videos on news sites and so on.
- **Allowlist+Optional** - These are needed depending on the service you use. They may contain some
tracking sites but sometimes it's necessary to add bad domains to make a
few services to work.
- **Allowlist+Referral** - People who use services like Slickdeals and Fatwallet need a few sites
(most of them are either trackers or ads) to be whitelisted to work
properly. This contains some analytics and ad serving sites like
doubleclick.net and others. If you don't know what these services are,
stay away from this list. Domains that are safe to whitelist i.e does
not contain any tracking or advertising sites. This fixes many problems
like YouTube watch history, videos on news sites and so on.
### ad/blocklists
Currently the only source for maintained blocklists is [firebog.net](https://firebog.net/)
- **Non-crossed lists**: For when someone is usually around to whitelist falsely blocked sites
- **Ticked lists**: For when installing Pi-hole where no one will be whitelisting falsely blocked sites
- **All lists**: For those who will always be around to whitelist falsely blocked sites
### file/paste
Both list types allow providing either a **pasted in list** or a **file** as your source of lists.
### Finishing up
After adding lists, they must be loaded by running:
```bash
$ pihole -g
```
This tool will offer to do that for you.
When that finishes, you'll see each of listed in the **Web Admin** interface along with a comment to help identify them.
**NOTE:** If you need/want the blocklists added from [firebog.net](https://firebog.net/) (and more) continually updated, check out [pihole-updatelists](https://github.com/jacklul/pihole-updatelists) which will also run great on a Pi.
Raw data
{
"_id": null,
"home_page": "https://github.com/jessedp/pihole5-list-tool",
"name": "pihole5-list-tool",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "pihole,pi-hole,blacklist,blocklist,whitelist,allowlist,adlist",
"author": "jessedp",
"author_email": "jessedp@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ff/e8/d3efc6650f8d29b7cf3af301e3d4a8fcfc6e1496a3a3486724b809077bad/pihole5-list-tool-0.6.2.tar.gz",
"platform": null,
"description": "# pihole5-list-tool\n\n[](https://badge.fury.io/py/pihole5-list-tool)\n[](https://pypi.org/project/pihole5-list-tool/)\n\nThis tool provides bulk operations to manage your [Pi-hole 5](https://pi-hole.net/) **Allow lists** and **Block/Ad lists**.\n\n## Features:\n\n- **Allow lists** can be [added](#allowlists) from [anudeepND's allowlist](https://github.com/anudeepND/whitelist), files, or manual entry\n- **Block/Ad lists** can be [added](#adblocklists) from [firebog.net](https://firebog.net/), files, or manual entry\n- **Removes** lists it adds (or all of them)\n- **Reset** lists to Pi-hole defaults\n- **Stats** provides some quick sums and groupings\n- **Docker** if you're running the [pihole docker image](https://hub.docker.com/r/pihole/pihole/) (or one named `pihole`), it should be detected\n and offered as a default option\n\n## requirements\n\n- working [pi-hole 5+](https://pi-hole.net) installation\n- [python 3.7+](https://python.org/) (available by default on Raspbian 10, probably available on your system)\n\n## installation\n\n```bash\n$ sudo pip3 install pihole5-list-tool --upgrade\n```\n\n_Note:_\n\n- If the `pip3` command doesn't work, try using `pip` instead. Here are additional [options /workarounds](https://stackoverflow.com/questions/40832533/pip-or-pip3-to-install-packages-for-python-3) (and glimpses into Python peculiarities)\n- You **must** use `sudo`\n\n## usage / running\n\nSimply run:\n\n```bash\n$ sudo pihole5-list-tool\n```\n\nThis is what installing and running it basically looks like (many features have been added since this):\n\n[](https://asciinema.org/a/331296)\n\n## supported sources\n\n_TL; DR_ - some maintained online lists, anything you can paste, or a file\n\n### allowlists\n\nCurrently the only source for maintained whitelists is [anudeepND's allowlist](https://github.com/anudeepND/whitelist). They are presented as:\n\n- **Allowlist Only** - Domains that are safe to allow i.e does not contain any tracking or\n\n advertising sites. This fixes many problems like YouTube watch history,\n videos on news sites and so on.\n\n- **Allowlist+Optional** - These are needed depending on the service you use. They may contain some\n\n tracking sites but sometimes it's necessary to add bad domains to make a\n few services to work.\n\n- **Allowlist+Referral** - People who use services like Slickdeals and Fatwallet need a few sites\n\n (most of them are either trackers or ads) to be whitelisted to work\n properly. This contains some analytics and ad serving sites like\n doubleclick.net and others. If you don't know what these services are,\n stay away from this list. Domains that are safe to whitelist i.e does\n not contain any tracking or advertising sites. This fixes many problems\n like YouTube watch history, videos on news sites and so on.\n\n### ad/blocklists\n\nCurrently the only source for maintained blocklists is [firebog.net](https://firebog.net/)\n\n- **Non-crossed lists**: For when someone is usually around to whitelist falsely blocked sites\n- **Ticked lists**: For when installing Pi-hole where no one will be whitelisting falsely blocked sites\n- **All lists**: For those who will always be around to whitelist falsely blocked sites\n\n### file/paste\n\nBoth list types allow providing either a **pasted in list** or a **file** as your source of lists.\n\n### Finishing up\n\nAfter adding lists, they must be loaded by running:\n\n```bash\n$ pihole -g\n```\n\nThis tool will offer to do that for you.\n\nWhen that finishes, you'll see each of listed in the **Web Admin** interface along with a comment to help identify them.\n\n**NOTE:** If you need/want the blocklists added from [firebog.net](https://firebog.net/) (and more) continually updated, check out [pihole-updatelists](https://github.com/jacklul/pihole-updatelists) which will also run great on a Pi.\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "A tool for quickly and easily bulk adding allowlists and ad/blocklists to a Pi-hole 5 installation",
"version": "0.6.2",
"project_urls": {
"Bug Tracker": "https://github.com/jessedp/pihole5-list-tool/issues",
"Homepage": "https://github.com/jessedp/pihole5-list-tool",
"Source Code": "https://github.com/jessedp/pihole5-list-tool"
},
"split_keywords": [
"pihole",
"pi-hole",
"blacklist",
"blocklist",
"whitelist",
"allowlist",
"adlist"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7b2ac8c3fa913777bb283815500600a5860e7f2db6c962ba8f94a969a6ce8eaf",
"md5": "232aa5c059cecc3bb7bf670f2ed51e49",
"sha256": "f19efea136ded52c0cf1f38675ff4fcea26edcc01888b21387393523668fc150"
},
"downloads": -1,
"filename": "pihole5_list_tool-0.6.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "232aa5c059cecc3bb7bf670f2ed51e49",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 15688,
"upload_time": "2023-05-08T20:18:43",
"upload_time_iso_8601": "2023-05-08T20:18:43.075016Z",
"url": "https://files.pythonhosted.org/packages/7b/2a/c8c3fa913777bb283815500600a5860e7f2db6c962ba8f94a969a6ce8eaf/pihole5_list_tool-0.6.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ffe8d3efc6650f8d29b7cf3af301e3d4a8fcfc6e1496a3a3486724b809077bad",
"md5": "63d59cde99e4386b6af6bf860c55d967",
"sha256": "b13545792e039aee5b46b52a72b59fed09d63009e7f8f33026e9ba5ffac0adde"
},
"downloads": -1,
"filename": "pihole5-list-tool-0.6.2.tar.gz",
"has_sig": false,
"md5_digest": "63d59cde99e4386b6af6bf860c55d967",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 13596,
"upload_time": "2023-05-08T20:18:45",
"upload_time_iso_8601": "2023-05-08T20:18:45.182482Z",
"url": "https://files.pythonhosted.org/packages/ff/e8/d3efc6650f8d29b7cf3af301e3d4a8fcfc6e1496a3a3486724b809077bad/pihole5-list-tool-0.6.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-08 20:18:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jessedp",
"github_project": "pihole5-list-tool",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "pihole5-list-tool"
}
JSON
