feat: add native gamepad support for toolbar navigation and capture, and update to version 2.0.0

Author: JDKamalakar

README.md

@@ -18,7 +18,7 @@ A high-end, glassmorphic floating pill toolbar for the Dank Material Shell. Seam
 
 [![DMS Plugin Gallery](https://img.shields.io/badge/DMS-Plugin%20Gallery-06599d?style=flat-square&logo=linux&logoColor=white)](https://danklinux.com/plugins)
 
-*Requires Dank Material Shell (DMS) 1.0 or higher.*
+_Requires Dank Material Shell (DMS) 1.0 or higher._
 
 ## Requirements
 
@@ -28,15 +28,16 @@ To ensure all features work correctly, the following dependencies are recommende
 <summary><b>View System Dependencies</b></summary>
 <div align="left">
 
-*   **Dank Material Shell (DMS)** 1.0 or higher.
-*   **slurp**: Required for **Interactive Mode** region selection.
-*   **gpu-screen-recorder**: Required for high-performance video recording.
-*   **jq**: Required for automatic monitor detection in video mode (parses compositor JSON output).
+- **Dank Material Shell (DMS)** 1.0 or higher.
+- **slurp**: Required for **Interactive Mode** region selection.
+- **gpu-screen-recorder**: Required for high-performance video recording.
+- **jq**: Required for automatic monitor detection in video mode (parses compositor JSON output).
 
 ```bash
 # Debian/Ubuntu
 sudo apt install slurp gpu-screen-recorder jq
 ```
+
 ```bash
 # Fedora
 sudo dnf install slurp gpu-screen-recorder jq
@@ -47,13 +48,15 @@ sudo dnf install slurp gpu-screen-recorder jq
 
 ## Keyboard Shortcuts
 
-The toolbar supports the following keyboard interactions when open:
-
+<details>
+<summary><b>View Keyboard Shortcuts</b></summary>
 <div align="left">
 
-*   **`Space`**: Trigger capture or start/stop recording (configurable behavior).
-*   **`Ctrl + Space`**: Secondary capture mode (typically "Edit Mode", can be swapped or disabled in settings).
-*   **`Escape`**: Dismiss the toolbar.
+The toolbar supports the following keyboard interactions when open:
+
+- **`Space`**: Trigger capture or start/stop recording (configurable behavior).
+- **`Ctrl + Space`**: Secondary capture mode (typically "Edit Mode", can be swapped or disabled in settings).
+- **`Escape`**: Dismiss the toolbar.
 
 If the editor pipe command is empty, the toolbar uses:
 
@@ -63,38 +66,51 @@ If the editor pipe command is empty, the toolbar uses:
 
 If `satty` is not installed, a notification is shown so you can install it or set a custom editor pipe command such as `swappy -f -`.
 
-</div>
-
-<div align="center">
-
+You can customize the power-user workflow in the settings:
 
-## Requirements
+- **Swap Shortcuts**: Exchange the functionality of `Space` and `Ctrl + Space`.
+- **Disable Editor Shortcut**: Completely remove the `Ctrl + Space` interaction and UI hint.
 
-You can customize the power-user workflow in the settings:
 </div>
+</details>
 
+## Controller Shortcuts <img src="https://img.shields.io/badge/BETA-0877d2?style=flat" alt="BETA" valign="middle">
+
+<details>
+<summary><b>View Controller Shortcuts</b></summary>
 <div align="left">
 
-*   **Swap Shortcuts**: Exchange the functionality of `Space` and `Ctrl + Space`.
-*   **Disable Editor Shortcut**: Completely remove the `Ctrl + Space` interaction and UI hint.
+The toolbar fully supports native gamepad and controller interactions without third-party mapping software:
+
+- **`D-Pad Up` / `Left Stick Up`**: Open the Monitor Selection Popup.
+- **`D-Pad Right` / `Left Stick Right`**: Open the Capture Delay Popup.
+- **`D-Pad Down` / `Left Stick Down`**: Open Settings/Options Popup.
+- **`D-Pad (All)` / `Left Stick (All)`**: Navigate focus across buttons, toggles, and dropdowns.
+- **`LT / RT`**: Switch between Capture Modes (Photo / Video).
+- **`LB / RB`**: Switch between Capture Types (Interactive / Monitor / All).
+- **`A Button`**: Trigger capture, start/stop recording, or toggle the focused option.
+- **`B Button`**: Dismiss the toolbar or close the currently active popup.
+- **`Home / Guide`**: Stop an active screen recording (usable while the toolbar is hidden).
 
 </div>
+</details>
 
 ## Features
 
 <div align="left">
 
-* **Premium Glassmorphism**: Translucent, theme-aware "Floating Pill" design with configurable toolbar and recording pill opacity.
-* **Multi-Monitor Recording Pill**: "Click-to-Move" logic with screen-aware positioning, allowing you to move the recording pill across connected displays.
-* **Adaptive Theme Support**: Intelligent UI that dynamically flips icon and text colors between black and white based on your theme brightness for guaranteed visibility.
-* **Smart Recording Pill**: A collapsible, high-frequency overlay that displays live recording duration and provides instant access to stop, pause, and screenshot actions.
-* **Tactile Interaction**: Features playful 360° spins, tilt-and-jump micro-animations, and responsive Dank Ripples on every interactive element.
-* **Dynamic Settings**: A context-aware popup bubble that automatically filters capture settings (FPS, Audio, Formats) based on your active mode (Photo vs. Video).
-* **Flexible Recording Audio**: Record system output audio and microphone input independently.
-* **Separate Output Settings**: Screenshots and recordings can use independent custom directories and filenames.
-* **Versatile Capture**: Native support for interactive region selection, active monitor focus, full-workspace grabbing, and optional `slurp` + `grim` multi-monitor screenshots.
-* **Configurable Capture Delay**: For non-interactive screenshot modes, a **Timer** icon allows choosing 3s, 5s, or 10s delays for capture.
-* **Power Workflow**: Lightning-fast controls with `Spacebar` to trigger captures, `Ctrl+Space` to send a screenshot to the editor, and `Escape` for instant dismissal.
+- **Premium Glassmorphism**: Translucent, theme-aware "Floating Pill" design with configurable toolbar and recording pill opacity.
+- **Multi-Monitor Recording Pill**: "Click-to-Move" logic with screen-aware positioning, allowing you to move the recording pill across connected displays.
+- **Adaptive Theme Support**: Intelligent UI that dynamically flips icon and text colors between black and white based on your theme brightness for guaranteed visibility.
+- **Smart Recording Pill**: A collapsible, high-frequency overlay that displays live recording duration and provides instant access to stop, pause, and screenshot actions.
+- **Tactile Interaction**: Features playful 360° spins, tilt-and-jump micro-animations, and responsive Dank Ripples on every interactive element.
+- **Dynamic Settings**: A context-aware popup bubble that automatically filters capture settings (FPS, Audio, Formats) based on your active mode (Photo vs. Video).
+- **Flexible Recording Audio**: Record system output audio and microphone input independently.
+- **Separate Output Settings**: Screenshots and recordings can use independent custom directories and filenames.
+- **Versatile Capture**: Native support for interactive region selection, active monitor focus, full-workspace grabbing, and optional `slurp` + `grim` multi-monitor screenshots.
+- **Configurable Capture Delay**: For non-interactive screenshot modes, a **Timer** icon allows choosing 3s, 5s, or 10s delays for capture.
+- **Power Workflow**: Lightning-fast controls with `Spacebar` to trigger captures, `Ctrl+Space` to send a screenshot to the editor, and `Escape` for instant dismissal.
+- **Controller Support** <img src="https://img.shields.io/badge/BETA-0877d2?style=flat" alt="BETA" valign="middle">: Navigate, configure, and capture entirely via gamepads and controllers using native IPC events and zero external mapping software.
 
 </div>
 
@@ -104,8 +120,8 @@ You can customize the power-user workflow in the settings:
 
 To open the toolbar from a keyboard shortcut, add an entry in **DMS Settings** -> **Keyboard Shortcuts**:
 
-* Type: `Run a program`
-* Action: `dms ipc call screenCaptureToolbar toggle`
+- Type: `Run a program`
+- Action: `dms ipc call screenCaptureToolbar toggle`
 
 </div>
 

Settings.qml

@@ -757,7 +757,7 @@ PluginSettings {
                     ToggleSetting {
                         width: parent.width - 22 - Theme.spacingM
                         settingKey: "enableController"
-                        label: "Enable Controller Support"
+                        label: "Enable Controller Support (BETA)"
                         description: "Allow gamepads to trigger and navigate the toolbar via IPC"
                         defaultValue: false
                     }

gamepad_listener.py

@@ -86,15 +86,15 @@ def scan_devices():
                     if is_pressed and not was_pressed:
                         if number == 2: btn_name = "LT"
                         elif number == 5: btn_name = "RT"
-                        elif number == 6: btn_name = "RIGHT"
-                        elif number == 7: btn_name = "DOWN"
+                        elif number == 6 or number == 0: btn_name = "RIGHT"
+                        elif number == 7 or number == 1: btn_name = "DOWN"
                     axis_state[f"{f.fileno()}_{number}_pos"] = is_pressed
 
                     is_neg = value < -16000
                     was_neg = axis_state.get(f"{f.fileno()}_{number}_neg", False)
                     if is_neg and not was_neg:
-                        if number == 6: btn_name = "LEFT"
-                        elif number == 7: btn_name = "UP"
+                        if number == 6 or number == 0: btn_name = "LEFT"
+                        elif number == 7 or number == 1: btn_name = "UP"
                     axis_state[f"{f.fileno()}_{number}_neg"] = is_neg
 
                 if btn_name:

plugin.json

@@ -3,7 +3,7 @@
   "name": "Screen Capture Toolbar",
   "description": "Premium pill-shaped toolbar for quick screenshots and screen recording",
   "category": "utilities",
-  "version": "1.3.4",
+  "version": "2.0.0",
   "author": "JDKamalakar",
   "icon": "screenshot_region",
   "type": "daemon",