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.
66 commits 3 branches 0 tags 419 KiB
Find a file
vybe a095abb2b4 chore: verify copyProcess already has proper onExited exit-status check + success toast 
Toast moved out of copyToClipboard() into onExited (code===0 path).
Fallback clipboard rotation also present.
Issue #17 already addressed by existing implementation.
Fixes #17
2026-05-22 06:42:10 +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 fix: remove binaryAvailable, fix statusCheck parser location, add timer guard 2026-05-22 03:13:33 +00:00
test refactor: replace detectClipboard with try-fallback-cached clipboard strategy 2026-05-21 06:37:14 +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 Better scoped semicolon coding style. 2026-05-22 06:06:14 +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.