Add new plugin: Discord Voice

discord-voice/README.md

@@ -0,0 +1,73 @@
+# Discord Voice
+
+Monitor and control a local Discord desktop voice session without leaving Noctalia. The bar widget and panel expose voice state and controls through Discord's local RPC interface.
+
+## Plugin
+
+| Field | Value |
+| --- | --- |
+| ID | `raycursive/discord-voice` |
+| Entries | Bar widget: `bar`; panel: `panel`; service: `bridge` |
+
+## Requirements
+
+- Noctalia with plugin API 9 or newer.
+- `python3` 3.10 or newer on `PATH` for the local Discord RPC bridge.
+- The `discord` desktop client. The default executable is `/usr/bin/discord`; change **Discord executable** if yours is elsewhere.
+
+Discord must be running locally. The bridge detects native, Flatpak, Snap, and common temporary Discord IPC socket locations; the Discord web app alone is not sufficient.
+
+## Usage
+
+Enable `raycursive/discord-voice` in **Settings → Plugins**, then add the `bar` entry from **Settings → Bar → Widgets**.
+
+1. Click the bar widget to open the `panel` entry. If Discord is not running, the first click launches the configured Discord executable.
+2. Select **Authorize Discord** and accept Discord's local consent prompt.
+3. Use the panel to mute, deafen, hang up, adjust your input volume from 0–100%, or adjust another participant's listening volume from 0–200%.
+4. Select saved recent or favorite channels to rejoin them in Discord.
+
+The `bridge` service starts automatically when the plugin is enabled and keeps the bar widget and panel synchronized. Open the panel without the bar widget with:
+
+```sh
+noctalia msg panel-toggle raycursive/discord-voice:panel
+```
+
+## Settings
+
+| Setting | Type | Default | Description |
+| --- | --- | --- | --- |
+| `discord_binary` | `file` | `/usr/bin/discord` | Executable used to launch Discord and open channel deep links. |
+| `glyph` | `glyph` | `brand-discord` | Glyph used by this bar-widget instance when no participant avatar is shown. |
+| `show_channel_name` | `bool` | `true` | Shows the active voice-channel name beside the glyph. |
+| `hide_when_disconnected` | `bool` | `false` | Hides the bar widget while no voice channel is connected. |
+
+## IPC
+
+The `bridge` service accepts these events:
+
+```sh
+# Start Discord's local authorization flow.
+noctalia msg plugin raycursive/discord-voice:bridge all authorize
+
+# Refresh current voice and channel state.
+noctalia msg plugin raycursive/discord-voice:bridge all refresh
+
+# Leave the current voice channel.
+noctalia msg plugin raycursive/discord-voice:bridge all hangup
+
+# Write a token-free state summary to the Noctalia log.
+noctalia msg plugin raycursive/discord-voice:bridge all dump
+```
+
+## Notes
+
+- The plugin requests only the Discord OAuth scopes `rpc`, `rpc.voice.read`, and `rpc.voice.write`. It does not request message, notification, relationship, or guild-member scopes.
+- Authorization sends the code to `https://streamkit.discord.com/overlay/token`. Participant avatars are downloaded from `https://cdn.discordapp.com`; no downloaded content is executed.
+- The Python bridge connects to Discord and to its own control channel over local Unix sockets. Noctalia spawns the bridge, and the bar or panel may spawn the configured Discord executable.
+- The access token is stored at `$NOCTALIA_STATE_HOME/noctalia/discord-voice/token.json`, or under `$XDG_STATE_HOME` when the Noctalia override is unset. Recent and favorite channel metadata is stored beside it in `channels.json`. The directory uses mode `0700` and both files use mode `0600`.
+- Participant avatars are cached under `$XDG_CACHE_HOME/noctalia/discord-voice/avatars/`. The bridge's control socket is created under `$XDG_RUNTIME_DIR`, with a per-user `/tmp` fallback, and removed on a clean shutdown.
+- Discord's StreamKit token exchange does not provide a refresh token. Authorize again after the access token expires.
+- Voice levels changed through Discord RPC belong to the active integration; Discord may restore previous levels when the bridge disconnects.
+- The bridge reconnects after Discord restarts. The integration depends on Discord's public StreamKit identity and token broker, which Discord may change.
+
+The authorization design was from [`PandorasFox/dms-discord-widget`](https://github.com/PandorasFox/dms-discord-widget).

discord-voice/bar.luau

@@ -0,0 +1,143 @@
+--!nonstrict
+
+local PANEL_ID = "raycursive/discord-voice:panel"
+local snapshot = noctalia.state.get("voice_snapshot") or {
+  status = "starting",
+  status_message = "",
+  channel = nil,
+  recent_channels = {},
+  favorite_channels = {},
+  participants = {},
+  voice = { mute = false, deaf = false, input_volume = 100 },
+  connection = { state = "DISCONNECTED", average_ping = 0 },
+  connected_since = nil,
+}
+
+local tr = noctalia.tr
+
+local function shortened(text, limit)
+  local length = utf8.len(text)
+  if length <= limit then
+    return text
+  end
+  local cut = utf8.offset(text, limit + 1)
+  return text:sub(1, cut - 1) .. "…"
+end
+
+local function activeSpeaker()
+  for _, participant in ipairs(snapshot.participants) do
+    if participant.speaking then
+      return participant
+    end
+  end
+  return nil
+end
+
+local function statusLabel()
+  if snapshot.status == "auth_required" then
+    return tr("bar.authorize")
+  elseif snapshot.status == "authorizing" or snapshot.status == "authenticating" then
+    return tr("bar.authorizing")
+  elseif snapshot.status == "discord_unavailable" then
+    return tr("bar.offline")
+  elseif snapshot.status == "error" then
+    return "!"
+  end
+  return ""
+end
+
+local function render()
+  local disconnected = snapshot.channel == nil
+  if disconnected and noctalia.getConfig("hide_when_disconnected") == true then
+    barWidget.setVisible(false)
+    return
+  end
+  barWidget.setVisible(true)
+
+  local glyph = noctalia.getConfig("glyph")
+  if type(glyph) ~= "string" or glyph == "" then
+    glyph = "brand-discord"
+  end
+
+  local children = {}
+  local voice = snapshot.voice
+  local speaker = activeSpeaker()
+  local glyphColor = "on_surface_variant"
+  if speaker ~= nil then
+    glyphColor = "primary"
+  elseif not disconnected then
+    glyphColor = (voice.mute or voice.deaf) and "error" or "primary"
+  elseif snapshot.status == "error" then
+    glyphColor = "error"
+  end
+  if speaker and speaker.avatar_path ~= "" then
+    table.insert(children, ui.image({
+      key = "speaker:" .. speaker.id,
+      path = speaker.avatar_path,
+      width = 20,
+      height = 20,
+      radius = 10,
+      fit = "cover",
+      border = "primary",
+      borderWidth = 2,
+    }))
+  elseif speaker then
+    table.insert(children, ui.glyph({ name = "volume", size = 16, color = glyphColor }))
+  else
+    table.insert(children, ui.glyph({ name = glyph, size = 15, color = glyphColor }))
+  end
+
+  if disconnected then
+    local label = statusLabel()
+    if label ~= "" then
+      table.insert(children, ui.label({ text = label, color = "on_surface_variant", fontSize = 12 }))
+    end
+  else
+    if noctalia.getConfig("show_channel_name") ~= false then
+      table.insert(children, ui.label({
+        text = shortened(snapshot.channel.name, 18),
+        color = "on_surface",
+        fontWeight = "bold",
+      }))
+    end
+    table.insert(children, ui.label({
+      text = tostring(#snapshot.participants),
+      color = "on_surface_variant",
+      fontSize = 12,
+    }))
+  end
+
+  local container = barWidget.isVertical() and ui.column or ui.row
+  barWidget.render(container({ gap = 6, align = "center", paddingH = 4, paddingV = 2 }, children))
+  barWidget.setTooltip({})
+end
+
+noctalia.state.watch("voice_snapshot", function(value)
+  if type(value) == "table" then
+    snapshot = value
+    render()
+  end
+end)
+
+noctalia.setUpdateInterval(1000)
+render()
+
+function update()
+  render()
+end
+
+function onClick()
+  if snapshot.status == "discord_unavailable" then
+    local binary = noctalia.getConfig("discord_binary")
+    if type(binary) ~= "string" or binary == "" then
+      binary = "/usr/bin/discord"
+    end
+    noctalia.runAsync("'" .. binary:gsub("'", "'\\''") .. "'")
+    return
+  end
+  noctalia.togglePanel(PANEL_ID)
+end
+
+function onConfigChanged()
+  render()
+end