Skip to content

README.md

Latest commit

 

History

History
81 lines (53 loc) · 1.99 KB

README.md

File metadata and controls

81 lines (53 loc) · 1.99 KB

Tailscale Albert Plugin

A simple and convenient Albert launcher plugin to manage Tailscale connections directly from the launcher.

Prerequisites

Installation

  1. Clone this repository into your Albert Python plugins directory:
cd ~/.local/share/albert/python/plugins/

# Clone with sparse checkout
git clone --filter=blob:none --sparse git@github.com:RubenLWF/albert-plugins.git temp-albert
cd temp-albert
git sparse-checkout set tailscale

# Move everything to a new location
cd ..
mkdir tailscale
mv temp-albert/.git tailscale/
mv temp-albert/tailscale/* tailscale/
rm -rf temp-albert

# Update the working tree
cd tailscale
git reset --hard

  1. Restart Albert or reload the plugins

  2. Enable the Tailscale plugin in Albert settings (Extensions → Tailscale)

Configuration

Initial setup

Before using the plugin, you need to configure Tailscale to allow your user to control it without requiring sudo:

  1. First, log in to Tailscale:
sudo tailscale login
  1. Then, set yourself as the operator:
sudo tailscale set --operator=$USER

After completing these steps, you can use the plugin without entering your password.

Usage

Trigger the plugin

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

Available commands

  • Connect to tailnet:
    • Type: ts up or ts connect
    • Connects to your Tailscale network
  • Disconnect from tailnet:
    • Type: ts down or ts disconnect
    • Disconnects from your Tailscale network

How it works

The plugin uses the tailscale command-line tool in the background to manage your VPN connections. It automatically detects your connection state and provides the appropriate action.

Links