Skip to content

Latest commit

 

History

History
76 lines (60 loc) · 2.91 KB

README.md

File metadata and controls

76 lines (60 loc) · 2.91 KB

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