0. Discord plugin troubleshooting

Discord plugin troubleshooting

This page explains the error messages that may appear when using the Linux-native Discord plugin for OpenDeck.

---

Failed to connect to Discord: Could not find the IPC pipe

OpenDeck communicates with Discord over an IPC (inter-process communication) pipe. This error means the pipe could not be found at any of the expected locations on your system.

Possible causes:

• Discord is not installed or not running. Ensure Discord is installed and fully launched before using Discord-related actions in OpenDeck.

• OpenDeck is running as a Flatpak and cannot access Discord's IPC pipe. Flatpak applications run in a sandbox that restricts access to paths outside of it. OpenDeck looks for Discord's IPC pipe at the following locations:

  • /tmp/discord-ipc-*
  • $XDG_RUNTIME_DIR/discord-ipc-*
  • $XDG_RUNTIME_DIR/app/com.discordapp.Discord/discord-ipc-* (Discord installed as a Flatpak)
  • $XDG_RUNTIME_DIR/snap.discord/discord-ipc-* (Discord installed as a Snap)

  If OpenDeck is sandboxed, it may be unable to reach these paths.

Fix (Flatpak installs — using Flatseal):

1. Install Flatseal if you haven't already.
2. Open Flatseal and select OpenDeck from the list.
3. Under Filesystem, grant access to the relevant path(s) for your Discord installation:
   • For a native Discord install: /tmp
   • For a Flatpak Discord install: xdg-run/app/com.discordapp.Discord
   • For a Snap Discord install: xdg-run/snap.discord
4. Restart OpenDeck.

---

Failed to connect to Discord: Could not connect to Discord

The IPC pipe was found, but OpenDeck was unable to establish a connection through it.

Possible causes:

• Discord is not currently running. The pipe may exist as a leftover from a previous session. Make sure Discord is fully launched and try again.

• A third-party Discord client is in use that does not support RPC. OpenDeck connects to Discord via its Rich Presence/IPC (RPC) interface. Some alternative Discord clients do not implement this, which will prevent OpenDeck from connecting even if the client is running. Switch to the official Discord client if you encounter this issue.