hostsd - A simple hosts file manager
hostsd is a simple hosts file manager that allows you to separate your hosts file into multiple files and easily enable or disable them. It's useful for development environments where you need to manage lots of hosts entries, or for managing ad-blocking hosts files.
Dependencies
- Python 3.8 or later (earlier versions may work but are untested)
- Linux or macOS (should work on Windows too but is untested)
Installation
pip install hostsd
Now, to ensure that your existing /etc/hosts contents are retained, you can copy the file to /etc/hosts.d/00-original:
sudo mkdir /etc/hosts.d
sudo cp /etc/hosts /etc/hosts.d/00-original
Usage
To write the contents of /etc/hosts.d/* to /etc/hosts:
sudo hostsd
You can also specify the input and output paths:
hostsd -i /etc/hosts.d -o /etc/hosts
Excluding files
There are several ways to exclude files and directories from being included in the output:
- You can disable a file or directory by adding a
.disabledextension:
mv /etc/hosts.d/10-my-file /etc/hosts.d/10-my-file.disabled
- Hidden files and directories are ignored as well:
mv /etc/hosts.d/regular-file /etc/hosts.d/.hidden-file
- You can include the magic string
HOSTSD_IGNOREwithin a file to exclude it from the output, for example as a comment:
echo "# HOSTSD_IGNORE" >> /etc/hosts.d/10-my-file
- Any binary files are automatically ignored.
Note that files are not currently checked for validity, so your hosts.d directory should only contain valid hosts file entries or files that are excluded using one of the methods above.
Running hostsd automatically
You can run hostsd automatically using a cron job or a systemd timer. Here's an example of a systemd timer (assuming you have installed hostsd globally, for simplicity):
# /etc/systemd/system/hostsd.timer
[Unit]
Description=Update hosts file every minute
[Timer]
OnBootSec=1min
OnUnitActiveSec=1min
[Install]
WantedBy=timers.target
# /etc/systemd/system/hostsd.service
[Unit]
Description=Update hosts file
[Service]
Type=oneshot
ExecStart=/usr/bin/hostsd
sudo systemctl enable hostsd.timer
sudo systemctl start hostsd.timer
This will run hostsd every minute. So you can just drop a new file in /etc/hosts.d and it will be picked up automatically.
You could even combine this with a git repository and you have a simple way to manage your hosts files across multiple machines or share them with others, without needing to set up and manage a full DNS server.
License
hostsd is licensed under the MIT license. See LICENSE for the full license text.
Metadata
Release files for hostsd 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hostsd-0.1.4.tar.gz | 4.9 kB | Without provenance | Details for hostsd-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hostsd-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for hostsd-0.1.4-py3-none-any.whl |
Total release size: 11.0 kB
Release files / hostsd-0.1.4.tar.gz
| Download URL | hostsd-0.1.4.tar.gz |
|---|---|
| Size | 4.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dde747ca06abe367cc9e76e8f5b91d48acaab0096c6e4fca22149339fe59a430
|
|
BLAKE2b-256 checksum How to use checksums |
277afce0fe78d6864ceaf48085775d2b061afd5e93af7ea3784145be01c15383
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.2
|
Release files / hostsd-0.1.4-py3-none-any.whl
| Download URL | hostsd-0.1.4-py3-none-any.whl |
|---|---|
| Size | 6.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5d568f131f4183052989c2cedc57065301a10d37aa8e5f2510f19a7d9c38f5fd
|
|
BLAKE2b-256 checksum How to use checksums |
a958886a33211dd8178e6d23a0dc9b2b85aac62fb2c2afb06f42a988fea34190
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.11.2
|
Security for hostsd 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.