Bihart / elcord-wsl

Discord Rich Presence for Emacs on WSL

elcord-wsl

Discord Rich Presence for Emacs on WSL

elcord-wsl uses discord-rpc and pm2

Setup

• Ensure Node.js is installed on Windows.
• Ensure PM2 is installed on WSL.
• On WSL, get the path of node on Windows with whereis node
• Clone this repository and define the path.
• cd and npm install to install dependencies.
• Include this snippet in your init file and customise the paths.

;; do not use `straight-use-package`
(use-package elcord-wsl
  :load-path "~/.emacs.d/elcord-wsl" ;; customise the path
  :custom
  (elcord-wsl--load-path "~/.emacs.d/elcord-wsl") ;; customise the path
  (elcord-wsl--node-path "/mnt/c/Program Files/nodejs/node.exe")) ;; customise the path

Interactive Functions

Functions	Description
M-x elcord-wsl--connect	Starts the process
M-x elcord-wsl--disconnect	Deletes the process

---

elcord-wsl--connect might take very long to start, do not use this on startup.
elcord-wsl--disconnect will always be called when killing Emacs, it is added in kill-emacs-hook.

More Custom Symbols

Symbols	Description	Default
elcord-wsl--assets-alist	The art assets for elcord-wsl to load	(("_default" . "_default"))
elcord-wsl--client-id	The client ID of your Discord Application	"698809287564328991"
elcord-wsl--ignored-buffers	The buffers that will not be displayed	("Minibuf")
elcord-wsl--details-function	The function to get the Rich Presence details	(concat "Editing " buf)
elcord-wsl--state-function	The function to get the Rich Presence state	(concat "Line " (format-mode-line "%l"))
elcord-wsl--large-image-text-function	The function to get the Rich Presence large image text	(concat "Emacs " emacs-version)

---

buf refers to the name of the current buffer.

Example

(use-package elcord-wsl
  :load-path "/path/to/directory"
  :custom
  (elcord-wsl--load-path "/path/to/directory")
  (elcord-wsl--ignored-buffers
    '("Treemacs" "Minibuf"))
  (elcord-wsl--assets-alist
    '(("\\.cpp$" . "cpp")
      ("\\.hpp$" . "cpp")
      ("\\.hs$" . "haskell")
      ("scratch" . "emacs")
      ("^_default" . "emacs")))
  (elcord-wsl--client-id "1234567890")
  :config
  (defun elcord-wsl--details-function (buf)
    (concat "I am editing " buf "!"))
  (defun elcord-wsl--state-function (buf)
    '"I am totally not procrastinating."))

---

The keys in the alist will be RegExp objects. The asset used will be the first key which the buffer name matches the respective RegExp object.

The elements in the ignored buffers list will also be RegExp objects. If the buffer name matches any RegExp object in the list, it will be not be displayed in the Rich Presence.

Default Client ID and Art Assets

Assets of the default client (698809287564328991)