AlexBild GitHub avatar

CICADA-VPN-Switcher

AlexBild

A Windows utility that toggles AmneziaVPN on/off using a single global hotkey.

Stars

4

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

Solves a specific need for quick VPN switching with privacy-focused design and no telemetry.

Who it is for

  • Windows users who frequently toggle AmneziaVPN
  • Users wanting a dedicated hardware-like hotkey for VPN
  • Privacy-conscious users seeking minimal data collection
  • AmneziaVPN users on Windows 10/11

Use cases

  • Quickly enable or disable VPN while working
  • Automatically start VPN with Windows boot
  • Assign a single key to toggle VPN without interfering with other apps
  • Manage multiple AmneziaVPN connections via index selection

Strengths

  • Low-level keyboard hook suppresses default key actions
  • No telemetry, analytics, or network requests
  • Self-contained EXE requires no .NET runtime installation
  • Open source under MIT license with transparent code signing policy

Considerations

  • Only works with AmneziaVPN (not a generic VPN tool)
  • Requires Windows 10/11 x64 and AmneziaVPN 4.8.12.9+
  • Installer not commercially signed, triggers SmartScreen warning

README quick start

CICADA VPN Switcher

Небольшая утилита для Windows, которая включает и выключает AmneziaVPN одной глобальной горячей клавишей.

Проект не связан с AmneziaVPN и не является официальным продуктом команды AmneziaVPN.

Возможности

  • выбор одиночной функциональной клавиши или сочетания с Ctrl, Alt и Shift;
  • подавление прежнего действия выбранной клавиши, пока программа запущена;
  • подключение и отключение AmneziaVPN;
  • значок состояния и меню в системном трее;
  • переназначение горячей клавиши;
  • автоматический запуск вместе с Windows;
  • выбор номера подключения AmneziaVPN;
  • уведомления о состоянии VPN;
  • установка без прав администратора;
  • автономный EXE — отдельная установка .NET не требуется.

Требования

  • Windows 10 или Windows 11 x64;
  • AmneziaVPN 4.8.12.9 или новее;
  • хотя бы одно заранее настроенное и проверенное подключение в AmneziaVPN.

Установка

  1. Откройте раздел Releases.
  2. Скачайте CICADA-VPN-Switcher-Setup-v1.0.0.exe.
  3. При необходимости сравните SHA-256 с файлом SHA256.txt.
  4. Запустите установщик.
  5. Выберите горячую клавишу и номер подключения.
  6. Нажмите Сохранить.

По умолчанию используется подключение с индексом 0. Индексация начинается с нуля: первое подключение — 0, второе — 1, четвёртое — 3.

Как работает перехват клавиши

Программа устанавливает низкоуровневый клавиатурный hook Windows и проверяет только выбранную пользователем клавишу и модификаторы. Назначенное на неё действие не передаётся Windows, браузеру или другим приложениям. После закрытия CICADA VPN Switcher исходное поведение клавиши возвращается.

Программа не записывает ввод с клавиатуры и не хранит историю нажатий.

Конфиденциальность и безопасность

  • нет телеметрии, аналитики и рекламных модулей;
  • нет сетевых запросов к сторонним сервисам;
  • VPN-ключи, конфигурации и учётные данные не читаются и не сохраняются;
  • настройки хранятся локально в профиле текущего пользователя;
  • для управления используется официальный параметр запуска AmneziaVPN и её локальный служебный канал;
  • исходный код открыт для проверки.

Текущий установщик не подписан коммерческим сертификатом, поэтому Microsoft SmartScreen может показать предупреждение «Неизвестный издатель».

Сборка из исходников

Требуется .NET 8 SDK:

dotnet publish .\CicadaVpnSwitcher.csproj `
  -c Release `
  -r win-x64 `
  --self-

Description

Windows tray utility for toggling AmneziaVPN with a configurable global hotkey.

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
l0ng-ai
Featured
l0ng-ai GitHub avatar

tty7

tty7 is a fast, GPU-accelerated terminal workbench with persistent sessions, built-in input tools, SSH support, and coding agent awareness.

Developer ToolsCLI & Terminal
359
programmersd21
Featured
programmersd21 GitHub avatar

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

Developer ToolsCLI & Terminal
277