jtmorris/dms_tailscalectl
1
0
Fork 0
Code Issues 2 Pull requests Projects Releases Packages Activity Actions
A Dank Material Shell plugin for controlling the user's Tailscale connection.
31 commits 3 branches 0 tags 419 KiB
Find a file
vybe 93b257ba5d refactor: delegate shell command construction to lib.js functions 
Replace inline shell command building in QML with calls to
parseClipboardDetection, parseStatusResult, buildToggleCommand, and
buildCopyCommand. This centralizes sanitization logic and removes
duplicated try/catch and ternary blocks from the UI layer.
2026-05-20 19:37:08 +00:00
docs/agents docs: add git workflow rules and update AGENTS.md 2026-05-20 08:57:45 +00:00
resources Added screenshot. Added ignore for working files not appropriate for the repo. 2026-05-18 17:16:31 -07:00
tailscalectl refactor: delegate shell command construction to lib.js functions 2026-05-20 19:37:08 +00:00
test feat: add parseStatusResult for safe JSON parsing of tailscale status 2026-05-20 19:29:02 +00:00
.gitignore Added screenshot. Added ignore for working files not appropriate for the repo. 2026-05-18 17:16:31 -07:00
AGENTS.md docs: add git workflow rules and update AGENTS.md 2026-05-20 08:57:45 +00:00
LICENSE fix(initialize-project): make AGENTS.md agent-agnostic, add remote prompt, show full drafts 2026-05-15 17:00:46 -07:00
README.md docs: add screenshot to README 2026-05-19 00:20:09 +00:00

README.md

Tailscale Widget Plugin for Dank Material Shell

A lightweight widget plugin that shows Tailscale connectivity status on the Dank Bar with quick controls for toggling connection, switching exit nodes, and copying peer addresses.

Tailscale Widget v0.1.0

Features

  • Status icon in the bar — vpn_key when connected, vpn_key_off when disconnected
  • Right-click to toggle Tailscale on/off
  • Left-click to open a popout showing:
    • Your current Tailscale IP
    • Active exit node (with clear button)
    • Peer list with hostnames and IPs
  • Click-to-copy any hostname or IP to clipboard
  • Exit node selection — click ↗ on any exit-node-capable peer to route through it
  • Auto-refresh — status polls every 5 seconds
  • Toast notifications for all errors

Requirements

  • Dank Material Shell installed and running
  • tailscale CLI available on PATH
  • A clipboard tool (dms, wl-copy, or clipmanctl)

Installation

  1. Clone or copy this repository so that the tailscalectl/ directory is available:

    git clone <repo-url>

  2. Place the tailscalectl/ directory into your DMS plugins directory:

    mv tailscalectl ~/.config/dankmaterialshell/plugins/

    The directory must contain:

    tailscalectl/
├── plugin.json
├── TailscaleWidget.qml
└── lib.js

  3. Reload the plugin:

    dms ipc call plugins reload tailscalectl

  4. The Tailscale icon should appear on your Dank Bar. If connected, it shows a filled key icon; if disconnected, an outlined key icon.

Usage

Action How
Toggle connection Right-click the bar icon
Open popout Left-click the bar icon
Copy hostname/IP Click the text in the peer list
Set exit node Click ↗ next to an exit-node peer
Clear exit node Click × next to "Exit node: ..." or click ↗ on current node

Plugin Manifest

{
  "id": "tailscalectl",
  "name": "Tailscale",
  "description": "Tailscale status and controls on the Dank Bar",
  "version": "0.1.0",
  "author": "John Morris & Vybe (AI Slop... er... Coding Assistant)",
  "icon": "vpn_key",
  "type": "widget",
  "component": "./TailscaleWidget.qml",
  "permissions": ["settings_read", "settings_write", "process"]
}

Testing

node --test test/lib.test.js

License

See LICENSE.