ThreadNet-Web/docs/debugging.md
sorB 3da363517f
Some checks failed
Docker / Docker Buildx (push) Has been cancelled
Build Debian package / Build package (release) Has been cancelled
Build and Deploy / prepare (release) Has been cancelled
Deploy release / Deploy to Cloudflare Pages (release) Has been cancelled
Build and Deploy / Trigger Pro pipeline (release) Has been cancelled
Build and Deploy / Windows arm64 (release) Has been cancelled
Build and Deploy / Windows x64 (release) Has been cancelled
Build and Deploy / macOS (release) Has been cancelled
Build and Deploy / Linux amd64 (sqlcipher static) (release) Has been cancelled
Build and Deploy / Linux arm64 (sqlcipher static) (release) Has been cancelled
Build and Deploy / ${{ needs.prepare.outputs.deploy == 'true' && 'Deploy' || 'Deploy (dry-run)' }} (release) Has been cancelled
Build and Deploy / Deploy builds to ESS (release) Has been cancelled
feat: show call participants in room list (Discord-style)
2026-05-10 14:25:35 +02:00

1.2 KiB

Debugging Element-Desktop

There are two parts of the desktop app that you might want to debug.

The renderer process

This is the regular element-web codeand can be debugged by just selecting 'toggle developer tools' from the menu, even on ppackaged builds. This then works the same as chrome dev tools for element web.

The main process

This is debugged as a node app, so:

  1. Open any chrome dev tools window
  2. Start element with the --inspect-brk flag
  3. Notice that you now have a little green icon in the top left of your chrome devtools window, click it.

You are now debugging the code of the desktop app itself.

The main process of a package app

When the app is shipped, electron's "fuses" are flipped, editing the electron binary itself to prevent certain features from being usable, one of which is debugging using --inspect-brk as above. You can flip the fuse back on Linux as follows:

sudo npx @electron/fuses write --app /opt/Element/element-desktop EnableNodeCliInspectArguments=on

A similar command will work, in theory, on mac and windows, except that this will break code signing (which is the point of fuses) so you would have to re-sign the app or somesuch.