2.6 KiB
2.6 KiB
Game Bar
An overlay for DankMaterialShell.
Widgets
| Widget | Contents |
|---|---|
| Audio | Master output volume + mute, output device switching, microphone volume + mute, input device switching |
| Apps | Per-application volume sliders with individual mute, app icon and what is playing |
| Performance | CPU (usage, temperature), memory (used / total), network (rx/tx), disk (root usage, read/write) |
| Home | Home Assistant entities you pick: lights (toggle + brightness), numbers (slider over the entity's own min/max/step), switches/fans, media players (volume, mute, play/pause), covers, scenes and scripts, plus read-only sensors |
Home Assistant
Settings → Plugins → Game Bar:
- Home Assistant URL, e.g.
http://homeassistant.local:8123 - Long-lived access token — HA profile page → Security → Create token.
It is stored in
plugin_settings.json, which is world-readable by default (chmod 600it if that matters to you). - Refresh, then tick the entities you want in the Home widget.
State is polled (default every 5 s) only while the Home widget is open. The token is handed to
curl through the process environment, so it never shows up in the process list.
If a refresh fails, dms ipc call gameBar homeStatus shows what the plugin actually sent and got
back. A 401 means Home Assistant rejected the token; compare with
curl -H "Authorization: Bearer <token>" https://your-ha/api/
Note that editing plugin_settings.json by hand does not reach a running shell.
IPC commands
| Command | Effect |
|---|---|
dms ipc call gameBar toggle |
Toggle the overlay |
dms ipc call gameBar open |
Open the overlay |
dms ipc call gameBar close |
Close the overlay |
dms ipc call gameBar widget audio|apps|home|system |
Show/hide one widget |
dms ipc call gameBar homeToggle <entity_id> |
Toggle an entity (activates a scene/script/button) |
dms ipc call gameBar homeRefresh |
Re-poll Home Assistant now |
dms ipc call gameBar homeStatus |
Print URL, token length, HTTP status, entity/picked counts and last error |
dms ipc call gameBar resetLayout |
Forget all saved widget positions |
Settings
Settings → Plugins → Game Bar (gear icon):
- Background dimming — how dark the desktop behind the overlay gets (0–95%).
- Home Assistant — URL, access token, refresh interval, and the entity picker.
- Reset widget positions — back to the default arrangement on every monitor.
License
MIT