Skip to main content

routedel

Delete, add, list and monitor IPv4 routes on Linux, with notifications to multiple ntfy and Growl (GNTP) servers.

Install

pip install routedel
pip install "routedel[clipboard]"   # optional: read route rows from the clipboard

Usage

routedel -l                                    # list routes
routedel -m 100                                # delete route(s) by metric
routedel 0.0.0.0 192.168.1.1 0.0.0.0 UG 100 0 0 eth0   # delete a full `route -n` row
routedel 0.0.0.0 192.168.1.1 100 eth0          # legacy: X GW METRIC DEV (default route)
routedel c                                     # delete using a route row from the clipboard
sudo routedel -a 10.0.0.0/8 -g 192.168.1.1 -i eth0 --met 50   # add route
sudo routedel -a -d -g 192.168.1.1 -i eth0 --met 100          # add default route
routedel --monitor --refresh 2                 # live monitor, notifies on changes

Route changes need root.

Notifications

Any number of servers of each type. Via CLI (repeatable):

routedel -m 100 --ntfy https://ntfy.sh/my-routes --ntfy https://ntfy.example.com/alerts \
                --growl 192.168.1.10 --growl 192.168.1.20:23053

Or via a JSON config (first found wins): --config FILE, $ROUTEDEL_CONFIG, ~/.config/routedel/config.json, ~/.routedel.json. CLI targets are added to the config targets.

{
  "ntfy":  [{"url": "https://ntfy.sh", "topic": "my-routes", "token": "tk_xxx"},
            {"url": "https://ntfy.example.com", "topic": "alerts", "user": "u", "password": "p"}],
  "growl": [{"host": "192.168.1.10", "port": 23053, "password": "secret"},
            {"host": "192.168.1.20"}]
}

Test with routedel --test-notify. Disable with --no-notify. Servers are contacted in parallel; one failing server does not affect the others. Dependencies for notifications: none (stdlib urllib + raw GNTP 1.0 over sockets).

License

MIT

Development & release

pip install -e ".[dev]" && pytest
python -m build && twine check dist/*

Release to PyPI (GitHub Actions, Trusted Publishing — no token needed):

  1. On pypi.org → Publishing → add a pending publisher: owner cumulus13, repo routedel, workflow publish.yml, environment pypi. (Repeat on test.pypi.org with environment testpypi if wanted.)
  2. In the GitHub repo create environments pypi (and testpypi).
  3. Bump version in pyproject.toml and src/routedel/__init__.py, commit, then publish a GitHub Release tagged vX.Y.Z. The workflow tests, checks tag == version, builds and uploads.

Manual alternative: twine upload dist/* (API token).

👤 Author

Hadi Cahyadi

Buy Me a Coffee

Donate via Ko-fi

Support me on Patreon

Metadata

Release files for routedel 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for routedel 1.0.3
File Size Uploaded Provenance Actions
routedel-1.0.3.tar.gz 26.8 kB With provenance Details for routedel-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for routedel 1.0.3
File Interpreter ABI Platform Actions
routedel-1.0.3-py3-none-any.whl Python 3 none any Details for routedel-1.0.3-py3-none-any.whl

Total release size: 39.8 kB

Release files / routedel-1.0.3.tar.gz

Download URL routedel-1.0.3.tar.gz
Size 26.8 kB
Tags Source
SHA-256 checksum
How to use checksums
622d5f2e5c424c5d1fb681b06dc67da57493a5aaa3daff6b82420b3e6412c63c
BLAKE2b-256 checksum
How to use checksums
9cbcc84b145a2e7a934f49bd0497073034b23e4e15b5fc4342076c532bc144d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / routedel-1.0.3-py3-none-any.whl

Download URL routedel-1.0.3-py3-none-any.whl
Size 13.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b7bdf74539ea13413df600a025befba263bb464ff966ea44ec7359b2fefe5d09
BLAKE2b-256 checksum
How to use checksums
e8efb73b3698b9654abfad68660c8dc27a4b264a8d78e2ac4f915a22ce723745
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Security for routedel 1.0.3

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for routedel-1.0.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page