eduVPN Albert Plugin

A simple and convenient Albert launcher plugin to connect and disconnect from eduVPN directly from the launcher.

Prerequisites

• Albert launcher (version 0.23 or later)
• eduvpn-cli

Installation

1. Clone this repository into your Albert Python plugins directory:

cd ~/.local/share/albert/python/plugins/
git clone https://github.com/RubenLWF/albert-eduvpn.git

2. Restart Albert or reload the plugins

3. Enable the eduVPN plugin in Albert settings (Extensions → eduVPN)

Configuration

1. Open Albert settings
2. Navigate to Extensions → eduVPN
3. Configure the following:
   • Institution Name: Your educational institution's name (e.g., "Eindhoven University of Technology")
   • Profile Number: The VPN profile number to use (default: 1)

Usage

Trigger the plugin

Type ev followed by a space in Albert to activate the plugin.

Available commands

• Connect to VPN:
  • Type: ev connect or ev up
  • The plugin will automatically connect to your configured institution
• Disconnect from VPN:
  • Type: ev disconnect or ev down
  • Disconnects from the current VPN connection

First-time use

On first connection, you will need to authenticate through your browser (this is handled by eduvpn-cli).

How it works

The plugin uses eduvpn-cli in the background to manage VPN connections. It automatically handles:

• Institution selection confirmation
• Profile number selection
• Background process management

Links

• eduVPN
• eduvpn-cli on GitHub
• Albert Launcher