Skip to content
/ winot Public

another tool for staying connected to your wireless network(s) all the time on an OpenBSD laptop

License

Notifications You must be signed in to change notification settings

bonds/winot

Repository files navigation

Build Status Coverage Status

This is a service for OpenBSD that keeps you connected to your wireless connections at all times.

Features

  • connects to wwan, wlan (aka wifi), and vpn and reconnects as needed
  • routes traffic via vpn when its available, otherwise it routes traffic via the wwan
  • does NOT route traffic across the wifi except to connect to vpn, in other words, assumes your wifi network is untrusted, i.e. you work at the airport or at cafes on occasion
  • you can turn off the vpn requirement for wlan connections if you're feeling brave and/or safe and/or you can live without it
  • notices when your wifi signal is weak, scans for a stronger BSSID, and connects to it
  • status bar icon that shows your connection status (requires Gnome)

Imgur

Installation

Requirements

  • OpenBSD 5.8 or later
  • Stack
  • icu4c package
  • a wwan adapter with a properly configured pppd peer configured, or a wifi adapter and a wifi network to connect to
  • your wifi intreface is configured through DHCP, i.e. the IP and other info is not statically configured in a hostname.if file

Optional

  • an SSH server with tunneling enabled
  • an SSH agent running with the credentials for accessing your SSH server loaded
  • Gnome, to get the status bar icon

Let's Install It Already

  1. git clone https://github.com/bonds/winot /tmp/winot
  2. cd /tmp/winot
  3. stack build
  4. doas sh /tmp/winot/install.sh
  5. edit /etc/winot and add your settings
  6. doas rcctl start winot

Further Reading

Alternatives

About

another tool for staying connected to your wireless network(s) all the time on an OpenBSD laptop

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published