Multi-action keys with tap/long-press/double-tap/hold, gesture timing, display output colors, global font, and display output JSON/color parsing
- Multi-action system: each key supports multiple actions with different triggers (tap, long_press, double_tap, hold_start, hold_end) - GestureEngine: timing-based gesture detection with configurable thresholds - New config types: KeyAction, TimingConfig, DisplayOutput - Display output now supports JSON format (text/background/text_color) and first-line-as-hex-color format for dynamic key backgrounds - Display background colors are reflected in the web UI on the grid - renderUnicodeText/renderUnicodeTextOnImage accept custom text color (fg) - Global font setting (medium/regular) in Settings UI - PageManager.defaultFont used as fallback for per-key font - Alpine.js bundled locally (no CDN dependency) - Web UI: action tabs (Tap/Long Press/Double Tap/Hold), unified More section with appearance + display settings, gesture timing sliders in Settings - Grid: subtle action type icons in top-left corner matching display indicator style - Backward compatible: old config 'action' field auto-migrated to 'actions' array - M+ 1m font files in assets/ for reference - Updated config.example.json and README with all new features
This commit is contained in:
totmin
@@ -7,10 +7,11 @@
|
||||
## Features
|
||||
|
||||
- **Web-based editor** — Alpine.js SPA for managing pages, keys, icons, and actions
|
||||
- **Multi-action support** — assign shell commands, scripts, page switching, media/volume/brightness controls, and **keyboard shortcuts** to any key
|
||||
- **On-device display** — render icons, text labels, and periodic command output directly on Stream Deck keys
|
||||
- **Multi-action keys** — assign different actions to **tap**, **long press**, **double tap**, and **hold** on the same key
|
||||
- **On-device display** — render icons, text labels, and periodic command output directly on Stream Deck keys; output can include custom background and text colors
|
||||
- **Auto page switching** — automatically change pages based on the focused window (Hyprland, Sway, Niri, GNOME, KDE, X11)
|
||||
- **Screensaver** — dim or blank the deck after a configurable idle timeout
|
||||
- **Gesture timing** — configurable long press (default 500ms) and double tap (default 300ms) thresholds
|
||||
- **Hot-reload** — config changes via the web UI are applied live; manual edits to `config.json` are detected and reloaded automatically
|
||||
- **No cloud, no Electron** — single Go binary with an embedded web frontend
|
||||
|
||||
@@ -50,7 +51,33 @@ Open `http://localhost:9090` in your browser.
|
||||
|
||||
The config file is stored at `~/.config/streamdeck-lets-go/config.json`. You can edit it manually or through the web UI.
|
||||
|
||||
### Key actions
|
||||
### Multi-action keys
|
||||
|
||||
Each key can have multiple actions with different triggers:
|
||||
|
||||
```json
|
||||
{
|
||||
"index": 7,
|
||||
"icon": "fa:chevron-right",
|
||||
"label": "Next",
|
||||
"actions": [
|
||||
{ "trigger": "tap", "type": "builtin", "builtin": "page:next" },
|
||||
{ "trigger": "long_press", "type": "builtin", "builtin": "page:prev" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Supported triggers:
|
||||
|
||||
| Trigger | Behavior |
|
||||
|---|---|
|
||||
| `tap` | Quick press and release |
|
||||
| `long_press` | Held past the threshold (default 500ms) |
|
||||
| `double_tap` | Two taps within the threshold (default 300ms) |
|
||||
| `hold_start` | Fires when held past the threshold |
|
||||
| `hold_end` | Fires on release after a hold |
|
||||
|
||||
### Key action types
|
||||
|
||||
| Type | Field | Description |
|
||||
|---|---|---|
|
||||
@@ -78,10 +105,42 @@ The daemon warns on startup if the required tool is missing.
|
||||
| `volume_up` / `volume_down` / `volume_mute` | PipeWire volume (via `wpctl`) |
|
||||
| `brightness_up` / `brightness_down` | Display brightness (via `brightnessctl`) |
|
||||
| `media_play_pause` / `media_next` / `media_prev` / `media_stop` | MPRIS media (via `playerctl`) |
|
||||
| `page:next` / `page:prev` | Switch to next/previous page |
|
||||
| `deck:brightness-up` / `deck:brightness-down` | Cycle deck brightness |
|
||||
|
||||
### Periodic display
|
||||
|
||||
Any key can display the output of a command or script, updated on an interval. Use this for weather, system stats, calendar, etc.
|
||||
Any key can display the output of a command or script, updated on an interval. Use this for weather, system stats, monitoring, etc.
|
||||
|
||||
The command output can include **background color** and **text color** using one of these formats:
|
||||
|
||||
**JSON format:**
|
||||
```json
|
||||
{"text": "Server OK", "background": "#22c55e", "text_color": "#ffffff"}
|
||||
```
|
||||
|
||||
**First-line-as-color format:**
|
||||
```
|
||||
#ff0000
|
||||
Server down!
|
||||
```
|
||||
|
||||
If no color is specified, the key uses its configured background or the default black.
|
||||
|
||||
### Gesture timing
|
||||
|
||||
Configured in the web UI (Settings → Gesture Timing) or in `config.json`:
|
||||
|
||||
```json
|
||||
"timing": {
|
||||
"long_press_ms": 500,
|
||||
"double_tap_ms": 300
|
||||
}
|
||||
```
|
||||
|
||||
### Default font
|
||||
|
||||
Set globally in Settings → Device → Default Font (`"medium"` or `"regular"`), or override per-key in the key editor.
|
||||
|
||||
### Auto-switch rules
|
||||
|
||||
@@ -125,10 +184,10 @@ Dependencies:
|
||||
| Model | PID | Keys |
|
||||
|---|---|---|
|
||||
| Stream Deck Original | `0x006d` | 15 |
|
||||
| Stream Deck Mini | `0x0063` | 6 |
|
||||
| Stream Deck Mini | `0x0060` | 6 |
|
||||
| Stream Deck XL | `0x006c` | 32 |
|
||||
| Stream Deck MK.2 | `0x0080` | 15 |
|
||||
| Stream Deck Pedal | `0x0086` | 3 |
|
||||
| Stream Deck Original V2 | `0x0063` | 15 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user