https://github.com/elementary/capnet-assist

Captive Portal Assistant
https://github.com/elementary/capnet-assist

captive-portal gtk gtk3 meson pantheon vala webkit2gtk

Last synced: 3 months ago
JSON representation

Captive Portal Assistant

• Host: GitHub
• URL: https://github.com/elementary/capnet-assist
• Owner: elementary
• License: gpl-3.0
• Created: 2017-03-08T00:19:52.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2025-06-20T11:50:01.000Z (4 months ago)
• Last Synced: 2025-06-20T12:36:37.501Z (4 months ago)
• Topics: captive-portal, gtk, gtk3, meson, pantheon, vala, webkit2gtk
• Language: Vala
• Size: 10.2 MB
• Stars: 64
• Watchers: 26
• Forks: 11
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

          
# Captive Network Assistant

[![Translation status](https://l10n.elementary.io/widgets/desktop/-/capnet-assist/svg-badge.svg)](https://l10n.elementary.io/engage/desktop/?utm_source=widget)

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.

![Screenshot](https://raw.github.com/elementary/capnet-assist/master/data/screenshot.png)

## Building, Testing, and Installation

Run `flatpak-builder` to configure the build environment, download dependencies, build, and install

```bash

flatpak-builder build io.elementary.capnet-assist.yml --user --install --force-clean --install-deps-from=appcenter

```

Then execute with

```bash

flatpak run 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 `-u` to direct the captive login window to a specific URL:

```bash

flatpak run io.elementary.capnet-assist -u https://elementary.io

```

    

An example HTML file is included in this repository, e.g. for screenshots, but note you must give access permission and include a `file://` path:

```bash

flatpak override --user --filesystem=/home/username/Projects/elementary/capnet-assist/data/example.html:ro io.elementary.capnet-assist

flatpak run io.elementary.capnet-assist -u file:///home/username/Projects/elementary/capnet-assist/data/example.html

```