Captive Network Assistant
Log into captive portals—like Wi-Fi networks at coffee shops, airports, and trains—with ease. Captive Network Assistant automatically opens to help you get connected.
Building, Testing, and Installation
You'll need the following dependencies:
- libgcr-3-dev
- libglib2.0-dev
- libgranite-dev
- libgtk-3-dev
- libhandy-1-dev >= 1.0.0
- libwebkit2gtk-4.0-dev
- meson
- valac
Run meson to configure the build environment and then ninja test to build and run automated tests
meson build --prefix=/usr
ninja test
To install, use ninja install, then execute with captive-login
sudo ninja install
io.elementary.capnet-assist
Debugging
Set the environment variable G_MESSAGES_DEBUG to "all" to have the captive-login binary print debug messages.
Use the flag -f to force the captive login window to show even if no captive portal is detected:
io.elementary.capnet-assist -f
Use the flag -u to direct the captive login window to a specific URL. This may not show a window without -f if no captive portal is detected:
io.elementary.capnet-assist -fu https://elementary.io
An example HTML file is included in this repository, e.g. for screenshots, but note you must include a file:// path:
io.elementary.capnet-assist -fu file:///home/username/Projects/elementary/capnet-assist/data/example.html