Skip to content

Bayrakovsky/KeenSwitch

KeenSwitch

CI License: MIT macOS 14+

macOS menu bar app for switching IP routing policies on Keenetic routers — without opening the web interface.

Select a device, pick a policy (Default, VPN, No Internet, …), done.

Main window Menu bar
Main window Menu bar

Requirements

  • macOS 14 Sonoma or later
  • Keenetic router running KeeneticOS 3.x or later
  • Network Policy component installed on the router
    (System Components → Network Policy)

Supported routers

Any Keenetic router running KeeneticOS 3.x with the Network Policy component. Tested on:

Series Models
Giga KN-1010, KN-1011, KN-1012
Ultra KN-1810, KN-1811
Viva KN-1912
Giant KN-2610
Peak KN-2710
Hero 4G / 4G+ KN-2310, KN-2311
Duo KN-2111
City KN-1510, KN-1511
Extra KN-1710, KN-1711, KN-1713, KN-1714
Air KN-1610, KN-1611, KN-1613
Lite KN-1310, KN-1311

If your model is not listed but runs KeeneticOS 3.x with the Network Policy component — it should work too.

Features

  • See all devices on the network with their current routing policy
  • Switch any device to a different policy in two clicks
  • Quick access from the menu bar — no need to open the main window
  • Auto-refresh when network connection is restored
  • Launch at login with optional silent start (menu bar only, no Dock icon)
  • Built-in auto-update from GitHub Releases
  • Interface in English and Russian

Installation

  1. Download KeenSwitch-vX.Y.Z-macOS.zip from Releases
  2. Unzip and drag KeenSwitch.app to Applications
  3. On first launch macOS may block an unsigned app — right-click → OpenOpen

Or remove the quarantine flag via Terminal:

xattr -cr /Applications/KeenSwitch.app && open -a KeenSwitch

Setup

On the router: make sure the Network Policy component is installed
(Keenetic web interface → System Components → Network Policy → Install)

In KeenSwitch: open Settings → Connection and enter:

  • Router address — the same URL you use in the browser (e.g. 192.168.1.1)
  • Admin username and password
  • Enable HTTPS if your router requires it

Build from source

Requires Xcode 16 and macOS 14+.

git clone https://github.com/Bayrakovsky/KeenSwitch.git
cd KeenSwitch
open KeenSwitch.xcodeproj
# Product → Run  ⌘R

Contributing

Bug reports, feature requests, and PRs are welcome — see CONTRIBUTING.md for how to set up a dev environment, run the tests, and submit changes. Release history lives in CHANGELOG.md. All participants are expected to follow the Code of Conduct.

Security

Found a vulnerability? Please don't open a public issue — see SECURITY.md for how to report it privately.

License

MIT — see LICENSE.

About

macOS menu bar app for switching IP routing policies on Keenetic routers — without opening the web interface

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors