Reference

Troubleshooting

Use this checklist when behavior is not what you expect.

Known limitations

  • IPC is request/response only. There is no event subscription stream yet.
  • EWMH support is partial and focused on practical compatibility.
  • No bundled long-run automated integration harness yet.

Checklist

  • Run Mod+r after config edits.
  • Check config syntax around changed lines.
  • Test spawn commands in a terminal first.
  • Check /tmp/lxwm-spawn.log for spawn output.
  • Verify monitor_workspaces and window rules.
  • If bar visibility is wrong, check bar_enabled.
  • If IPC commands fail, check ipc_enabled.

IPC checks

  • Confirm socket exists in /tmp with your uid and display id.
  • Try a basic command: printf 'reload\n' | socat - UNIX-CONNECT:/tmp/lxwm-<uid>-_1.sock.
  • If the socket is missing, reload config or restart lxwm.

Quick reset

cp config.example ~/.config/lxwm/config

Reload after reset.