diodos
diodos is a CLI daemon that monitors your network and automatically attempts login when a captive portal is detected.
Features
- Checks connectivity on a configurable interval.
- Detects likely captive-portal redirects.
- Submits configured credentials automatically.
- Works with
python -m diodosand the installeddiodoscommand.
Installation
With uv (recommended)
Install as a global CLI tool:
uv tool install diodos
Run without installing globally:
uvx diodos run
With pip (alternative)
pip install diodos
From source
git clone <your-repo-url>
cd Diodos
uv sync
Usage
diodos run
Or:
python -m diodos run
On first run, diodos creates a default config file and opens it for editing.
Configuration
Default config path:
- Linux:
~/.config/diodos/config.toml(or$XDG_CONFIG_HOME/diodos/config.toml) - macOS:
~/Library/Application Support/diodos/config.toml - Windows:
%APPDATA%/diodos/config.toml
Example:
[network_check]
url = "https://example.com"
msg = "Success"
interval = 60
[login]
url = "https://portal.example.com/login"
[login.credentials]
username = "your-username"
password = "your-password"
Development
Build distributables:
uv build
Validate package metadata:
uvx twine check dist/*
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file diodos-0.1.0.tar.gz.
File metadata
- Download URL: diodos-0.1.0.tar.gz
- Upload date:
- Size: 4.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e0a9d97aea1cb4616612adcf0fb24b65a3a6df4d0d868e0eecf45f2d5791318
|
|
| MD5 |
3d584a8f336ba00e534e713f62a580f7
|
|
| BLAKE2b-256 |
99c26db44d510e6834c3e826bc88ee735218ef81ccee43927bda3f50853f451c
|
Provenance
The following attestation bundles were made for diodos-0.1.0.tar.gz:
Publisher:
publish-pypi.yml on RushiVivek/Diodos
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
diodos-0.1.0.tar.gz -
Subject digest:
4e0a9d97aea1cb4616612adcf0fb24b65a3a6df4d0d868e0eecf45f2d5791318 - Sigstore transparency entry: 2568353179
- Sigstore integration time:
-
Permalink:
RushiVivek/Diodos@f631db26f10b488e39299a09282d1853e65208a9 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/RushiVivek
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@f631db26f10b488e39299a09282d1853e65208a9 -
Trigger Event:
release
-
Statement type:
File details
Details for the file diodos-0.1.0-py3-none-any.whl.
File metadata
- Download URL: diodos-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
33a97905c245ad778d81d753e3fad5a4bf4df068a30830ebf7d4ffdd232188cd
|
|
| MD5 |
facc4a433ad5728b79335bf4b9dc9692
|
|
| BLAKE2b-256 |
a21aa5b9fc4bd1dcbb15e37ca5da4470939cc49a9537fcee2262c7c7256e6b37
|
Provenance
The following attestation bundles were made for diodos-0.1.0-py3-none-any.whl:
Publisher:
publish-pypi.yml on RushiVivek/Diodos
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
diodos-0.1.0-py3-none-any.whl -
Subject digest:
33a97905c245ad778d81d753e3fad5a4bf4df068a30830ebf7d4ffdd232188cd - Sigstore transparency entry: 2568353180
- Sigstore integration time:
-
Permalink:
RushiVivek/Diodos@f631db26f10b488e39299a09282d1853e65208a9 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/RushiVivek
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@f631db26f10b488e39299a09282d1853e65208a9 -
Trigger Event:
release
-
Statement type:
